Saltar a contenido

Instalación

▶Videotutorial — próximamente

Octo Scene Assembler es una herramienta para Toon Boom Harmony. Se instala por usuario y no necesita permisos de administrador.

El instalador de Octo Tools

Hay un solo instalador para toda la suite Octo Tools. Descárgalo una vez, marca los productos que compraste — aquí, Octo Scene Assembler —, marca las instalaciones de Harmony en las que quieres desplegarlo y pulsa Install.

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

En macOS se entrega como script, no como app firmada

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

chmod +x "Install Octo Tools.command"

La ventana tiene tres partes:

  1. Detected hosts — las instalaciones de Harmony encontradas en esta máquina.
  2. Products — una fila por producto, una casilla por aplicación. Nada viene marcado por defecto. Una casilla queda deshabilitada cuando esa aplicación no fue detectada.
  3. Licence key (optional) — un campo por fila de producto. Déjalo vacío y activa después 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

Una clave nunca desbloquea la suite. Octo Scene Assembler tiene su propia licencia — ver Licencias y activación.

Desinstalar

Marca la fila del producto y pulsa Uninstall. La eliminación es por producto y precisa: solo se quitan las rutas registradas para ese producto, así que las demás herramientas Octo de la máquina quedan intactas.

Qué aterriza dónde

Forma Ubicación
OctoSceneAssembler.js suelto en la raíz de scripts, más el paquete octoSceneAssembler/ al lado Windows %APPDATA%\Toon Boom Animation\<product>\<version>-scripts\ · macOS ~/Library/Preferences/Toon Boom Animation/<product>/<version>-scripts/

Harmony solo registra scripts que estén en la raíz de scripts

El .js debe quedar suelto en <version>-scripts/, nunca dentro de una subcarpeta, y el paquete Python debe estar en una carpeta llamada exactamente octoSceneAssembler — ese es el nombre que resuelve el .js. El instalador lo hace bien; si despliegas a mano, respétalo al pie de la letra.

Harmony necesita un Python 3.9 del sistema

Harmony lanza los scripts de usuario a través de un Python 3.9 del sistema en el PATH. Esto vale para todos los productos de Octo Tools.

3.10 y posteriores se ignoran en silencio — el script simplemente no se ejecuta, sin ningún error. El instalador detecta Python 3.9 y avisa si falta; nunca bloquea, así que puedes instalar Python después.

Instalación manual

En una máquina restringida, despliega a mano — el esquema de arriba es todo el contrato:

  1. Copia OctoSceneAssembler.js en <version>-scripts/.
  2. Copia el paquete Python en <version>-scripts/octoSceneAssembler/.
  3. Reinicia Harmony.

Abrirlo

Ejecuta Octo Scene Assembler desde el menú Scripts de Harmony, o agrégalo a una barra de herramientas.

El primer arranque inicia una prueba gratuita — la herramienta completa, sin restricciones.

Dónde guarda OSA sus datos

%APPDATA%/Toon Boom Animation/Toon Boom Harmony Premium/octo_scene_assembler/
    license.json     the licence
    sessions/        one saved staging tree per scene
    osa.log          the log

Una carpeta que respaldar, una carpeta que limpiar, y un archivo que enviar cuando reportes un bug. Ver Sesiones y recuperación tras un crash.

Siguiente