Docs / Premiers pas
Premiers pas
Mon Mac le fera-t-il tourner ? Mémoire, puce, disque et temps de rendu pour chaque Mac Apple Silicon, sur une seule page.
Phosphene crée des vidéos, des images, des chansons et du son sur votre Mac : rien n’est envoyé en ligne, rien n’est loué. Vous décrivez un plan, il part dans une file d’attente, et le fichier terminé arrive dans la Galerie.
Pas encore installé, ou à court d’espace disque ? Voir Installation, mises à jour et espace disque.
Les onglets
La rangée d’onglets en haut de la colonne de gauche sert à choisir ce que vous voulez créer. ⇧1-⇧7 permet de passer de l’un à l’autre au clavier.
| Onglet | À quoi il sert |
|---|---|
| Vidéo | Un clip à partir d’un prompt, ou d’une image, d’une première et d’une dernière image, d’images clés, d’un clip à prolonger, ou de vos propres médias (Remix). Voir Vidéo. |
| One Shot | Un plan continu de 30 secondes à 2 minutes, sans aucune coupe. Voir One Shot. |
| Images | Des images fixes : modifier une image de référence, ou mettre du texte sur une image avec Ideogram 4. Voir Images. |
| Storyboard | Planifiez tout un film à partir d’une idée, rendez chaque plan, étalonnez-les, montez-les. Voir Storyboard. |
| Éditeur | Une timeline : couper, diviser, déplacer le son, ajouter des titres et de la musique, rendre le film. Voir Éditeur. |
| Audio | Composer écrit des chansons avec voix ou instrumentales (Studio musical). Vidéo musicale planifie un film à partir d’une chanson et de vos images. Synchronisation labiale anime un personnage original sur une piste audio que vous avez le droit d’utiliser (Audio). |
| Entraîner le personnage | Entraînez vos propres personnages et styles originaux à partir de 15 à 500 images. Voir Entraîner un personnage. |
Le moteur
Le sélecteur de moteur dans l’en-tête choisit le modèle qui effectue le rendu : LTX ou Hailuo H3. Ce sont deux moteurs différents, avec chacun ses points forts, et non un bon moteur et un moteur de secours :
- LTX : tous les modes Vidéo, les LoRA et les personnages entraînés.
- Hailuo H3 : vidéo, dialogue et son réunis : Texte, Image, Image de début et de fin, Images clés, Prolonger, Ajouter du son et Synchronisation labiale. C’est une installation séparée d’environ 75 Go qui demande 16 Go de mémoire. Voir Hailuo H3.
Le formulaire change selon le moteur : les réglages qu’un moteur n’utilise pas sont masqués, et les puces Qualité et Durée affichent les tailles propres à ce moteur. Le sélecteur n’apparaît que si ce Mac peut faire tourner plus d’un moteur. Comparaison des moteurs.
La file d’attente
Tout ce que vous générez va dans une seule file d’attente et se rend une tâche à la fois. Le panneau du bas a quatre onglets :
- En cours : le rendu en cours, avec un aperçu en direct du plan pendant qu’il se forme. Arrêter avant la fin (sur l’aperçu) demande confirmation puis l’arrête : « rien n’est enregistré », et la file passe à la tâche suivante.
- File d’attente : les tâches en attente. La croix × sur une carte la retire.
- Récents : ce qui est terminé, filtré par Tous / Vidéos / Photos / Audio.
- Journaux : le journal de rendu. Voir Lire le journal.
Sous le bouton Générer : ⊞ Lot colle plusieurs prompts d’un coup et les met tous en file ; Mettre la file en pause suspend la file (le bouton devient alors Reprendre la file d’attente) ; Effacer retire toutes les tâches en attente, celle qui tourne continue.
La Galerie
La galerie à droite montre ce que vous avez créé. Cliquez sur une carte pour la placer dans le lecteur.
- Tous / Vidéos / Photos / Audio la filtrent, et la zone de recherche trouve les créations par mots du prompt, modèle, LoRA, taille ou seed (⌘F y accède directement).
- Tout afficher charge les rendus plus anciens que les 60 derniers.
- ← → parcourt la galerie, Space lance et met en pause, F passe le lecteur en plein écran.
- Au-dessus du lecteur, la rangée d’actions propose ce que vous pouvez faire ensuite avec ce clip : le Prolonger, lancer Upscale & Face Fix dessus, l’envoyer Vers le film, Animer une image fixe, voir ses Paramètres.
- Un clip sans son porte une pastille pas de son · Ajouter du son sur sa carte de galerie (et le lecteur l’indique aussi). Un clic place le clip dans le lecteur et ouvre Ajouter du son de Hailuo H3 avec ce clip sélectionné.
- Partager (dans le menu Plus du clip et dans la visionneuse plein écran) copie une légende d’une ligne avec le lien Phosphene et affiche le fichier dans le Finder, prêt à joindre. Rien n’est envoyé en ligne.
- L’icône en forme d’œil masque un clip de la galerie (il n’existe pour l’instant aucun moyen de le faire revenir depuis l’interface : voir Vidéo pour la restauration manuelle). Le bouton corbeille sur une carte déplace le fichier vers la Corbeille de macOS après confirmation : restaurez-le depuis le Finder si vous changez d’avis. ⌘⌫ fait la même chose pour la création sélectionnée.
Où vont les fichiers
Avec Pinokio
| Quoi | Où |
|---|---|
| Vos rendus | le dossier mlx_outputs dans l’installation de Phosphene. Le bouton dossier dans l’en-tête de la Galerie l’ouvre dans le Finder ; l’élément Outputs de Pinokio l’ouvre aussi. |
| Personnages entraînés et LoRA téléchargés | mlx_models/loras/ |
| Réglages | panel_settings.json |
Avec l’app Mac
| Quoi | Où |
|---|---|
| Vos rendus | ~/Library/Application Support/Phosphene/outputs. Le bouton dossier dans l’en-tête de la Galerie ou Studio → Ouvrir le dossier des créations l’ouvre |
| Personnages entraînés et LoRA téléchargés | ~/Library/Application Support/Phosphene/models/loras/ |
| Réglages | ~/Library/Application Support/Phosphene/state/panel_settings.json |
Chaque rendu écrit aussi à côté de lui un petit fichier annexe contenant ses réglages. C’est ce que lit Paramètres, et ce qui permet à la Galerie de chercher par LoRA ou par seed.
Le premier démarrage
Avec Pinokio
Start apparaît quand l’environnement d’exécution est prêt. Aucun modèle n’est téléchargé avant l’ouverture de l’app. L’installation demande environ 18 Go libres, dont 15 Go laissés libres pour votre travail.
Pour la vidéo, cliquez sur Télécharger les modèles vidéo. Le choix par défaut est LTX-2.5 Q4, environ 27,5 Go avec son encodeur de prompt. Il suffit pour votre première vidéo à partir d’un texte ou d’une image, sans le pack Q8, plus volumineux. Les deux parties se téléchargent à la suite, avec la progression dans le panneau. Arrêter le téléchargement conserve les fichiers partiels ; cliquez de nouveau sur le bouton de téléchargement pour reprendre.
Vous pouvez aussi choisir Images ou Audio. Ils ont leurs propres modèles et n’ont pas besoin du téléchargement vidéo. Améliorer, le planificateur du Storyboard et les adaptateurs optionnels proposent un téléchargement quand vous les utilisez. Rien d’autre ne se télécharge simplement parce que vous avez ouvert l’app.
Avec l’app Mac
L’ensemble de base pèse environ 28 Go : le moteur LTX-2.5, son encodeur de texte et le décodeur d’aperçu. Avant tout téléchargement, l’app montre chaque élément avec sa taille, l’espace nécessaire et votre espace libre. Si le studio tient mais pas les modèles, vous pouvez installer le studio maintenant et télécharger les modèles plus tard depuis l’app.
L’installation demande aussi où placer les modèles : sur ce Mac, ou sur un disque externe. Voir Garder les modèles sur un disque externe.
Si le téléchargement des modèles par l’app s’interrompt, le studio récupère lui-même le modèle vidéo, et votre premier clip est dimensionné pour votre Mac. Si l’installation n’est pas terminée, le studio affiche un bouton Terminer l’installation.
Gemma 3 (sur lequel tournent Améliorer et le planificateur du Storyboard) et les adaptateurs pour Upscale & Face Fix, Control, Ingrédients et Colorisation se téléchargent la première fois qu’une fonction en a besoin : la fonction le dit et propose Télécharger maintenant.
Mettre à jour une installation existante ne télécharge ni ne supprime rien.
Mise à jour
Avec Pinokio
- La pastille de version dans l’en-tête indique où vous en êtes : À jour, ou Mettre à jour vers une version plus récente. Quand une version est disponible, un bandeau propose Mettre à jour / Plus tard.
- Dans Pinokio, l’élément Update de la barre latérale Phosphene met tout à jour, y compris les dépendances Python. La mise à jour conserve votre file, vos réglages et vos modèles. Si une mise à jour s’arrête, voir Quand une installation s’arrête.
- Après une mise à jour dans l’app, le bandeau indique « Mis à jour vers … : redémarrez pour terminer » : cliquez sur Stop, puis sur Start dans Pinokio. Si la mise à jour a touché des dépendances, il vous demande d’utiliser plutôt Update de Pinokio.
- Si une mise à jour lancée depuis une très ancienne version semble seulement déplacer le panneau, cliquez encore une fois sur Update : une ancienne version commence par mettre à jour son propre outil de mise à jour.
- Si Update de Pinokio s’arrête dès la première seconde (cela arrive en 4.19.6 et avant), utilisez plutôt Mettre à jour dans le bandeau de Phosphene ou sa pastille de version, puis redémarrez. À partir de 4.19.7, le bouton de Pinokio refonctionne. Voir dépannage.
Avec l’app Mac
- La pastille de version montre votre version et votre commit. Cliquez dessus pour copier les détails de votre build pour un rapport de bug.
- Les mises à jour ne viennent que de Phosphene → Rechercher des mises à jour…. Votre file, vos réglages, vos modèles et votre travail terminé sont conservés.
- Pour réparer le moteur musical, ouvrez Audio → Composer et cliquez sur Réparer le moteur musical. Pour télécharger ou terminer Hailuo H3, utilisez Télécharger Hailuo H3 ou Reprendre sur sa carte (voir Hailuo H3).
La carte de remerciement
Après votre cinquième rendu terminé, une fois que vous avez laissé Phosphene tranquille pendant 30 secondes, une petite carte dans le coin demande une étoile sur GitHub. Elle ne cache jamais votre clip et ne revient jamais une fois fermée (avec la × ou Échap).
- Une étoile GitHub en un clic : si ce Mac est connecté à GitHub avec la commande
gh, Mettre une étoile sur GitHub met une étoile à Phosphene sur place et la carte vous remercie. Phosphene ne demande àghde le faire que lorsque vous cliquez ; il ne lit ni ne conserve jamais votre identifiant GitHub. - Sinon, le bouton ouvre la page GitHub de Phosphene dans votre navigateur.
- Si vous avez déjà mis une étoile (depuis l’étoile de l’en-tête, le bandeau de mise à jour, ou GitHub lui-même tel que
ghle voit), vous ne voyez jamais la carte.
Astuce Appuyez sur ? n’importe où pour ouvrir cette documentation sur la page des raccourcis, et utilisez la zone de recherche à gauche pour trouver n’importe quel bouton grâce au mot qui y est écrit.
Source : webapp/docs/getting-started.md dans le dépôt public. Relu pour ce site avant publication. Traduit de l'original anglais. Suggérer une modification.