Scripts ExtendScript pour After Effects : le guide de démarrage pour motion designers non-développeurs

This article is currently available in French only. The page chrome is translated, the article body is not — yet.

Ce qu'est vraiment ExtendScript : un langage, pas une magie noire

ExtendScript est un dialecte de JavaScript créé par Adobe. Il suit la spécification ECMAScript 3, ce qui veut dire qu'il est plus ancien que le JavaScript moderne que vous croisez dans les tutoriels web, mais aussi plus prévisible et documenté pour notre usage. Concrètement, un script ExtendScript est un fichier texte avec l'extension `.jsx` que After Effects lit et exécute.

La grande différence avec du code web, c'est que vous manipulez directement l'application : ses compositions, ses calques, ses propriétés d'animation, ses rendus. Adobe expose toutes ces briques via ce qu'on appelle l'Object Model, un ensemble d'objets hiérarchisés. L'application est `app`, le projet actif est `app.project`, la composition active est `app.project.activeItem`, et ainsi de suite. Une fois ce principe de poupées russes intégré, la logique devient évidente.

Pas besoin de connaître les pointeurs, la gestion mémoire ou les design patterns. Ce dont vous avez besoin : comprendre les variables, les conditions, les boucles, et savoir naviguer dans la hiérarchie AE. C'est faisable en quelques heures de pratique ciblée.

Mettre en place un environnement de travail minimal et efficace

La première étape concrète, c'est d'ouvrir l'éditeur intégré d'After Effects : `Fichier > Scripts > Ouvrir l'éditeur de script`. Cet outil, appelé ExtendScript Toolkit dans les anciennes versions ou simplement l'éditeur de script dans les versions récentes, vous permet d'écrire du code, de l'exécuter et de voir les erreurs en temps réel. Pas besoin d'installer quoi que ce soit pour commencer.

Si vous souhaitez aller un cran plus loin, Visual Studio Code avec l'extension `ExtendScript Debugger` d'Adobe offre une coloration syntaxique propre, l'autocomplétion et un débogueur graphique. C'est l'environnement recommandé dès que vos scripts dépassent vingt lignes. L'installation prend moins de cinq minutes.

Une astuce pratique dès le départ : créez un dossier `Scripts` dans votre projet studio, versionné avec Git ou stocké sur votre serveur. Chaque script porte un nom explicite — `renommer_calques_par_index.jsx`, `exporter_comps_selectionees.jsx` — et un commentaire en haut du fichier qui décrit ce qu'il fait et dans quel contexte l'utiliser. Cette discipline simple vous évite de retrouver un script six mois plus tard sans savoir à quoi il sert.

Lire la documentation AE Scripting Guide sans se perdre

Adobe publie une documentation officielle appelée After Effects Scripting Guide, disponible gratuitement en ligne. C'est votre référence principale. Le réflexe à acquérir : quand vous voulez faire quelque chose, cherchez d'abord l'objet correspondant dans cette doc, puis regardez ses propriétés et méthodes.

Par exemple, vous voulez changer la couleur d'un calque de solide. Vous cherchez `AVLayer`, vous trouvez la propriété `source`, qui renvoie un objet `FootageItem`, lequel a une propriété `mainSource` de type `SolidSource` avec une propriété `color`. C'est verbeux à décrire, mais une fois que vous avez fait ce chemin une fois, vous le refaites intuitivement.

Une approche très efficace pour apprendre : ouvrez un projet After Effects existant, écrivez `$.writeln(app.project.activeItem.name)` dans l'éditeur et exécutez. Vous verrez le nom de votre composition active s'afficher dans la console. Ensuite, explorez couche par couche. Ce cycle exploration-exécution-observation est exactement la méthode que les développeurs expérimentés utilisent pour découvrir une API nouvelle. Vous n'êtes pas moins légitime dans cette démarche.

Vos trois premiers scripts utiles en production

