Communitygithub.com

flutter-demo-reel

Transforme une application Flutter en vidéo promotionnelle ou démo en boucle pour les réseaux sociaux (16:9 et 9:16, 60 ips). Génère une application macOS Flutter séparée dans <app>/demo avec 3D via flutter_scene (GPU Flutter), un kit 2D de particules et de titres, des coupures synchronisées sur une bande-son, et export hors ligne en H.264 et ProRes avec ffmpeg. À utiliser lorsque l'utilisateur demande une vidéo promotionnelle, une démo, une bande-annonce, un teaser, une vidéo de lancement, une vidéo sociale ou une démonstration animée d'une application Flutter.

Qu'est-ce que flutter-demo-reel ?

Ce skill permet de créer une vidéo promotionnelle en boucle pour une application Flutter, sous forme d'une application macOS autonome située dans `<app>/demo`. Le rendu est effectué image par image en local, puis encodé. Il utilise les écrans réels de l'application, ses polices et son contenu, une couche 3D avec `flutter_scene` (Flutter GPU sur Metal), un kit 2D de particules et de titres, et synchronise les coupures avec la musique. Le skill s'exécute sur macOS avec Flutter Desktop, ffmpeg et Python. Le processus comprend huit étapes : l'interview de l'utilisateur (durée, format, musique, message, captures d'écran), l'analyse de l'application (thème, polices, contenu), l'analyse audio pour extraire le tempo et les repères, la rédaction d'un script validé, l'initialisation du projet (scaffold), la construction de la bande-annonce section par section avec inspection visuelle via des planches contact, l'export final (H.264 et ProRes) et la livraison avec itération. Chaque image est une fonction pure du temps, ce qui garantit un bouclage parfait et un rendu par lots.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/vlidholt/flutter-skills/tree/HEAD/skills/flutter-demo-reel

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Bande démo Flutter

Construisez une courte promo en boucle pour une application Flutter sous la forme d'une application macOS Flutter autonome dans <flutter app>/demo, rendez-la image par image hors ligne et encodez-la. La bande utilise les écrans réels de l'application, ses illustrations, ses polices et son contenu, une couche 3D avec flutter_scene (Flutter GPU sur Metal), un kit 2D de particules et de titres, et des coupures synchronisées sur la musique.

Les chemins ci-dessous sont relatifs au dossier de ce skill (le dossier contenant ce SKILL.md). Dans Claude Code, ce dossier est ${CLAUDE_SKILL_DIR}.

