Installation

▶Video tutorial — coming soon

Prérequis

Toon Boom Harmony	21 Premium ou plus récent (21, 22, 24, 25)
Python	3.9 — la seule version avec laquelle le pont Python de Harmony fonctionne
Tout le reste	Rien. Qt est fourni avec Harmony ; ORC n'a aucune dépendance externe et n'est jamais installé via pip.

Installer

1. Copiez le dossier octoRigComposer dans votre dossier de scripts Harmony :

   WindowsmacOS

   %APPDATA%\Toon Boom Animation\Toon Boom Harmony Premium\<version>-scripts\
   

   ~/Library/Preferences/Toon Boom Animation/Toon Boom Harmony Premium/<version>-scripts/
   

2. Redémarrez Harmony.

3. Ouvrez Windows → Script Editor, ou ajoutez le bouton de toolbar, et exécutez Octo_RigComposer().

Le nom du dossier compte

Le launcher cherche un dossier appelé exactement octoRigComposer à l'intérieur de votre dossier de scripts utilisateur. Le renommer casse le lancement avec "Python bridge unavailable."

Premier lancement

ORC vérifie sa licence avant de construire une fenêtre. Sur une installation neuve, vous atterrissez dans l'essai de 30 jours — voir Licensing & Activation.

Sans aucune Master Controller encore chargée, la barre du bas affiche une astuce de bienvenue, une seule fois :

Welcome to Octo Rig Composer. Select a Master Controller group in Node View, then double-click the Front or Back slot under Head in the Outliner.

Elle disparaît pour de bon la première fois que vous définissez un slot de MC.

Ensuite : Concepts & Vocabulary, puis Quick Start.

S'il ne se lance pas

Harmony affiche l'une de deux boîtes de message, toutes deux nommant le fichier de log :

Message	Cause habituelle
Octo Rig Composer failed to launch.	Python a levé une exception au démarrage. Lisez orc.log.
Octo Rig Composer could not start: Python bridge unavailable.	Le dossier est absent, mal nommé, ou dans le mauvais répertoire <version>-scripts. La boîte affiche le chemin exact qu'elle attendait.

Le log se trouve à :

%APPDATA%\OctoRigComposer\orc.log

Voir Troubleshooting.

Le Widget Editor

Le Widget Editor est fourni dans le même dossier et peut s'exécuter en standalone, sans ouvrir ORC — utile pour restyliser une MC déjà composée. Exécutez Octo_WidgetEditor() de la même façon.

Désinstaller

Supprimez le dossier octoRigComposer et redémarrez Harmony. Cela laisse trois choses derrière, que vous pouvez retirer séparément :

Quoi	Où
Préférences	%APPDATA%\Toon Boom Animation\Toon Boom Harmony Premium\octo_rig_composer\
Presets et logs	%APPDATA%\OctoRigComposer\
Licence	%APPDATA%\Octo\OctoRigComposer\

Libérez la place avant de formater une machine

Supprimer le fichier de licence localement ne libère pas votre activation. Utilisez Return License ou Deactivate d'abord — voir Licensing.

Les Master Controllers déjà composées continuent de fonctionner : le script composé vit dans votre scène Harmony, pas dans ORC.