Instalación

Requisitos

• Toon Boom Harmony 21 Premium o posterior (probado en 21, 22, 24, 25).
• Harmony Premium — Essentials y Advanced no admiten scripting de Python.
• Python 3.9 instalado en el sistema operativo (Harmony lanza los scripts de usuario a través de él — el mismo requisito que todos los demás productos de Octo Tools). Si ORC ya funciona en tu equipo, ya lo tienes listo.

Configuración de Python

Harmony incorpora su propio runtime de Qt/PySide, pero lanza los scripts de usuario mediante un intérprete de Python 3.9 independiente que está en el PATH del sistema.

La versión de Python es estricta

Harmony solo carga Python 3.9. Las versiones 3.10, 3.11, 3.12 y posteriores se ignoran sin avisar. Si tienes varias versiones de Python instaladas, mantén solo la 3.9 en el PATH para mayor seguridad.

WindowsmacOS

1. Descarga Python 3.9.13 (64-bit) desde python.org.
2. Ejecuta el instalador con "Add Python 3.9 to PATH" activado.

3. Verifica en PowerShell:

   python --version
   

   Esperado: Python 3.9.13

1. Descarga Python 3.9.13 desde python.org.
2. Ejecuta el instalador.

3. Verifica en Terminal:

   python3 --version
   

El Octo Tools Installer

Hay un único instalador para toda la suite Octo Tools. Lo descargas una vez, marcas los productos que compraste — aquí, Octo Skip Nodes —, marcas las aplicaciones donde desplegar y pulsas Install.

Plataforma	Qué ejecutas
Windows	Octo-Tools-Installer.exe
macOS	Install Octo Tools.command

En macOS es un script, no una app firmada

Install Octo Tools.command es un shell script simple que ejecuta exactamente el mismo código Python que la versión de Windows — no hay .app, ni firma de código, ni notarización. Haz doble clic para ejecutarlo. Si macOS se niega, hazlo ejecutable una vez:

chmod +x "Install Octo Tools.command"

La ventana tiene tres partes:

1. Detected hosts — las rutas de instalación de Harmony, Blender y Maya encontradas en esta máquina. Octo Skip Nodes es solo para Harmony, así que solo su casilla de Harmony está disponible.
2. Products — una fila por producto, una casilla por aplicación. Nada viene marcado por defecto; marca Octo Skip Nodes en Harmony.
3. Licence key (optional) — un campo por fila de producto. Puedes dejarlo vacío y activar más tarde, dentro de la app.

Cada destino marcado se despliega en su ubicación nativa, y el instalador registra exactamente lo que escribió en un manifiesto de desinstalación.

Las licencias son por producto

Activar Octo Skip Nodes cubre todos los DCC que ese producto soporta en esa máquina. Los demás productos de Octo Tools tienen sus propias licencias y sus propias claves — una clave nunca desbloquea toda la suite.

El administrador es obligatorio para Octo Skip Nodes

Cierra primero Toon Boom Harmony, y luego ejecuta el instalador con permisos elevados — en Windows, haz clic derecho sobre él y elige Run as administrator; en macOS el instalador pregunta si quieres incluir Octo Skip Nodes y usa sudo si respondes que sí.

Octo Skip Nodes es el único producto de la suite que necesita elevación: registra sus atajos de teclado en el resources/shortcuts.xml de la instalación de Harmony (en Program Files, o dentro del bundle .app en macOS), y escribe una copia de seguridad .octobak junto al original antes de tocarlo.

Si rechazas la elevación, nada se rompe en silencio

Los scripts de Octo Skip Nodes se instalan igualmente y la herramienta sigue ejecutándose desde el Script Editor — solo faltan los atajos de teclado, y el instalador lo dice explícitamente. Vuelve a ejecutarlo con permisos elevados cuando quieras los atajos. Vuelve a ejecutarlo también tras una actualización o reinstalación de Harmony — el archivo de atajos de la instalación se reinicia.

Qué hace el instalador para Octo Skip Nodes

1. Copia la herramienta en la carpeta de scripts de Harmony — la carpeta octoSkipNodes/ (el paquete Python) más el gate OctoSkipNodes.js suelto en la raíz de scripts (un lanzador minúsculo; toda la lógica está en Python).
2. Registra los atajos de teclado en el archivo resources/shortcuts.xml de la instalación (en la categoría General, para que funcionen en las vistas Camera, Timeline y Node) y libera los nativos B / Shift+B (Select Parent / Child Skipping Effects). Primero se escribe una copia de seguridad .octobak.

Desinstalar

Marca la fila de Octo Skip Nodes y pulsa Uninstall. La eliminación es por producto y es precisa: el instalador quita solo las rutas que registró para Octo Skip Nodes — incluida la restauración de shortcuts.xml desde su .octobak —, así que las demás herramientas Octo de la máquina quedan intactas.

Qué se instala y dónde

Destino	Forma	Ubicación
Scripts de Harmony	OctoSkipNodes.js suelto en la raíz de scripts, más la carpeta octoSkipNodes/ junto a él	Windows %APPDATA%\Toon Boom Animation\<product>\<version>-scripts\ · macOS ~/Library/Preferences/Toon Boom Animation/<product>/<version>-scripts/
Instalación de Harmony	cuatro entradas añadidas a resources/shortcuts.xml, con una copia de seguridad .octobak	Windows C:\Program Files (x86)\Toon Boom Animation\Toon Boom Harmony <version>\resources\ · macOS dentro de /Applications/Toon Boom Harmony <version>/

Harmony solo registra los scripts que están en la raíz de la carpeta de scripts

OctoSkipNodes.js debe estar suelto en <version>-scripts/, nunca dentro de una subcarpeta, y el paquete Python debe estar en una carpeta llamada exactamente octoSkipNodes — ese es el nombre que resuelve el .js.

Instalación manual

En una máquina bloqueada donde no puedes ejecutar un instalador, despliega a mano — la disposición de arriba es todo el contrato. Con Harmony cerrado:

1. Copia OctoSkipNodes.js en <version>-scripts/ y el paquete Python en <version>-scripts/octoSkipNodes/.
2. Abre Harmony y ejecuta OctoSkipNodes.js desde el Script Editor — la herramienta funciona desde ahí sin ningún atajo registrado.
3. Opcionalmente, asigna tú mismo las cuatro acciones en Edit → Keyboard Shortcuts → General.

Atajos predeterminados

Tecla	Acción
B	Saltar arriba (al padre)
Shift+B	Saltar abajo (al hijo)
Ctrl+Alt+B	Saltar arriba al siguiente nodo +
Ctrl+Alt+Shift+B	Saltar abajo al nodo + anterior

Cámbialos cuando quieras en Edit → Keyboard Shortcuts → General — busca Octo Skip Up / Down y Octo Jump Up / Down.

Solución de problemas

Síntoma	Solución
Los atajos dejaron de funcionar tras una actualización de Harmony	Vuelve a ejecutar el instalador como administrador (el archivo de atajos de la instalación se reinició).
El instalador dice "Python not found"	Instala Python 3.9 (ver arriba) y ejecútalo de nuevo.
Los botones de la barra de herramientas funcionan pero B / Shift+B no hacen nada	El instalador no se ejecutó como administrador, o Harmony estaba abierto durante la instalación. Cierra Harmony y ejecútalo de nuevo como administrador.
Quieres recuperar el comportamiento nativo antiguo de B	Desinstala Octo Skip Nodes desde el instalador, o restaura resources/shortcuts.xml desde la copia de seguridad .octobak que creó el instalador.