Règles de base

  • Ne modifiez jamais l'application. Copiez ce dont vous avez besoin (illustrations, polices, captures d'écran, données de contenu, couleurs du thème) dans demo/. Le scaffold ajoute uniquement demo/** aux exclusions de l'analyseur du paquet parent.
  • Chaque image est une fonction pure de t. Pas d'état entre les images, pas de Random(), pas d'horloges, pas de simulation : mouvement en forme fermée, aléatoire ensemencé. C'est ce qui permet le défilement, l'export par lots, le flou de mouvement et une boucle sans couture. Lisez references/kit.md avant d'écrire des plans.
  • Suivez les règles de voix du projet (AGENTS.md, CLAUDE.md ou similaire) : mots que l'application n'utilise jamais, comment le produit se nomme, ton.
  • Acceptez avant de construire. Interviewez l'utilisateur, puis rédigez un script qu'il approuve.
  • macOS uniquement. Nécessite Flutter avec macOS Desktop, ffmpeg (brew install ffmpeg), et Python 3 avec Pillow (planches contact) et numpy (analyse audio).

Flux de travail

1. Interview

Demandez avant de commencer, en proposant une valeur par défaut pour chaque point afin que l'utilisateur puisse répondre rapidement :

  1. Durée et boucle (par défaut 30 s, boucle transparente), formats (paysage 1920x1080 et portrait 1080x1920, portrait conçu pour Reels, TikTok et Shorts), 60 ips.
  2. Bande-son : un fichier (avec paroles ?) ou aucun, et qui en possède les droits.
  3. Le message : les 3 à 5 choses à montrer, l'appel à l'action (URL, badges de l'app store), les affirmations à faire (gratuit ? notes ? comptes ?).
  4. Aspect et ton : jusqu'où aller, la marque de l'application, toute référence.
  5. Écrans réels : lesquels, et pouvez-vous exécuter l'application pour les capturer (compte de test, données amorcées) ? Des plans atmosphériques inventés aussi ?
  6. Texte à l'écran : mots-clés uniquement (par défaut) ou légendes complètes, orthographe du nom du produit, mots à éviter.
  7. Quelque chose de spécial : œufs de Pâques, personnages, choses à ne jamais montrer.

2. Étudier l'application

Lisez le thème de l'application (couleurs, polices), les ressources (logos, personnages, icônes), le contenu (vrais noms, chiffres, données à afficher) et ses écrans principaux. Notez ce qui la rend distinctive. Planifiez les captures d'écran et capturez-les, ou demandez-les à l'utilisateur (voir « Captures d'écran réelles » dans references/craft.md).

3. Analyser la bande-son

python3 scripts/analyze_audio.py <track>

Transformez son tempo, sa phase de battement, ses sections et ses lignes vocales en repères nommés, comme dans references/audio-sync.md. Sans bande-son, choisissez quand même un tempo et coupez sur sa grille.

4. Rédiger le script

Créez un tableau minuté avec, pour chaque plan : la musique ou la parole, l'image paysage, l'image portrait et le texte à l'écran (modèle dans references/craft.md). Marquez l'accroche, le drop, la carte de fin et la jointure de boucle. Obtenez l'approbation de l'utilisateur et itérez jusqu'à ce qu'il donne son feu vert.

5. Initialiser

zsh scripts/scaffold.sh <chemin de l'app Flutter>

Exécutez-le avec le chemin complet vers le dossier scripts/ de ce skill ; il fonctionne depuis n'importe quel répertoire. Il :

  • crée <app>/demo avec flutter create --platforms macos ;
  • ajoute flutter_scene, vector_math et audioplayers, et exécute flutter_scene:init ;
  • active Flutter GPU (FLTEnableFlutterGPU) et désactive le bac à sable de l'application (l'exportateur exécute ffmpeg) ;
  • copie le kit de démarrage depuis assets/template/, crée art/, art/screens/, audio/ et fonts/, et ignore out/ ;
  • exclut demo/** de l'analyseur du paquet parent.

Il fonctionne avec les espaces de travail pub (la démo reste un paquet autonome) et refuse d'écraser un dossier existant.

Configurez ensuite :

  • lib/core/timeline.dart : kDuration, kBpm, kBeatPhase et les Cues.
  • lib/core/format.dart : Palette depuis le thème de l'application, et Fonts (copiez les fichiers de polices dans demo/fonts/ et déclarez-les dans pubspec.yaml).
  • Ressources : art/ (listez les sous-dossiers dans pubspec.yaml) et audio/track.wav (48 kHz PCM).

Compilez une fois et rendez les images de test pour prouver que la configuration fonctionne :

cd <app>/demo && flutter build macos --profile && tool/run.sh stills "0.3,2.3,9" both

6. Construire la bande

Remplacez lib/shots/example.dart par une section par partie du script, listez-les dans Director.sections et définissez les hits de caméra dans Director._hits. Travaillez section par section :

  1. Écrivez la section (image 3D, et couches 2D en dessous et au-dessus) en utilisant le kit (references/kit.md) et flutter_scene (references/flutter-scene.md).
  2. Exécutez flutter build macos --profile, puis rendez les images aux moments clés de la section dans les deux formats : tool/run.sh stills "t1,t2,..." both.
  3. Réalisez une planche contact par format et inspectez-la, ainsi que des images individuelles en gros plan là où le détail compte : python3 tool/sheet.py out/l.png 4 480 out/stills/landscape_*.png. Si vous ne pouvez pas visualiser les images, dites à l'utilisateur quelles images vérifier et quoi regarder. Corrigez et répétez.

Passez en revue la liste de vérification dans references/craft.md sur l'ensemble de la bande avant l'exportation. L'utilisateur peut la visionner avec la musique dans l'application de prévisualisation (open build/macos/Build/Products/Profile/*.app) ; les images ne peuvent pas montrer le timing.

7. Exporter

tool/export.sh draft both     # 1x, sans flou de mouvement : vérification rapide complète
tool/export.sh final both     # 2x suréchantillonné, flou de mouvement sur 4 échantillons

Un export final prend environ 10 à 15 minutes par format pour 30 s. Lancez-le en arrière-plan si votre environnement le permet, et ne le sondez pas. Ensuite, vérifiez les fichiers avec ffprobe : le nombre d'images est kDuration * kFps, la durée est correcte et il y a un flux audio. Extrayez quelques images des MP4, y compris la dernière image et l'image 0 (la jointure de boucle).

8. Livrer et itérer

Donnez à l'utilisateur les chemins (demo/out/final/<format>.mp4 pour l'upload, <format>_master.mov ProRes pour le montage), les tailles de fichiers et ce qu'il doit vérifier. Attendez-vous à des commentaires. Les plus courants, avec leurs correctifs, se trouvent dans references/craft.md : texte affiché trop brièvement, texte masqué, sous-titres indésirables, coutures dans les contours, rayons lumineux durs, un ensemble d'éléments identiques, formulation portrait. Corrigez tous les commentaires en une session avant de relancer le rendu.

Fichiers

  • references/kit.md : architecture et API du kit de démarrage.
  • references/flutter-scene.md : configuration, apparence et pièges hors ligne de flutter_scene.
  • references/audio-sync.md : tempo, phase, paroles et repères à partir d'une piste.
  • references/craft.md : modèle de script, règles de texte, recettes d'effets, captures d'écran, liste de vérification.
  • scripts/scaffold.sh : crée l'application démo.
  • scripts/analyze_audio.py : tempo, phase de battement, volume par mesure, attaques.
  • assets/template/ : kit de démarrage copié par le scaffold.

Skills associés