Docs / Installation et dépannage
Installation, mises à jour et espace disque
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 fonctionne sur les Mac Apple Silicon (M1 ou plus récent) via Pinokio. Cette page explique comment l’installer et le mettre à jour, de combien d’espace disque vous avez besoin, et quoi faire si une étape échoue.
Installer avec Pinokio
- Installez Pinokio.
- Dans Pinokio, ouvrez Discover, choisissez Download from URL et collez
https://github.com/mrbizarro/phosphene. - Cliquez sur Install. L’installateur vérifie d’abord votre espace disque libre. S’il n’y en a pas assez, il s’arrête et indique de combien vous avez besoin et de combien vous disposez.
- Quand l’installation est terminée, cliquez sur Start, puis sur Open Panel. Le panneau s’ouvre à l’adresse
http://127.0.0.1:8198.
L’app s’ouvre une fois que son environnement Python et ses paquets de moteur sont prêts, en général en quelques minutes. Aucun modèle n’est téléchargé avant Start ni automatiquement à la première ouverture. Choisissez ce que vous voulez créer, puis téléchargez le modèle correspondant.
Note Pinokio ne peut pas installer Phosphene sur un Mac Intel ni sur Windows. La prise en charge de Linux sur Apple Silicon est un projet communautaire distinct que Pinokio n’installe pas. Voir Linux (communauté).
Ce qui est téléchargé, et l’espace dont vous avez besoin
| Élément | Téléchargement | Quand |
|---|---|---|
| Environnement de l’app : Python et paquets du moteur | Environ 0,5 Go ; les versions des paquets peuvent faire varier ce chiffre | Avant Start. Prévoyez 18 Go libres, dont 15 Go laissés libres |
| Modèles vidéo LTX-2.5 Q4, dont l’encodeur de prompt | Environ 27,5 Go | Cliquez sur Télécharger les modèles vidéo dans l’app. Recommandé pour votre première vidéo |
| Extras de fonctions : Gemma 3 pour Améliorer et le planificateur du Storyboard, plus les adaptateurs pour Upscale & Face Fix, Motion Control, Ingrédients et Colorisation | 10,7 Go si vous les prenez tous | Ne téléchargez que ceux que vous utilisez, depuis la fonction ou depuis Modèles |
| Modèles d’images | Indiqué à côté du modèle sélectionné | À la première génération. FLUX.2 [klein] 4B est un point de départ compact, environ 4,3 Go |
| Poids LTX-2.5 Q8, pour les personnages et les voix entraînés | 30,02 Go | Optionnel, depuis Réglages → Modèles ou la barre latérale de Pinokio |
| Extension Haute, pour la qualité Haute, les Images clés et Prolonger sur LTX | 29,50 Go | Optionnel, depuis la fenêtre Modèles (cliquez sur la pastille d’état, puis sur Modèles) |
| Hailuo H3, le deuxième moteur vidéo | Environ 75 Go | Optionnel, depuis la barre latérale de Pinokio. Voir Hailuo H3 |
| Moteur musical (YuE2) | Environ 11 Go | Optionnel, depuis l’onglet Audio ou la barre latérale de Pinokio. Voir Studio musical |
| LTX-2.3, nécessaire uniquement pour entraîner un personnage | Environ 20 Go, plus environ 21 Go pour l’entraîneur | Proposé quand vous ouvrez Entraîner le personnage |
Avec une connexion à 100 Mbit/s, les modèles vidéo mettent environ 37 minutes à se télécharger. À 300 Mbit/s, environ 12 minutes ; à 1 Gbit/s, environ 4 minutes. L’app peut rester ouverte pendant le téléchargement des modèles. La carte du modèle affiche les octets reçus, le fichier en cours et les paquets restants. Arrêter le téléchargement arrête tout le téléchargement vidéo ; cliquez de nouveau sur Télécharger les modèles vidéo pour le reprendre. Les fichiers téléchargés restent sur le disque. Les téléchargements depuis Modèles gardent 15 Go libres et attendent si l’espace vient à manquer.
Si une fonction a besoin d’un extra dont le téléchargement n’est pas terminé, elle affiche un message de téléchargement ou propose Télécharger maintenant. Elle n’échoue pas sans rien dire.
Astuce Vous pouvez ajouter un jeton d’accès Hugging Face dans Réglages pour des téléchargements environ dix fois plus rapides. HDR est la seule extension qui exige ce jeton. Tout le reste fonctionne sans lui.
Garder les modèles sur un disque externe
Les modèles occupent l’essentiel de la place. Dans l’app Mac (5.0.20 ou plus récente), vous pouvez les garder sur un disque externe et libérer votre Mac.
- Choisissez où vivent les modèles pendant la configuration : la ligne Models go on … a un bouton Change, puis Another drive or folder…. Vous pouvez aussi choisir plus tard dans Réglages > Modèles.
- Déplacez-les plus tard. Dans Réglages > Modèles, Déplacer vers un autre disque… copie les modèles sur le disque et vérifie chaque fichier. Ce n’est qu’ensuite qu’il supprime la copie de votre Mac. Rapatrier sur ce Mac les recopie et garde la copie sur le disque ; supprimez-la dans le Finder si vous voulez récupérer la place. Le déplacement affiche sa progression et a un bouton Arrêter, et un déplacement interrompu reprend quand vous le relancez. Le studio se ferme pendant le déplacement des modèles et se rouvre quand ils sont en place.
- Seuls les modèles bougent. L’app et son moteur restent sur votre Mac, si bien que Phosphene s’ouvre toujours.
- Si le disque est débranché, l’app affiche “(the drive’s name) isn’t connected”. Rebranchez-le et choisissez Revérifier, choisissez Télécharger plutôt pour obtenir les modèles de brouillon (environ 27,5 Go) sur ce Mac, ou choisissez Ouvrir sans les modèles.
- Format du disque. Les disques APFS et exFAT fonctionnent. FAT32 ne peut pas contenir de fichiers de plus de 4 Go, et certains fichiers de modèle sont plus gros : Phosphene refuse donc un disque FAT32. Si certains de vos modèles sont partagés avec une installation Pinokio, utilisez un disque APFS ou Mac OS étendu.
Gardez le disque branché tant que Phosphene tourne.
Vérifier la mémoire de votre Mac
La mémoire de votre Mac détermine les réglages de qualité et les moteurs que vous pouvez utiliser. Phosphene la vérifie automatiquement. Pour voir ce que votre Mac peut exécuter, cliquez sur la pastille d’état dans l’en-tête, puis sur Palier.
| Fonction | Mémoire nécessaire |
|---|---|
| Vidéo LTX et Images | N’importe quel Mac Apple Silicon. Sous 48 Go, vous avez des tailles de vidéo plus petites. La qualité Haute de LTX, Image de début et de fin et Prolonger sont masquées. Les Mac de 24 Go ou moins utilisent automatiquement un chemin vidéo économe en mémoire : sur un Mac de 16 Go, un clip atteint au plus environ 5,7 Go de mémoire, environ 6,7 Go avec des LoRA. |
| Studio musical | 16 Go ou plus. 24 Go ou plus recommandés pour les longs morceaux avec d’autres apps ouvertes |
| Entraînement d’un personnage | 24 Go ou plus |
| Hailuo H3 | 16 Go ou plus (Brouillon et Standard dès 16 Go, Haute dès 18 Go). Avec 60 Go ou plus, vous pouvez aussi choisir le moteur complet |
| LTX Haute · 720p | Un Mac de 64 Go ; l’utilisation de mémoire atteint presque 50 Go |
Avant un long rendu, fermez les apps qui utilisent beaucoup de mémoire, comme les navigateurs avec beaucoup d’onglets, Slack ou le simulateur iOS. Un rendu est le processus de création de votre vidéo ou de votre audio. Si votre Mac manque de mémoire, il arrête le rendu. Voir Dépannage.
La barre latérale de Pinokio
Sélectionnez Phosphene dans Pinokio pour voir ces actions dans la barre latérale gauche. Les actions disponibles dépendent de ce qui est installé et de l’état du panneau (en marche ou non).
- Install / Resume Install : installent les fichiers requis. Resume Install apparaît si la dernière tentative ne s’est pas terminée. Les fichiers dont le téléchargement est fini sont conservés.
- Start, Open Panel, Terminal : cliquez sur Start pour lancer Phosphene, puis sur Open Panel pour l’utiliser. Terminal affiche son journal d’activité.
- Update : voir Mise à jour.
- Outputs, Models, Uploads : ouvrent ces dossiers dans le Finder.
- Install Hailuo H3 (second video engine, ~75 GB) : après l’installation, devient Repair Hailuo H3 ou Update Hailuo H3 runner. Les deux conservent les fichiers de modèle téléchargés.
- Build Hailuo H3 compact engine : apparaît sur un Mac de 16 à 59 Go quand les fichiers du modèle sont téléchargés mais que le moteur compact n’est pas prêt. Cela prend environ 5 minutes et ne télécharge rien.
- Install the music engine (YuE2, ~11 GB) : après l’installation, devient Repair the music engine, qui conserve les fichiers de modèle téléchargés.
- Reset engine (keeps models & outputs) : reconstruit le moteur LTX et les logiciels dont il a besoin. Vos modèles et votre travail terminé sont conservés. Cela n’affecte pas Hailuo H3 ; pour réparer H3, utilisez Repair Hailuo H3.
Mettre à jour Phosphene
- La pastille de version dans l’en-tête affiche À jour, ou Mettre à jour vers suivi d’une version plus récente. Quand une mise à jour est disponible, cliquez sur Mettre à jour dans le bandeau pour l’installer, ou sur Plus tard pour attendre.
- Cliquez sur Update dans la barre latérale de Pinokio pour tout mettre à jour, y compris les logiciels qui accompagnent l’app. Votre file d’attente, vos réglages, vos modèles et votre travail terminé sont conservés.
- Après une mise à jour depuis l’app, le bandeau affiche “Updated to … restart to finish”. Cliquez sur Stop, puis sur Start, dans Pinokio.
- Si vous mettez à jour depuis une très ancienne version et que seul le panneau semble changer, cliquez une fois de plus sur Update. La première mise à jour remplace l’outil de mise à jour lui-même.
- Si l’Update de Pinokio s’arrête dès la première seconde (les versions 4.19.6 et antérieures peuvent le faire), cliquez plutôt sur Mettre à jour dans le bandeau ou la pastille de version de Phosphene, puis redémarrez. Voir La mise à jour s’arrête tout de suite.
- Si le panneau se comporte toujours comme l’ancienne version, il faut le redémarrer. La pastille de version affiche alors Redémarrer Phosphene. Cliquez dessus, ou cliquez sur Stop puis sur Start dans Pinokio.
- Hailuo H3 et le moteur musical ont chacun leurs logiciels d’accompagnement. Si le panneau indique que l’un des deux a besoin d’une mise à jour, cliquez sur l’entrée Update ou Repair de ce moteur dans la barre latérale de Pinokio. Vos fichiers de modèle téléchargés sont conservés.
Mettre à jour à la main (si une mise à jour n’arrive pas)
Phosphene cherche les mises à jour tout seul, mais une connexion lente ou bloquée peut empêcher l’une d’elles d’arriver. Vous pouvez toujours installer vous-même la version la plus récente. Vos modèles, votre travail terminé, vos réglages et votre licence Pro sont conservés.
App Mac
- Quittez Phosphene (Phosphene → Quitter, ou Cmd+Q).
- Téléchargez le dernier installateur depuis phosphene.video/download (le même fichier est aussi joint à chaque version GitHub).
- Ouvrez le
.dmgtéléchargé et faites glisser Phosphene sur Applications. Quand le Mac vous le demande, choisissez Remplacer. - Ouvrez Phosphene depuis Applications. La pastille de version dans l’en-tête affiche la nouvelle version.
Gardez une seule copie, celle qui est dans Applications. Les anciennes copies laissées dans Téléchargements ou sur un disque d’installation peuvent s’ouvrir à la place de la nouvelle : mettez-les à la corbeille et éjectez tout disque Phosphene dans la barre latérale du Finder. Votre travail se trouve dans ~/Library/Application Support/Phosphene, pas dans l’app : remplacer ou supprimer l’app n’en retire rien.
Pinokio
- Cliquez sur Stop dans la barre latérale Pinokio de Phosphene.
- Ouvrez l’app Terminal, allez dans le dossier Phosphene (
cd ~/pinokio/api/<your Phosphene folder>) et lancezgit pull. - Cliquez sur Update dans la barre latérale, puis sur Start.
Si git pull signale des modifications locales, lancez d’abord git stash, puis git pull de nouveau.
Si une installation ou une mise à jour s’arrête avec une erreur
Si une étape obligatoire échoue, Pinokio s’arrête et affiche une ligne qui commence par FATAL error:. Remontez dans le journal que Pinokio affiche pour cette installation ou cette mise à jour pour la trouver. La ligne explique le problème et sur quoi cliquer ensuite. Dans presque tous les cas, rien n’a été supprimé. Une fois le problème réglé, cliquez de nouveau sur Install ou Update pour continuer.
Utilisez le tableau ci-dessous pour retrouver le texte qui suit FATAL error: :
| La ligne dit | Que faire |
|---|---|
| not enough disk space to install Phosphene | Libérez l’espace indiqué, puis cliquez de nouveau sur Install |
| could not download the video engine version Phosphene needs … (a VPN, proxy or blocked GitHub is the usual cause) | Vérifiez votre connexion, désactivez le VPN ou le proxy, puis cliquez de nouveau sur Install ou Update |
| the engine environment did not install after 3 attempts | Vérifiez votre connexion Internet et votre espace disque libre, puis cliquez de nouveau sur Install ou Update. Si cela se répète, signalez la ligne en suivant les instructions ci-dessous |
| the video engine is on the wrong version | Cliquez de nouveau sur Install ou Update. Si cela se répète, signalez la ligne |
| Hailuo H3 needs a Mac with at least 16 GB of memory | Votre Mac ne peut pas faire tourner H3. Continuez avec LTX, qui a tous les modes sauf Ajouter du son |
| Hailuo H3 needs about N GB of free disk space | Il vous faut environ 97 Go pour une nouvelle installation (les 75 Go à télécharger plus les 22 Go du moteur compact), ou environ 25 Go si les fichiers du modèle sont déjà téléchargés. Libérez l’espace, puis cliquez de nouveau sur Install Hailuo H3 |
| the compact Hailuo H3 engine could not be built | Cela veut généralement dire que le disque est plein (la construction demande environ 22 Go). Libérez de l’espace, puis cliquez de nouveau sur l’entrée H3 dans la barre latérale de Pinokio. Elle se reconstruit à partir des fichiers de modèle téléchargés |
| a Phosphene render has been running for over 60 minutes, so the compact Hailuo H3 engine was not built | Attendez que Phosphene ait terminé son rendu en cours, puis cliquez de nouveau sur l’entrée H3 dans la barre latérale de Pinokio |
| the H3 venv has no working Python | Cliquez sur Repair Hailuo H3 dans la barre latérale de Pinokio. Vos fichiers de modèle téléchargés sont conservés |
| YuE2 (the music engine) needs a Mac with at least 16 GB of memory | Ce Mac ne peut pas faire tourner le moteur musical. Le reste de Phosphene n’est pas affecté |
| YuE2 (the music engine) needs at least 14 GB free | Libérez l’espace, puis cliquez de nouveau sur Install the music engine |
| could not download the YuE2 music engine | Vérifiez votre connexion Internet et si un VPN ou un proxy bloque GitHub, puis cliquez de nouveau sur Install the music engine |
| untracked/ignored paths obstruct Update. Move them; nothing deleted. | Des fichiers que vous avez ajoutés dans le dossier de l’app gênent la mise à jour. Les lignes juste au-dessus les listent. Sortez-les du dossier Phosphene, puis cliquez de nouveau sur Update |
| fetch failed (offline?) - nothing changed, re-run Update | Reconnectez-vous, puis cliquez de nouveau sur Update |
| the Update safety check did not pass - not updating | Rien n’a été modifié. Cliquez de nouveau sur Update. Si cela se répète, signalez la ligne |
Si votre erreur n’est pas listée, suivez les instructions de sa ligne FATAL error:. Pour signaler une erreur, copiez cette ligne et les quelques lignes au-dessus dans un rapport de bug. Voir Signaler un problème.
Repartir de zéro sans perdre votre travail
- Cliquez sur Reset engine dans Pinokio pour reconstruire le moteur LTX. Vos modèles, votre travail terminé et vos réglages sont conservés.
- Pour retrouver votre travail terminé, cliquez sur Outputs dans la barre latérale de Pinokio. Cela ouvre
mlx_outputsdans le dossier Phosphene. - Pour retrouver vos modèles téléchargés, cliquez sur Models dans la barre latérale. Cela ouvre
mlx_models. Ne supprimez pas ce dossier, sauf si vous voulez tout télécharger de nouveau.
Si Phosphene s’ouvre mais qu’une tâche échoue, que des modèles manquent ou que votre file d’attente se met en pause, voir Dépannage.
Source : webapp/docs/install.md dans le dépôt public. Relu pour ce site avant publication. Traduit de l'original anglais. Suggérer une modification.