**Script 1 : Renommer les calques par index.** En production, il est courant de recevoir des compositions avec des calques nommés `Calque 1`, `Calque 2` ou par leur nom de fichier source. Un script qui rebaptise chaque calque avec un préfixe personnalisé suivi de son numéro d'index prend dix lignes. La boucle `for` parcourt `comp.layers`, et `layer.name` reçoit la nouvelle valeur. Ce script seul fait gagner du temps sur chaque brief de retouche.

**Script 2 : Activer ou désactiver la visibilité d'un groupe de calques par nom.** Quand une composition contient des variantes — par exemple des calques nommés `FR_`, `EN_`, `DE_` pour des déclinaisons linguistiques — un script peut afficher uniquement ceux qui contiennent le suffixe voulu et masquer les autres. La logique repose sur `layer.name.indexOf()` et `layer.enabled`. Exécuté en un clic, ce script remplace dix minutes de travail manuel par déclinaison.

**Script 3 : Dupliquer une composition et remplacer une source texte.** Si vous produisez des séries de motion graphics avec des variantes de titre, vous pouvez écrire un script qui duplique la composition master, la renomme, accède au calque texte via `layer.property('Source Text')` et y injecte une nouvelle chaîne de caractères. Avec un tableau de valeurs en entrée, vous générez dix variantes en quelques secondes.

Comprendre les erreurs et déboguer sans paniquer

L'erreur la plus fréquente quand on débute : accéder à un objet qui n'existe pas. Si aucune composition n'est sélectionnée et que votre script fait `app.project.activeItem.layers`, After Effects renvoie une erreur parce que `activeItem` est `null`. La solution est systématique : avant d'agir sur un objet, vérifiez qu'il existe avec une condition `if`.

La deuxième erreur courante : les indices en ExtendScript commencent à 1, pas à 0 comme en JavaScript standard. `comp.layers[1]` retourne le premier calque. Oublier ce détail génère des comportements déconcertants, surtout quand vous venez d'un background web ou que vous avez copié du code d'un tutoriel JavaScript classique.

Pour déboguer, `$.writeln()` est votre meilleur ami. Affichez la valeur d'une variable à chaque étape critique de votre script pour comprendre où la logique déraille. Dans Visual Studio Code avec le débogueur Adobe, vous pouvez même poser des points d'arrêt et inspecter les variables en temps réel, exactement comme un développeur professionnel. Cette mécanique de débogage pas-à-pas transforme ce qui semblait mystérieux en quelque chose de très lisible.

Intégrer les scripts dans votre workflow studio au quotidien

Un script qui reste dans un dossier et qu'on lance depuis le menu `Fichier > Scripts > Exécuter le fichier de script` est déjà utile. Mais pour une intégration propre en studio, deux approches complémentaires méritent votre attention.

Première approche : placer vos scripts dans le dossier `Scripts/ScriptUI Panels` d'After Effects. Les scripts qui se trouvent là apparaissent directement dans le menu `Fenêtre` d'AE et peuvent être ouverts comme des panneaux ancrables. En ajoutant une interface graphique simple avec les objets `Window`, `Button` et `EditText` du système ScriptUI, vous créez un outil cliquable que n'importe quel membre de l'équipe peut utiliser sans toucher à du code.

Deuxième approche : documenter chaque script dans une page Notion ou Confluence partagée avec le studio. Qui a écrit le script, à quelle version AE il a été testé, dans quel contexte l'utiliser, quelles sont ses limites connues. Cette documentation est ce qui fait qu'un outil maison survit à la rotation d'équipe. Un script sans documentation finit par être abandonné même s'il est excellent.

ConclusionConclusion

Écrire des scripts ExtendScript n'est pas une compétence réservée aux développeurs : c'est une extension naturelle de votre maîtrise d'After Effects. Commencez par un problème concret que vous rencontrez chaque semaine, écrivez dix lignes qui le résolvent, et itérez. La courbe d'apprentissage est réelle mais courte pour les automatisations de base, et chaque script que vous maîtrisez libère du temps de création que vous pouvez investir là où votre sensibilité de motion designer fait vraiment la différence. L'outil le plus précieux n'est pas le plus sophistiqué : c'est celui que vous comprenez, que vous maintenez, et que toute votre équipe peut utiliser.