Aller au contenu

Installation

Tutoriel vidéo — bientôt disponible

Octo Scene Assembler est un outil Toon Boom Harmony. Il s'installe par utilisateur et ne demande aucune élévation de privilèges.

L'installeur Octo Tools

Il y a un seul installeur pour toute la suite Octo Tools. Téléchargez-le une fois, cochez les produits que vous avez achetés — ici, Octo Scene Assembler —, cochez les installations Harmony où déployer, et appuyez sur Install.

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

macOS est livré comme un script, pas comme une app signée

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

chmod +x "Install Octo Tools.command"

La fenêtre a trois parties :

  1. Hôtes détectés — les installations Harmony trouvées sur cette machine.
  2. Produits — une ligne par produit, une case à cocher par application. Rien n'est coché par défaut. Une case est désactivée quand l'application n'a pas été détectée.
  3. Clé de licence (optionnelle) — un champ par ligne de produit. Laissez-le vide et activez plus tard depuis l'application.

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

Les licences sont par produit

Une clé ne déverrouille jamais la suite. Octo Scene Assembler a sa propre licence — voir Licence et activation.

Désinstaller

Cochez la ligne du produit et appuyez sur Uninstall. La suppression est par produit et précise : seuls les chemins enregistrés pour ce produit sont retirés, donc les autres outils Octo de la machine ne sont pas touchés.

Ce qui atterrit où

Forme Emplacement
OctoSceneAssembler.js en vrac à la racine des scripts, plus le bundle octoSceneAssembler/ à côté Windows %APPDATA%\Toon Boom Animation\<product>\<version>-scripts\ · macOS ~/Library/Preferences/Toon Boom Animation/<product>/<version>-scripts/

Harmony n'enregistre que les scripts trouvés à la racine des scripts

Le .js doit être en vrac dans <version>-scripts/, jamais dans un sous-dossier, et le paquet Python doit être dans un dossier nommé exactement octoSceneAssembler — c'est le nom que le .js résout. L'installeur fait ça correctement ; si vous déployez à la main, respectez-le à la lettre.

Harmony a besoin d'un Python 3.9 système

Harmony lance les scripts utilisateur via un Python 3.9 système présent dans le PATH. Cela vaut pour tous les produits Octo Tools.

3.10 et plus récent sont ignorés en silence — le script ne s'exécute simplement pas, sans la moindre erreur. L'installeur détecte Python 3.9 et avertit s'il manque ; il ne bloque jamais, vous pouvez donc installer Python après coup.

Installation manuelle

Sur une machine verrouillée, déployez à la main — la disposition ci-dessus est tout le contrat :

  1. Copiez OctoSceneAssembler.js dans <version>-scripts/.
  2. Copiez le paquet Python dans <version>-scripts/octoSceneAssembler/.
  3. Redémarrez Harmony.

L'ouvrir

Lancez Octo Scene Assembler depuis le menu Scripts d'Harmony, ou ajoutez-le à une barre d'outils.

Le premier lancement démarre un essai gratuit — l'outil complet, sans restriction.

Où OSA garde ses données

%APPDATA%/Toon Boom Animation/Toon Boom Harmony Premium/octo_scene_assembler/
    license.json     the licence
    sessions/        one saved staging tree per scene
    osa.log          the log

Un dossier à sauvegarder, un dossier à vider, et un fichier à envoyer quand vous signalez un bug. Voir Sessions et récupération après crash.

Ensuite