Aller au contenu

Installation

Prérequis

  • Toon Boom Harmony 21 Premium ou ultérieur (testé sur 21, 22, 24, 25).
  • Harmony Premium — les éditions Essentials et Advanced ne prennent pas en charge les scripts Python.
  • Python 3.9 installé sur le système d'exploitation (Harmony lance les scripts utilisateur via celui-ci — le même prérequis que tous les autres produits Octo Tools). Si ORC fonctionne déjà sur votre machine, tout est en place.

Configuration de Python

Harmony intègre son propre runtime Qt/PySide mais lance les scripts utilisateur via un interpréteur Python 3.9 distinct présent dans le PATH du système.

La version de Python est stricte

Harmony ne charge que Python 3.9. Les versions 3.10, 3.11, 3.12 et plus récentes sont ignorées silencieusement. Si plusieurs versions de Python sont installées, gardez uniquement la 3.9 dans le PATH par sécurité.

  1. Téléchargez Python 3.9.13 (64 bits) depuis python.org.
  2. Lancez l'installeur avec l'option « Add Python 3.9 to PATH » activée.

  3. Vérifiez dans PowerShell :

    python --version

    Résultat attendu : Python 3.9.13

  1. Téléchargez Python 3.9.13 depuis python.org.
  2. Lancez l'installeur.

  3. Vérifiez dans le Terminal :

    python3 --version

L'Octo Tools Installer

Il y a un seul installeur pour toute la suite Octo Tools. Vous le téléchargez une fois, cochez les produits que vous avez achetés — ici, Octo Skip Nodes —, cochez les applications où déployer, puis appuyez sur Install.

Plateforme Ce que vous lancez
Windows Octo-Tools-Installer.exe
macOS Install Octo Tools.command

Sur macOS, c'est un script, pas une app signée

Install Octo Tools.command est un simple script shell qui exécute exactement le même code Python que la version Windows — il n'y a pas de .app, pas de signature de code et pas de notarisation. Double-cliquez dessus pour le lancer. Si macOS refuse, rendez-le exécutable une fois :

chmod +x "Install Octo Tools.command"

La fenêtre comporte trois parties :

  1. Detected hosts — les chemins d'installation de Harmony, Blender et Maya trouvés sur cette machine. Octo Skip Nodes ne concerne que Harmony, donc seule sa case Harmony est disponible.
  2. Products — une ligne par produit, une case à cocher par application. Rien n'est coché par défaut ; cochez Octo Skip Nodes sous Harmony.
  3. Licence key (optional) — un champ par ligne de produit. Vous pouvez le laisser vide et activer plus tard, dans l'application.

Chaque cible cochée est déployée à son emplacement natif, et l'installeur consigne exactement ce qu'il a écrit dans un manifeste de désinstallation.

Les licences sont par produit

Activer Octo Skip Nodes couvre tous les DCC que ce produit prend en charge sur cette machine. Les autres produits Octo Tools ont leurs propres licences et leurs propres clés — une clé ne déverrouille jamais toute la suite.

L'administrateur est obligatoire pour Octo Skip Nodes

Fermez d'abord Toon Boom Harmony, puis lancez l'installeur avec élévation — sous Windows, faites un clic droit dessus et choisissez Run as administrator ; sous macOS l'installeur demande s'il faut inclure Octo Skip Nodes et utilise sudo si vous répondez oui.

Octo Skip Nodes est le seul produit de la suite qui nécessite une élévation : il enregistre ses raccourcis clavier dans le resources/shortcuts.xml de l'installation de Harmony (sous Program Files, ou à l'intérieur du bundle .app sur macOS), et écrit une sauvegarde .octobak à côté de l'original avant d'y toucher.

Si vous refusez l'élévation, rien ne casse en silence

Les scripts d'Octo Skip Nodes sont tout de même installés et l'outil se lance toujours depuis le Script Editor — seuls les raccourcis clavier manquent, et l'installeur le dit explicitement. Relancez-le avec élévation quand vous voulez les raccourcis. Relancez-le également après une mise à jour ou une réinstallation de Harmony — le fichier de raccourcis de l'installation est réinitialisé.

