Installation¶

Octo Transform Sync, ce sont trois outils sous une seule licence — une fenêtre Harmony, un add-on Blender et un outil de shelf Maya. N'installez que les applications dans lesquelles vous travaillez vraiment ; OTS n'exige jamais les trois.

Prérequis¶

	Version	Notes
Toon Boom Harmony	21 Premium ou plus récent	Nécessite Python 3.9 installé sur le système et présent dans le `PATH`. Essentials et Advanced n'ont pas de scripting Python
Blender	4.2 ou plus récent	Utilise le Python embarqué de Blender
Autodesk Maya	2022 ou plus récent	Utilise le Python embarqué de Maya

Qt/PySide est livré avec chaque host, et le moteur d'OTS n'importe rien en dehors de la bibliothèque standard Python — il n'y a aucun paquet à installer. Windows et macOS sont supportés.

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 Transform Sync —, 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 :

Detected hosts — les chemins d'installation de Harmony, Blender et Maya trouvés sur cette machine.
Products — une ligne par produit, une case à cocher par application. Rien n'est coché par défaut ; cochez Octo Transform Sync sous les hosts que vous utilisez. Une case est désactivée lorsque l'application n'a pas été détectée.
Licence key (optional) — un champ par ligne de produit. Vous pouvez le laisser vide et activer plus tard, depuis 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.

C'est toute l'installation. Les sections ci-dessous décrivent ce que l'installeur fait pour chaque host — ne les suivez que si vous préférez déployer à la main, ou si vous êtes sur une machine verrouillée où lancer un installeur n'est pas envisageable.

Une activation couvre tous les hosts — pour ce produit

Les licences sont par produit. Activer Octo Transform Sync une fois couvre Harmony, Blender et Maya sur cette machine — vous n'activez pas trois fois. Les autres produits Octo Tools ont leurs propres licences et leurs propres clés ; une clé ne déverrouille jamais toute la suite.

Administrateur¶

Octo Transform Sync s'installe entièrement par utilisateur et ne nécessite aucune élévation. L'installeur ne demande les droits administrateur que lorsque Octo Skip Nodes est également coché, car ce produit enregistre des raccourcis clavier à l'intérieur du dossier d'installation de Harmony.

Désinstaller¶

Cochez la ligne d'Octo Transform Sync 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 Transform Sync — les fichiers situés dans des dossiers partagés comme script-icons de Harmony sont consignés individuellement —, si bien que les autres outils Octo de la machine restent intacts.

Ce qui se déploie où¶

Cible	Forme	Emplacement
Harmony	`OctoTransformSync.js` en vrac à la racine des scripts, plus le dossier `octoTransformSync/` à côté de lui et le dossier partagé `script-icons/`	Windows `%APPDATA%\Toon Boom Animation\<product>\<version>-scripts\` · macOS `~/Library/Preferences/Toon Boom Animation/<product>/<version>-scripts/`
Blender	le dossier d'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+ ; les Blender plus anciens utilisent `scripts/addons/`)
Maya	`octo_transform_sync/` plus un fichier de module `octo_transform_sync.mod`	Windows `~/Documents/maya/modules/` · macOS `~/Library/Preferences/Autodesk/maya/modules/` (indépendant de la version)

Manuel — Harmony¶

Harmony n'enregistre que les fichiers .js trouvés à la racine du dossier de scripts, jamais dans un sous-dossier, et le .js résout son Python depuis un dossier frère nommé exactement octoTransformSync. La disposition est donc :

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

Dans ce dossier, placez OctoTransformSync.js en vrac, le reste du contenu de harmony/ ainsi que ots_core/ et ots_ui/ dans un dossier octoTransformSync/, et fusionnez harmony/script-icons/ dans le dossier script-icons/ existant (ne le remplacez jamais — il appartient à tous les scripts Toon Boom, pas seulement au nôtre).

Redémarrez Harmony, puis lancez le script OctoTransformSync depuis la barre d'outils Scripts. La fenêtre s'ouvre par-dessus Harmony et y reste ; la relancer alors qu'elle est ouverte ne fait que la ramener au premier plan.

Harmony a besoin de Python 3.9 spécifiquement

Harmony lance les scripts utilisateur via un Python système 3.9 présent dans le PATH. Un interpréteur 3.10 ou plus récent est ignoré silencieusement — le script ne se lance tout simplement pas, sans erreur. Installez le Python 3.9 64-bit et cochez Add Python to PATH. Cela vaut pour tous les produits Octo Tools, pas seulement OTS.

Manuel — Blender¶

Zippez le dossier blender/ et installez-le comme add-on :

Edit → Preferences → Add-ons → Install from Disk
Choisissez le zip, puis activez Octo Transform Sync dans la liste.
Ouvrez la sidebar de la 3D-view avec N et sélectionnez le tab OTS.

Tout se passe dans ce panneau de sidebar — il n'y a pas de fenêtre séparée.

Manuel — Maya¶

Le plus simple — glisser-déposer. Glissez maya/install_maya.py depuis le dossier OTS dans le viewport de Maya (la zone 3D, pas le Script Editor). L'installeur :

Ajoute OTS au path Python de Maya, et le rend permanent en ajoutant un bloc protégé à votre userSetup.py (le relancer ne duplique pas le bloc).
Ajoute un bouton OTS à votre shelf courant.
Sauvegarde le shelf et ouvre la fenêtre dans la foulée.

Cliquez sur le bouton du shelf à tout moment ensuite.

Script Editor — manuel. Dans un tab 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()        # one-time: adds the "OTS" shelf button
ots.main()                 # opens the window

install_shelf() est idempotent — si un bouton OTS existe déjà sur un shelf quelconque, il est mis à jour sur place plutôt que dupliqué.

Le trial et votre licence¶

Au premier lancement, OTS démarre un trial de 30 jours avec toutes les fonctionnalités débloquées. Un bandeau en bas de la fenêtre décompte les jours, et passe au rouge dans les trois derniers.

La licence est stockée dans un dossier partagé, neutre vis-à-vis de l'application, donc activer dans un host débloque les autres sur cette machine — vous n'activez pas trois fois. Elle ne débloque qu'Octo Transform Sync ; les autres produits Octo Tools sont licenciés séparément.

Voir Licence et activation.

Ensuite¶

Allez au Démarrage rapide pour un premier transfert de bout en bout, ou à la Présentation de l'interface pour une visite de la fenêtre.