Instalación¶

Octo Transform Sync son tres herramientas bajo una licencia — una ventana de Harmony, un add-on de Blender y una herramienta de shelf de Maya. Instala solo las aplicaciones en las que realmente trabajas; OTS nunca requiere las tres.

Requisitos¶

	Versión	Notas
Toon Boom Harmony	21 Premium o posterior	Necesita Python 3.9 instalado en el sistema y en el `PATH`. Essentials y Advanced no tienen scripting de Python
Blender	4.2 o posterior	Usa el Python que trae Blender
Autodesk Maya	2022 o posterior	Usa el Python que trae Maya

Qt/PySide viene con todos los hosts, y el motor de OTS no importa nada fuera de la librería estándar de Python — no hay paquetes que instalar. Windows y macOS están soportados.

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 Transform Sync —, 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:

Detected hosts — las rutas de instalación de Harmony, Blender y Maya encontradas en esta máquina.
Products — una fila por producto, una casilla por aplicación. Nada viene marcado por defecto; marca Octo Transform Sync en los hosts que uses. La casilla se deshabilita cuando esa aplicación no fue detectada.
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.

Esa es toda la instalación. Las secciones de abajo describen lo que el instalador hace para cada host — síguelas solo si prefieres desplegar a mano, o si estás en una máquina bloqueada donde ejecutar un instalador no es una opción.

Una activación cubre todos los hosts — de ese producto

Las licencias son por producto. Activar Octo Transform Sync una vez cubre Harmony, Blender y Maya en esa máquina — no activas tres veces. Los demás productos de Octo Tools tienen sus propias licencias y sus propias claves; una clave nunca desbloquea toda la suite.

Administrador¶

Octo Transform Sync se instala completamente por usuario y no necesita elevación. El instalador solo pide permisos de administrador cuando también está marcado Octo Skip Nodes, porque ese producto registra atajos de teclado dentro de la propia carpeta de instalación de Harmony.

Desinstalar¶

Marca la fila de Octo Transform Sync y pulsa Uninstall. La eliminación es por producto y es precisa: el instalador quita solo las rutas que registró para Octo Transform Sync — los archivos dentro de carpetas compartidas como script-icons de Harmony se registran individualmente —, así que las demás herramientas Octo de la máquina quedan intactas.

Qué se instala y dónde¶

Destino	Forma	Ubicación
Harmony	`OctoTransformSync.js` suelto en la raíz de scripts, más la carpeta `octoTransformSync/` junto a él y la carpeta compartida `script-icons/`	Windows `%APPDATA%\Toon Boom Animation\<product>\<version>-scripts\` · macOS `~/Library/Preferences/Toon Boom Animation/<product>/<version>-scripts/`
Blender	la carpeta de add-on `octo_transform_sync/`	Windows `%APPDATA%\Blender Foundation\Blender\<version>\extensions\user_default\` · macOS `~/Library/Application Support/Blender/<version>/extensions/user_default/` (4.2+; los Blender más antiguos usan `scripts/addons/`)
Maya	`octo_transform_sync/` más un archivo de módulo `octo_transform_sync.mod`	Windows `~/Documents/maya/modules/` · macOS `~/Library/Preferences/Autodesk/maya/modules/` (independiente de la versión)

Manual — Harmony¶

Harmony solo registra los archivos .js que están en la raíz de la carpeta de scripts, nunca en una subcarpeta, y el .js resuelve su Python desde una carpeta hermana llamada exactamente octoTransformSync. Así que la disposición es:

Plataforma	Ubicación
Windows	`%APPDATA%\Toon Boom Animation\Toon Boom Harmony Premium\<version>-scripts\`
macOS	`~/Library/Preferences/Toon Boom Animation/Toon Boom Harmony Premium/<version>-scripts/`

En esa carpeta, coloca OctoTransformSync.js suelto, el resto del contenido de harmony/ más ots_core/ y ots_ui/ dentro de una carpeta octoTransformSync/, y fusiona harmony/script-icons/ con la carpeta script-icons/ existente (nunca la reemplaces — pertenece a todos los scripts de Toon Boom, no solo al nuestro).

Reinicia Harmony y luego ejecuta el script OctoTransformSync desde la toolbar de Scripts. La ventana se abre encima de Harmony y ahí se queda; lanzarla otra vez mientras está abierta simplemente la trae al frente.

Harmony necesita Python 3.9 específicamente

Harmony lanza los scripts de usuario a través de un Python 3.9 del sistema en el PATH. Un intérprete 3.10 o más nuevo se ignora en silencio — el script simplemente no corre, sin error. Instala el Python 3.9 de 64 bits y marca Add Python to PATH. Esto aplica a todos los productos de Octo Tools, no solo a OTS.

Manual — Blender¶

Comprime la carpeta blender/ en un zip e instálala como add-on:

Edit → Preferences → Add-ons → Install from Disk
Elige el zip y luego habilita Octo Transform Sync en la lista.
Abre la sidebar del 3D view con N y selecciona la pestaña OTS.

Todo ocurre en ese panel de la sidebar — no hay una ventana aparte.

Manual — Maya¶

Lo más fácil — arrastrar y soltar. Arrastra maya/install_maya.py desde la carpeta de OTS hacia el viewport de Maya (el área 3D, no el Script Editor). El instalador:

Añade OTS al path de Python de Maya, y lo hace permanente agregando un bloque protegido a tu userSetup.py (volver a ejecutarlo no duplica el bloque).
Añade un botón OTS a tu shelf actual.
Guarda el shelf y abre la ventana de inmediato.

Después haz clic en el botón del shelf cuando quieras.

Script Editor — manual. En una pestaña Python:

import sys; sys.path.insert(0, r"C:\path\to\octo_transform_sync\maya")
import launch_transform_sync_maya as ots
ots.install_shelf()        # one-time: adds the "OTS" shelf button
ots.main()                 # opens the window

install_shelf() es idempotente — si ya existe un botón OTS en cualquier shelf, se actualiza en su sitio en vez de duplicarse.

El trial y tu licencia¶

En el primer lanzamiento OTS arranca un trial de 30 días con todas las funciones desbloqueadas. Un banner al pie de la ventana va descontando los días, y se pone rojo en los últimos tres.

La licencia se guarda en una carpeta compartida y neutral respecto a la aplicación, así que activar en un host desbloquea los otros en esa máquina — no activas tres veces. Desbloquea solo Octo Transform Sync; los demás productos de Octo Tools se licencian aparte.

Consulta Licencia y activación.

Siguiente¶

Ve a Inicio rápido para una primera transferencia de punta a punta, o a Vista general de la interfaz para un recorrido por la ventana.