Instalação¶

O Octo Transform Sync é três ferramentas sob uma licença — uma janela no Harmony, um add-on do Blender e uma ferramenta de shelf do Maya. Instale só as aplicações em que você realmente trabalha; o OTS nunca exige as três.

Requisitos¶

	Versão	Notas
Toon Boom Harmony	21 Premium ou posterior	Precisa do Python 3.9 instalado no sistema e no `PATH`. Essentials e Advanced não têm scripting Python
Blender	4.2 ou posterior	Usa o Python embutido do próprio Blender
Autodesk Maya	2022 ou posterior	Usa o Python embutido do próprio Maya

Qt/PySide vem com todos os hosts, e o motor do OTS não importa nada fora da biblioteca padrão do Python — não há pacotes para instalar. Windows e macOS são suportados.

O Octo Tools Installer¶

Existe um único instalador para toda a suíte Octo Tools. Você baixa uma vez, marca os produtos que comprou — aqui, o Octo Transform Sync —, marca as aplicações onde quer implantar e aperta Install.

Plataforma	O que você executa
Windows	`Octo-Tools-Installer.exe`
macOS	`Install Octo Tools.command`

No macOS ele é um script, não um app assinado

O Install Octo Tools.command é um shell script simples que roda exatamente o mesmo código Python da versão Windows — não existe .app, nem assinatura de código, nem notarização. Dê dois cliques para executá-lo. Se o macOS recusar, torne-o executável uma vez:

chmod +x "Install Octo Tools.command"

A janela tem três partes:

Detected hosts — os caminhos de instalação de Harmony, Blender e Maya encontrados nesta máquina.
Products — uma linha por produto, uma caixa de seleção por aplicação. Nada vem marcado por padrão; marque o Octo Transform Sync nos hosts que você usa. A caixa fica desabilitada quando aquela aplicação não foi detectada.
Licence key (optional) — um campo por linha de produto. Você pode deixá-lo vazio e ativar depois, dentro do app.

Cada destino marcado é implantado no seu local nativo, e o instalador registra exatamente o que escreveu num manifesto de desinstalação.

É a instalação inteira. As seções abaixo descrevem o que o instalador faz para cada host — siga elas só se você preferir fazer o deploy na mão, ou se estiver numa máquina travada onde rodar um instalador não é opção.

Uma ativação cobre todos os hosts — daquele produto

As licenças são por produto. Ativar o Octo Transform Sync uma vez cobre Harmony, Blender e Maya naquela máquina — você não ativa três vezes. Os outros produtos Octo Tools têm suas próprias licenças e suas próprias chaves; uma chave nunca libera a suíte inteira.

Administrador¶

O Octo Transform Sync instala inteiramente por usuário e não precisa de elevação. O instalador só pede direitos de administrador quando o Octo Skip Nodes também está marcado, porque esse produto registra atalhos de teclado dentro da própria pasta de instalação do Harmony.

Desinstalando¶

Marque a linha do Octo Transform Sync e aperte Uninstall. A remoção é por produto e é precisa: o instalador remove só os caminhos que registrou para o Octo Transform Sync — arquivos dentro de pastas compartilhadas como a script-icons do Harmony são registrados individualmente —, então as outras ferramentas Octo da máquina ficam intactas.

O que vai para onde¶

Destino	Formato	Local
Harmony	`OctoTransformSync.js` solto na raiz dos scripts, mais a pasta `octoTransformSync/` ao lado dele e a pasta compartilhada `script-icons/`	Windows `%APPDATA%\Toon Boom Animation\<product>\<version>-scripts\` · macOS `~/Library/Preferences/Toon Boom Animation/<product>/<version>-scripts/`
Blender	a pasta 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+; versões mais antigas do Blender usam `scripts/addons/`)
Maya	`octo_transform_sync/` mais um arquivo de módulo `octo_transform_sync.mod`	Windows `~/Documents/maya/modules/` · macOS `~/Library/Preferences/Autodesk/maya/modules/` (independente de versão)

Manual — Harmony¶

O Harmony só registra arquivos .js que estão na raiz da pasta de scripts, nunca numa subpasta, e o .js resolve seu Python a partir de uma pasta irmã chamada exatamente octoTransformSync. Então o formato é:

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

Nessa pasta, coloque o OctoTransformSync.js solto, o resto do conteúdo de harmony/ mais ots_core/ e ots_ui/ dentro de uma pasta octoTransformSync/, e mescle o harmony/script-icons/ na pasta script-icons/ existente (nunca substitua ela — ela pertence a todo script do Toon Boom, não só ao nosso).

Reinicie o Harmony e rode o script OctoTransformSync pela Scripts toolbar. A janela abre por cima do Harmony e fica ali; lançar de novo enquanto ela está aberta só a traz para a frente.

O Harmony precisa do Python 3.9 especificamente

O Harmony lança scripts de usuário através de um Python 3.9 de sistema no PATH. Um interpretador 3.10 ou mais novo é silenciosamente ignorado — o script simplesmente não roda, sem erro nenhum. Instale o Python 3.9 de 64 bits e marque Add Python to PATH. Isso vale para todos os produtos Octo Tools, não só o OTS.

Manual — Blender¶

Zipe a pasta blender/ e instale como add-on:

Edit → Preferences → Add-ons → Install from Disk
Escolha o zip e então habilite Octo Transform Sync na lista.
Abra a sidebar da 3D view com N e selecione a aba OTS.

Tudo acontece nesse painel da sidebar — não existe janela separada.

Manual — Maya¶

O mais fácil — arrastar e soltar. Arraste maya/install_maya.py da pasta do OTS para o viewport do Maya (a área 3D, não o Script Editor). O instalador:

Adiciona o OTS ao path do Python do Maya e torna isso permanente, anexando um bloco protegido ao seu userSetup.py (rodar de novo não duplica o bloco).
Adiciona um botão OTS ao seu shelf atual.
Salva o shelf e abre a janela na hora.

Depois disso, é só clicar no botão do shelf quando quiser.

Script Editor — manual. Numa aba 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()        # uma vez: adiciona o botão "OTS" ao shelf
ots.main()                 # abre a janela

install_shelf() é idempotente — se já existe um botão OTS em qualquer shelf, ele é atualizado no lugar em vez de duplicado.

O trial e sua licença¶

No primeiro launch o OTS começa um trial de 30 dias com todos os recursos liberados. Um banner no rodapé da janela faz a contagem regressiva dos dias, e fica vermelho nos três últimos.

A licença fica numa pasta compartilhada e neutra em relação à aplicação, então ativar em um host libera os outros naquela máquina — você não ativa três vezes. Ela libera só o Octo Transform Sync; os outros produtos Octo Tools são licenciados à parte.

Veja Licenciamento & Ativação.

Próximo¶

Vá para o Início Rápido para uma primeira transferência de ponta a ponta, ou para a Visão Geral da Interface para um tour pela janela.