Compétence Remotion Shorts
Vous écrivez un court métrage (short) sous forme de fichier JSON de scènes. Le projet Remotion pré-emballé dispose les mots, chronomètre chaque scène en fonction de la vitesse de lecture, maintient le texte à l'intérieur de la zone non couverte par les boutons d'application, génère une planche de contrôle, une couverture et le MP4 ; l'utilisateur peut ensuite le publier avec WoopSocial.
Vous n'écrivez pas de code Remotion pour chaque vidéo. Les modèles sont fixes et testés ; votre travail est le script : ce que chaque écran affiche, dans quel ordre et à quelle vitesse.
0. Configuration (une fois par machine)
Nécessite Node 20 ou plus récent. Vérifiez avec node -v ; s'il manque, envoyez l'utilisateur sur https://nodejs.org. Remotion prend en charge macOS 15 ou plus récent, Windows x64 et Linux avec glibc 2.35+ (Ubuntu 22.04, Debian 12 ou plus récent).
node <skill-dir>/scripts/setup.mjs remotion-shorts
Ceci copie le projet dans ./remotion-shorts, installe les packages épinglés (environ 260 Mo) et télécharge le navigateur sans tête avec lequel Remotion effectue le rendu (100 à 150 Mo). La première fois, cela prend 1 à 3 minutes. Exécutez-le à nouveau après une mise à jour de la compétence : il rafraîchit les fichiers modèles (ceux que l'utilisateur a modifiés sont conservés sous forme de .bak) et ne touche jamais à leurs scripts, ressources ou fichiers de sortie.
Licence. Remotion est gratuit pour les particuliers et les entreprises de 3 personnes maximum. Les entreprises de 4 personnes ou plus ont besoin d'une licence d'entreprise Remotion, et le rendu à partir de scripts est considéré comme de l'automatisation (remotion.pro/license). Si l'utilisateur effectue un rendu pour une entreprise plus grande, informez-le une fois, clairement, avant le premier rendu.
1. Demander ce dont vous avez besoin (un seul message, ignorer ce qui est déjà connu)
- Le matériel. Un sujet, un article, une URL, des notes, des données, un journal des modifications ou une liste. Vous n'écrivez que des faits que vous pouvez citer. Si l'utilisateur donne un sujet sans source, trouvez une source primaire (statistiques officielles, documentation, journal des modifications du produit) et nommez-la.
- À qui cela s'adresse et le point clé. Un short dit une seule chose.
- L'apparence. Un thème (
ink,paper,volt,ocean,clean) ou leurs couleurs de marque, et un pseudo pour l'écran de fin. - Audio. Les effets sonores intégrés sont activés par défaut (un impact sur l'accroche, un whoosh à chaque coupe, un pop sur les éléments mis en évidence, des tics pour les décomptes) ; ils sont conçus pour ce modèle et sans danger sur toutes les applications. Musique uniquement à partir d'un fichier dont ils ont les droits d'utilisation (voir
references/writing-shorts.mdpour savoir pourquoi aucune bibliothèque gratuite n'est sûre sur les trois applications). - Où cela va. TikTok, Reels, Shorts ou les trois.
2. Écrire le script
Lisez references/writing-shorts.md avant le premier script d'une session. La version courte :
- La scène 1 est une accroche qui énonce le bénéfice en environ 10 mots ou moins : un chiffre, une affirmation ou la promesse d'une liste (« 5 outils gratuits qui remplacent... »). Elle est entièrement à l'écran dès l'image 0. Si l'accroche contient un chiffre, placez-le dans
bigpour qu'il soit la première chose que l'œil voit. - Une idée par scène. Une scène est un temps fort, pas un paragraphe. Les scènes de statistiques portent un chiffre et ce qu'il signifie. Les éléments d'une liste décomptent ou comptent ; dites-le dans l'accroche.
- Une information réelle dans chaque scène. Une vidéo textuelle modélisée sans rien de nouveau est ce que YouTube appelle un contenu inauthentique et Instagram un contenu non original. Ne faites jamais de remplissage.
- Les chiffres sont exacts et sourcés. Mettez la source dans
footer(« Données : USGS »). N'arrondissez jamais un chiffre pour changer une affirmation. - Terminez par une action ou une phrase qui ramène à l'accroche pour que la boucle semble continue. Pas de « merci d'avoir regardé ».
- Durée : 15 à 45 secondes est l'objectif ; le moteur de rendu prévient au-delà de 59.
Écrivez short.json dans le dossier du projet. Le format complet, chaque type de scène et chaque option se trouvent dans references/short-json.md. Un script minimal :
{
"theme": "ink",
"footer": "Data: USGS",
"handle": "@yourhandle",
"scenes": [
{ "type": "hook", "big": "2.5%", "text": "of Earth's water is fresh" },
{ "type": "stat", "value": "96.5", "suffix": "%", "label": "is salt water in the oceans" },
{ "type": "stat", "value": "68.7", "suffix": "%", "label": "of the fresh water is ice and glaciers", "highlight": "ice and glaciers" },
{ "type": "end", "text": "Save this for trivia night", "highlight": "Save this" }
]
}
3. Vérifier avant le rendu vidéo
cd remotion-shorts
node render.mjs short.json --stills
En quelques secondes, cela affiche le plan (secondes et taille de police par scène) et écrit :
out/short/sheet.jpg: la dernière image de chaque scène (tout ce qui est à l'écran), avec les zones de sécurité marquées par une fine ligne pointillée (le texte doit rester à l'intérieur).out/short/cuts.jpg: l'image 0 et les images autour de chaque coupe, pour vérifier le mouvement.out/short/cover.jpg: l'accroche une fois qu'elle a atterri (téléchargez-la comme couverture des Reels).out/short/report.json: minutages, sauts de ligne et avertissements.
Ouvrez les deux planches et regardez-les. Vérifiez : chaque scène est-elle lisible à la taille d'un téléphone, chacune dit-elle une chose, les surbrillances sont-elles sur les mots importants, rien ne semble-t-il à l'étroit, l'ordre est-il correct, et l'image 0 montre-t-elle l'accroche complète. Corrigez le JSON et relancez --stills jusqu'à ce que vous le publieriez.
Les avertissements arrêtent le rendu vidéo (code de sortie 2) : texte trop long pour un écran, accroche trop longue, surbrillance qui n'est pas dans le texte, scène trop rapide à lire, rythme en dehors de 0,85 à 1,25, ou short de plus de 59 secondes. Corrigez le script ; utilisez --force uniquement lorsque l'utilisateur a vu l'avertissement et le souhaite quand même. Certains problèmes sont des erreurs que --force ne peut pas outrepasser, comme un mot trop large pour l'écran, quelle que soit sa taille : ceux-ci mettraient le texte hors écran.
4. Rendu
node render.mjs short.json
Écrit out/short/short.mp4 : 1080x1920, 30 fps, H.264, yuv420p, AAC (piste silencieuse lorsqu'il n'y a pas de musique), ce que TikTok, Reels et Shorts acceptent tous. Un short de 30 secondes s'affiche en environ une minute sur un ordinateur portable récent. Les machines avec 8 Go de mémoire rendent 2 images à la fois ; si un rendu est toujours interrompu par manque de mémoire, relancez-le avec --concurrency 1.
Avant de le montrer, saisissez trois images et regardez-les (début, milieu, fin), ou lisez-le si votre client le peut. Montrez ensuite à l'utilisateur la couverture, la planche et le chemin du MP4.
Plusieurs comptes : ne publiez jamais le même fichier sur plusieurs comptes. Créez une variante par compte (une accroche, un thème ou un ordre de scène différent, enregistré sous son propre JSON) afin qu'aucun compte ne publie un contenu quasi identique.
5. Publier (WoopSocial, avec confirmation)
Lisez references/woopsocial.md. En bref :
social_accounts_listpour trouver les comptes (connectez-les d'abord si nécessaire).- Pour TikTok,
social_accounts_get_platform_inputspour le compte : les options de confidentialité et la vidéo la plus longue autorisée. L'utilisateur choisit la confidentialité ; il n'y a pas de valeur par défaut. - Téléchargement :
media_uploads_create_sessionavec la taille exacte en octets dereport.json, enregistrez la réponse soussession.json, exécuteznode upload.mjs session.json out/short/short.mp4, puismedia_uploads_complete_sessionjusqu'à ce qu'il soitREADY. - Écrivez la légende par plateforme (TikTok et Reels : une ligne qui ajoute à la vidéo plus 3 à 5 hashtags spécifiques ; YouTube : un titre de moins de 100 caractères plus une description). Utilisez
contentOverridepour le texte par plateforme. posts_validate, puis montrez à l'utilisateur : comptes, légende par plateforme, confidentialité, heure de planification avec fuseau horaire, la couverture. Attendez un « oui » clair. Ensuiteposts_createetposts_get.
Champs de divulgation : isYourBrand: true sur TikTok lorsque le short fait la promotion du propre produit de l'utilisateur ; isAiGeneratedContent uniquement pour les images, vidéos ou voix IA réalistes (le texte cinétique n'en a pas besoin). YouTube madeForKids est une déclaration légale : demandez, ne devinez jamais.
6. Rapport
Montrez : le chemin du MP4, la durée, la planche, l'endroit où il a été publié (liens de posts_get) ou la planification, et tout ce que vous n'avez pas pu faire. N'inventez jamais de vues ou de résultats ; lisez-les plus tard avec social_account_posts_list et rapportez la date de leur collecte.
Modifier l'apparence
- Couleurs de marque : passez
themesous forme d'objet (bg,fg,accent,accentText,font,uppercase). Maintenez le contraste du texte à 7:1 ou mieux ; vérifiez également l'accent sur l'arrière-plan. - Photos ou vidéos derrière les scènes :
imagepar scène oubackgroundpour l'ensemble du short. Elles sont atténuées sous la couleur du thème pour que le texte reste lisible. Utilisez des fichiers que l'utilisateur possède ou pour lesquels il a une licence, et créditez-les dans la légende lorsque la licence le demande. - Polices fournies : Anton (condensée, majuscule, percutante), Poppins, Inter. Toutes sous licence OFL.
- Pour modifier les modèles eux-mêmes, modifiez
src/Short.tsxet prévisualisez avecnpm run studio.
Cas particuliers
- Pas de source pour un chiffre : ne l'utilisez pas. Dites ce qui manque.
- Texte qui ne tient pas : divisez la scène ; ne réduisez pas la police en dessous du seuil minimal (le moteur de rendu ne le fera pas).
- Texte de droite à gauche ou CJK, ou emoji : les polices fournies ne les couvrent pas et ils peuvent apparaître sous forme de boîtes vides. Dites-le et laissez-les de côté (les emoji peuvent aller dans la légende).
- L'utilisateur veut un son tendance : les publications API ne peuvent pas en ajouter un. Publiez sur TikTok avec
postMode: MEDIA_UPLOADpour qu'il atterrisse dans sa boîte de réception TikTok afin de terminer dans l'application. - Le rendu échoue sous Linux en raison de bibliothèques manquantes : installez les packages listés dans
references/platform-specs.md. - Windows : passez toujours les propriétés dans le fichier JSON, jamais en ligne sur la ligne de commande.
Barre de qualité
Avant de déclarer la tâche terminée, elle doit satisfaire à tous ces critères :
- L'image 0 montre l'accroche complète (vérifiez cuts.jpg) ; environ 10 mots ou moins, énonçant le bénéfice.
- Chaque scène dit une seule chose ; aucune scène ne dépasse environ 14 mots.
- Chaque chiffre correspond à sa source ; la source est à l'écran ou dans la légende.
- Aucun avertissement, ou l'utilisateur les a vus et a choisi
--force. - Les deux planches vérifiées : aucun texte en dehors de la ligne de sécurité en pointillés, surbrillances sur les bons mots.
- 15 à 59 secondes.
- Une version distincte pour chaque compte.
- L'utilisateur a confirmé avant que quoi que ce soit ne soit publié.