Instalación

Octo Vector Bridge son tres herramientas en una sola licencia — una ventana de importación de Harmony, un add-on de Blender y un módulo de Maya. Instala solo las que uses.

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 Vector Bridge —, 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.
2. Products — una fila por producto, una casilla por aplicación. Nada viene marcado por defecto; marca Octo Vector Bridge en Harmony, Blender y/o Maya. La casilla se deshabilita cuando esa aplicación no fue detectada.
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.

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

Las licencias son por producto. Activar Octo Vector Bridge 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 Vector Bridge 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 del producto que quieras quitar y pulsa Uninstall. La eliminación es por producto y es precisa: el instalador quita solo las rutas que registró para ese producto, así que las demás herramientas Octo de la máquina quedan intactas.

Qué se instala y dónde

Destino	Forma	Ubicación
Harmony	OctoVectorBridge.js y OVB_DiagnosticTest.js sueltos en la raíz de scripts, más la carpeta octoVectorBridge/ junto a ellos	Windows %APPDATA%\Toon Boom Animation\<product>\<version>-scripts\ · macOS ~/Library/Preferences/Toon Boom Animation/<product>/<version>-scripts/
Blender	la carpeta de add-on octo_vector_bridge/	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_vector_bridge/ más un archivo de módulo octo_vector_bridge.mod	Windows ~/Documents/maya/modules/ · macOS ~/Library/Preferences/Autodesk/maya/modules/ (independiente de la versión)

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

Los dos archivos .js deben estar sueltos en <version>-scripts/, nunca dentro de una subcarpeta, y el paquete Python debe estar en una carpeta llamada exactamente octoVectorBridge — 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 — ese requisito aplica a todos los productos de Octo Tools, no solo a este. Las versiones 3.10 y posteriores se ignoran en silencio: el script simplemente no corre, sin error.

Octo Vector Bridge necesita ese Python 3.9 externo por una segunda razón: su pasada de grosor variable se ejecuta a través de OMC, controlado desde un intérprete 3.9 aparte. El instalador detecta Python 3.9 y avisa si falta — nunca bloquea; puedes instalar Python después.

¿Por qué un Python externo?

Harmony trae su propio Python embebido, pero la API de grosor de OMC se controla desde un intérprete 3.9 aparte. Un intérprete que no coincida es peor que uno documentado — por eso OVB te pide instalar un Python 3.9 estándar y apunta a él.

Potrace viene incluido

El motor de trazado Potrace se incluye dentro del paquete de Harmony (bin/potrace), así que la conversión bitmap → vector funciona de fábrica — nada extra que instalar. Potrace es GPL y viaja por mera agregación; OVB en sí sigue siendo propietario.

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.

• Harmony — copia OctoVectorBridge.js y OVB_DiagnosticTest.js en <version>-scripts/, y el paquete Python en <version>-scripts/octoVectorBridge/. Reinicia Harmony.
• Blender — Edit → Preferences → Add-ons → Install from Disk, elige el zip de octo_vector_bridge y luego habilita Octo Vector Bridge en la lista.
• Maya — copia octo_vector_bridge/ y octo_vector_bridge.mod en tu carpeta modules/ de Maya y reinicia Maya.

Abrir las herramientas

• Harmony — ejecuta el script Octo Vector Bridge desde el menú Scripts (o su botón de la barra de herramientas).
• Blender — activa el add-on y luego abre la pestaña Octo VB en la barra lateral de la vista 3D (N).
• Maya — el módulo añade un botón de estantería, o ejecuta import maya_bridge.launch as ovb; ovb.show().

El primer arranque inicia una prueba de 30 días. Consulta Licencia y activación.