Instalação¶

Requisitos¶

Toon Boom Harmony 21 Premium ou posterior (testado no 21, 22, 24, 25).
Harmony Premium — Essentials e Advanced não suportam scripting em Python.
Python 3.9 instalado no sistema operacional (o Harmony lança os scripts do usuário por meio dele — o mesmo requisito de todos os outros produtos Octo Tools). Se o ORC já roda na sua máquina, você está pronto.

Configuração do Python¶

O Harmony embute o próprio runtime Qt/PySide, mas lança os scripts do usuário por meio de um interpretador Python 3.9 separado, presente no PATH do sistema.

A versão do Python é estrita

O Harmony só carrega o Python 3.9. As versões 3.10, 3.11, 3.12 e mais novas são ignoradas silenciosamente. Se você tem várias versões do Python instaladas, mantenha apenas a 3.9 no PATH para garantir.

WindowsmacOS

Baixe o Python 3.9.13 (64-bit) em python.org.
Rode o instalador com "Add Python 3.9 to PATH" habilitado.
Verifique no PowerShell:
```
python --version
```
Esperado: Python 3.9.13

Baixe o Python 3.9.13 em python.org.
Rode o instalador.
Verifique no Terminal:
```
python3 --version
```

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 Skip Nodes —, 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. O Octo Skip Nodes é só para Harmony, então só a caixa de Harmony fica disponível.
Products — uma linha por produto, uma caixa de seleção por aplicação. Nada vem marcado por padrão; marque o Octo Skip Nodes em Harmony.
Licence key (optional) — um campo por linha de produto. Você pode deixá-lo vazio e ativar depois, dentro do aplicativo.

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

As licenças são por produto

Ativar o Octo Skip Nodes cobre todos os DCCs que esse produto suporta naquela máquina. 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.

O administrador é obrigatório para o Octo Skip Nodes¶

Feche o Toon Boom Harmony primeiro, depois rode o instalador elevado — no Windows, clique com o botão direito nele e escolha Run as administrator; no macOS o instalador pergunta se você quer incluir o Octo Skip Nodes e usa sudo se você disser que sim.

O Octo Skip Nodes é o único produto da suíte que precisa de elevação: ele registra seus atalhos de teclado no resources/shortcuts.xml da instalação do Harmony (em Program Files, ou dentro do bundle .app no macOS), e grava um backup .octobak ao lado do original antes de tocar nele.

Se você recusar a elevação, nada quebra em silêncio

Os scripts do Octo Skip Nodes ainda são instalados e a ferramenta ainda roda pelo Script Editor — só os atalhos de teclado ficam faltando, e o instalador diz isso explicitamente. Rode-o elevado quando quiser os atalhos. Rode-o de novo após uma atualização ou reinstalação do Harmony também — o arquivo de atalhos da instalação é resetado.

O que o instalador faz pelo Octo Skip Nodes¶

Copia a ferramenta para a pasta de scripts do Harmony — a pasta octoSkipNodes/ (o pacote Python) mais o gate OctoSkipNodes.js solto na raiz dos scripts (um lançador minúsculo; toda a lógica é Python).
Registra os atalhos de teclado no resources/shortcuts.xml da instalação (na categoria General, para que funcionem nas views Camera, Timeline e Node) e libera os B / Shift+B nativos (Select Parent / Child Skipping Effects). Um backup .octobak é gravado antes.

Desinstalando¶

Marque a linha do Octo Skip Nodes e aperte Uninstall. A remoção é por produto e é precisa: o instalador remove só os caminhos que registrou para o Octo Skip Nodes — incluindo restaurar o shortcuts.xml a partir do .octobak —, então as outras ferramentas Octo da máquina ficam intactas.

O que vai para onde¶

Destino	Formato	Local
Scripts do Harmony	`OctoSkipNodes.js` solto na raiz dos scripts, mais a pasta `octoSkipNodes/` ao lado dele	Windows `%APPDATA%\Toon Boom Animation\<product>\<version>-scripts\` · macOS `~/Library/Preferences/Toon Boom Animation/<product>/<version>-scripts/`
Instalação do Harmony	quatro entradas adicionadas ao `resources/shortcuts.xml`, com um backup `.octobak`	Windows `C:\Program Files (x86)\Toon Boom Animation\Toon Boom Harmony <version>\resources\` · macOS dentro de `/Applications/Toon Boom Harmony <version>/`

O Harmony só registra scripts que estão na raiz da pasta de scripts

O OctoSkipNodes.js precisa ficar solto em <version>-scripts/, nunca dentro de uma subpasta, e o pacote Python precisa estar numa pasta chamada exatamente octoSkipNodes — é esse o nome que o .js resolve.

Instalação manual¶

Numa máquina travada onde você não pode rodar um instalador, implante na mão — o formato acima é o contrato inteiro. Com o Harmony fechado:

Copie o OctoSkipNodes.js para <version>-scripts/ e o pacote Python para <version>-scripts/octoSkipNodes/.
Abra o Harmony e rode o OctoSkipNodes.js pelo Script Editor — a ferramenta funciona por ali sem nenhum atalho registrado.
Opcionalmente, vincule as quatro ações você mesmo em Edit → Keyboard Shortcuts → General.

Atalhos padrão¶

Tecla	Ação
`B`	Skip para cima (para o parent)
`Shift`+`B`	Skip para baixo (para o child)
`Ctrl`+`Alt`+`B`	Jump para cima até o próximo nó `+`
`Ctrl`+`Alt`+`Shift`+`B`	Jump para baixo até o nó `+` anterior

Mude-os quando quiser em Edit → Keyboard Shortcuts → General — procure por Octo Skip Up / Down e Octo Jump Up / Down.

Solução de problemas¶

Sintoma	Solução
Os atalhos pararam de funcionar após uma atualização do Harmony	Rode o instalador de novo como administrador (o arquivo de atalhos da instalação foi resetado).
O instalador diz "Python not found"	Instale o Python 3.9 (veja acima) e rode-o de novo.
Os botões da toolbar funcionam, mas `B` / `Shift`+`B` não fazem nada	O instalador não foi rodado como administrador, ou o Harmony estava aberto durante a instalação. Feche o Harmony e rode-o de novo como admin.
Você quer o antigo comportamento nativo do `B` de volta	Desinstale o Octo Skip Nodes pelo instalador, ou restaure o `resources/shortcuts.xml` a partir do backup `.octobak` que o instalador criou.