Ce que l'installeur fait pour Octo Skip Nodes

  1. Copie l'outil dans le dossier de scripts de Harmony — le dossier octoSkipNodes/ (le paquet Python) ainsi que le point d'entrée OctoSkipNodes.js en vrac à la racine des scripts (un minuscule lanceur ; toute la logique est en Python).
  2. Enregistre les raccourcis clavier dans le fichier resources/shortcuts.xml de l'installation (dans la catégorie General, afin qu'ils fonctionnent dans les vues Camera, Timeline et Node) et libère les B / Shift+B natifs (Select Parent / Child Skipping Effects). Une sauvegarde .octobak est écrite au préalable.

Désinstaller

Cochez la ligne d'Octo Skip Nodes et appuyez sur Uninstall. La suppression se fait par produit et avec précision : l'installeur ne retire que les chemins qu'il a consignés pour Octo Skip Nodes — y compris la restauration de shortcuts.xml depuis son .octobak —, si bien que les autres outils Octo de la machine restent intacts.

Ce qui se déploie où

Cible Forme Emplacement
Scripts de Harmony OctoSkipNodes.js en vrac à la racine des scripts, plus le dossier octoSkipNodes/ à côté de lui Windows %APPDATA%\Toon Boom Animation\<product>\<version>-scripts\ · macOS ~/Library/Preferences/Toon Boom Animation/<product>/<version>-scripts/
Installation de Harmony quatre entrées ajoutées à resources/shortcuts.xml, avec une sauvegarde .octobak Windows C:\Program Files (x86)\Toon Boom Animation\Toon Boom Harmony <version>\resources\ · macOS à l'intérieur de /Applications/Toon Boom Harmony <version>/

Harmony n'enregistre que les scripts trouvés à la racine du dossier de scripts

OctoSkipNodes.js doit se trouver en vrac dans <version>-scripts/, jamais dans un sous-dossier, et le paquet Python doit être dans un dossier nommé exactement octoSkipNodes — c'est le nom que le .js résout.

Installation manuelle

Sur une machine verrouillée où vous ne pouvez pas lancer d'installeur, déployez à la main — la disposition ci-dessus est tout le contrat. Harmony fermé :

  1. Copiez OctoSkipNodes.js dans <version>-scripts/ et le paquet Python dans <version>-scripts/octoSkipNodes/.
  2. Démarrez Harmony et lancez OctoSkipNodes.js depuis le Script Editor — l'outil fonctionne de là sans aucun raccourci enregistré.
  3. Éventuellement, liez vous-même les quatre actions dans Edit → Keyboard Shortcuts → General.

Raccourcis par défaut

Touche Action
B Skip vers le haut (vers le parent)
Shift+B Skip vers le bas (vers l'enfant)
Ctrl+Alt+B Jump vers le haut, vers le prochain nœud +
Ctrl+Alt+Shift+B Jump vers le bas, vers le nœud + précédent

Modifiez-les à tout moment dans Edit → Keyboard Shortcuts → General — cherchez Octo Skip Up / Down et Octo Jump Up / Down.

Dépannage

Symptôme Solution
Les raccourcis ont cessé de fonctionner après une mise à jour de Harmony Relancez l'installeur en tant qu'administrateur (le fichier de raccourcis de l'installation a été réinitialisé).
L'installeur indique « Python not found » Installez Python 3.9 (voir ci-dessus) et relancez-le.
Les boutons de la barre d'outils fonctionnent mais B / Shift+B ne font rien L'installeur n'a pas été exécuté en tant qu'administrateur, ou Harmony était ouvert pendant l'installation. Fermez Harmony et relancez-le en tant qu'administrateur.
Vous voulez retrouver l'ancien comportement natif de B Désinstallez Octo Skip Nodes depuis l'installeur, ou restaurez resources/shortcuts.xml à partir de la sauvegarde .octobak créée par l'installeur.