Doku / Installation und Fehlerbehebung
Installation, Updates und Speicherplatz
Läuft es auf meinem Mac? Arbeitsspeicher, Chip, Speicherplatz und Renderzeiten für jeden Mac mit Apple Silicon auf einer Seite.
Phosphene läuft über Pinokio auf Macs mit Apple Silicon (M1 oder neuer). Diese Seite erklärt, wie du es installierst und aktualisierst, wie viel Speicherplatz du brauchst und was du tust, wenn ein Schritt fehlschlägt.
Mit Pinokio installieren
- Installiere Pinokio.
- Öffne in Pinokio Discover, wähle Download from URL und füge
https://github.com/mrbizarro/phospheneein. - Klicke auf Install. Der Installer prüft zuerst deinen freien Speicherplatz. Reicht er nicht, bricht er ab und zeigt, wie viel du brauchst und wie viel du hast.
- Wenn die Installation fertig ist, klicke auf Start und dann auf Open Panel. Das Panel öffnet sich unter
http://127.0.0.1:8198.
Die App öffnet sich, sobald ihre Python-Laufzeit und die Engine-Pakete bereit sind, meist nach wenigen Minuten. Vor Start und beim ersten Öffnen wird kein Modell automatisch heruntergeladen. Wähle, was du machen willst, und lade dann das passende Modell herunter.
Hinweis Pinokio kann Phosphene weder auf einem Intel-Mac noch unter Windows installieren. Linux-Unterstützung auf Apple Silicon ist ein eigenes Community-Projekt, das Pinokio nicht installiert. Siehe Linux (Community).
Was heruntergeladen wird und wie viel Platz du brauchst
| Teil | Download | Wann |
|---|---|---|
| App-Laufzeit: Python und Engine-Pakete | Etwa 0,5 GB; Paketversionen können das ändern | Vor Start. Plane 18 GB frei ein, darunter 15 GB, die frei bleiben |
| LTX-2.5-Q4-Videomodelle, einschließlich des Prompt-Encoders | Etwa 27,5 GB | Klicke in der App auf Videomodelle herunterladen. Empfohlen für dein erstes Video |
| Zusatzfunktionen: Gemma 3 für Verbessern und den Storyboard-Planer sowie Adapter für Hochskalieren & Gesichtskorrektur, Motion Control, Ingredients und Colorize | 10,7 GB, wenn du alle wählst | Lade nur die herunter, die du nutzt, über die Funktion oder Modelle |
| Bildmodelle | Steht neben dem gewählten Modell | Beim ersten Generieren. FLUX.2 [klein] 4B ist ein kompakter Einstieg mit etwa 4,3 GB |
| LTX-2.5-Q8-Gewichte, für trainierte Charaktere und Stimmen | 30,02 GB | Optional, über Einstellungen → Modelle oder die Pinokio-Seitenleiste |
| High-Add-on, für High-Qualität, Keyframes und Verlängern auf LTX | 29,50 GB | Optional, im Fenster „Modelle“ (klicke auf den Health-Chip, dann auf Modelle) |
| Hailuo H3, die zweite Video-Engine | etwa 75 GB | Optional, über die Pinokio-Seitenleiste. Siehe Hailuo H3 |
| Musik-Engine (YuE2) | etwa 11 GB | Optional, über den Tab Audio oder die Pinokio-Seitenleiste. Siehe Musik-Studio |
| LTX-2.3, nur zum Trainieren eines Charakters nötig | etwa 20 GB, dazu etwa 21 GB für den Trainer | Wird angeboten, wenn du Charakter trainieren öffnest |
Bei einer Verbindung mit 100 Mbit/s dauert der Download der Videomodelle etwa 37 Minuten. Bei 300 Mbit/s sind es etwa 12 Minuten, bei 1 Gbit/s etwa 4 Minuten. Die App kann während des Downloads geöffnet bleiben. Die Modellkarte zeigt die empfangenen Bytes, die aktuelle Datei und die noch ausstehenden Pakete. Download stoppen beendet den gesamten Video-Download; klicke noch einmal auf Videomodelle herunterladen, um fortzusetzen. Heruntergeladene Dateien bleiben auf der Festplatte. Downloads aus „Modelle“ halten 15 GB frei und warten, wenn der Platz knapp wird.
Braucht eine Funktion ein Extra, dessen Download noch nicht fertig ist, zeigt sie eine Download-Meldung oder bietet Jetzt herunterladen an. Sie schlägt nie ohne Meldung fehl.
Tipp Unter Einstellungen kannst du ein Hugging-Face-Zugriffstoken hinterlegen, für etwa zehnmal schnellere Downloads. HDR ist das einzige Add-on, das dieses Token verlangt. Alles andere funktioniert ohne.
Modelle auf einer externen Festplatte aufbewahren
Die Modelle belegen den meisten Platz. In der Mac-App (ab 5.0.20) kannst du sie auf einer externen Festplatte aufbewahren und deinen Mac entlasten.
- Wähle den Speicherort der Modelle bei der Einrichtung: Die Zeile Modelle liegen auf … hat eine Schaltfläche Ändern, dann Anderes Laufwerk oder anderer Ordner …. Du kannst das auch später unter Einstellungen > Modelle wählen.
- Verschiebe sie später. Unter Einstellungen > Modelle kopiert Auf anderes Laufwerk verschieben … die Modelle auf das Laufwerk und prüft jede Datei. Erst danach entfernt es die Kopie auf deinem Mac. Zurück auf diesen Mac verschieben kopiert sie zurück und lässt die Kopie auf dem Laufwerk; lösche sie im Finder, wenn du den Platz brauchst. Das Verschieben zeigt seinen Fortschritt und hat eine Schaltfläche Stopp; ein gestopptes Verschieben läuft weiter, wenn du es erneut startest. Das Studio schließt sich, während die Modelle umziehen, und öffnet sich wieder, wenn sie an ihrem Platz sind.
- Nur die Modelle ziehen um. Die App und ihre Engine bleiben auf deinem Mac, sodass Phosphene sich immer öffnet.
- Wenn das Laufwerk abgezogen ist, zeigt die App „(Name des Laufwerks) ist nicht verbunden“. Stecke es an und wähle Erneut prüfen, wähle Stattdessen herunterladen, um die Entwurfsmodelle (etwa 27,5 GB) auf diesem Mac zu laden, oder wähle Ohne sie öffnen.
- Laufwerksformat. APFS- und exFAT-Laufwerke funktionieren. FAT32 kann keine Dateien über 4 GB aufnehmen, und manche Modelldateien sind größer, daher lehnt Phosphene ein FAT32-Laufwerk ab. Wenn einige deiner Modelle mit einer Pinokio-Installation geteilt werden, nimm ein Laufwerk mit APFS oder Mac OS Extended.
Lass das Laufwerk angesteckt, solange Phosphene läuft.
Den Arbeitsspeicher deines Macs prüfen
Der Arbeitsspeicher deines Macs bestimmt, welche Qualitätsstufen und Engines du nutzen kannst. Phosphene prüft das automatisch. Um zu sehen, was dein Mac kann, klicke in der Kopfzeile auf den Health-Chip und dann auf Stufe.
| Funktion | Benötigter Speicher |
|---|---|
| LTX-Video und Bilder | Jeder Mac mit Apple Silicon. Unter 48 GB gibt es kleinere Videoformate. LTX-Qualität High, Start- und Endbild und Verlängern sind ausgeblendet. Macs mit 24 GB oder weniger nutzen automatisch einen speicherarmen Video-Pfad: Auf einem 16-GB-Mac erreicht ein Clip Spitzen von etwa 5,7 GB Speicher, mit LoRAs etwa 6,7 GB. |
| Musik-Studio | 16 GB oder mehr. Für lange Songs bei geöffneten anderen Apps empfehlen wir 24 GB oder mehr |
| Einen Charakter trainieren | 24 GB oder mehr |
| Hailuo H3 | 16 GB oder mehr (Entwurf und Standard ab 16 GB, High ab 18 GB). Ab 60 GB kannst du auch die volle Engine wählen |
| LTX High · 720p | Ein Mac mit 64 GB; der Speicherverbrauch erreicht Spitzen nahe 50 GB |
Schließe vor einem langen Rendering Apps, die viel Speicher belegen, etwa Browser mit vielen Tabs, Slack oder den iOS-Simulator. Ein Rendering ist der Vorgang, bei dem dein Video oder Audio entsteht. Geht deinem Mac der Speicher aus, bricht er das Rendering ab. Siehe Fehlerbehebung.
Die Pinokio-Seitenleiste
Wähle Phosphene in Pinokio aus, um diese Aktionen in der linken Seitenleiste zu sehen. Welche verfügbar sind, hängt davon ab, was installiert ist und ob das Panel läuft.
- Install / Resume Install: installieren die nötigen Dateien. Resume Install erscheint, wenn der letzte Versuch nicht abgeschlossen wurde. Fertig heruntergeladene Dateien bleiben erhalten.
- Start, Open Panel, Terminal: Klicke auf Start, um Phosphene zu starten, dann auf Open Panel, um es zu benutzen. Terminal zeigt sein Aktivitätsprotokoll.
- Update: siehe Aktualisieren.
- Outputs, Models, Uploads: öffnen diese Ordner im Finder.
- Install Hailuo H3 (second video engine, ~75 GB): Nach der Installation wird daraus Repair Hailuo H3 oder Update Hailuo H3 runner. Beide behalten die heruntergeladenen Modelldateien.
- Build Hailuo H3 compact engine: erscheint auf einem Mac mit 16 bis 59 GB, wenn die Modelldateien heruntergeladen sind, die kompakte Engine aber nicht bereit ist. Es dauert etwa 5 Minuten und lädt nichts herunter.
- Install the music engine (YuE2, ~11 GB): Nach der Installation wird daraus Repair the music engine, das die heruntergeladenen Modelldateien behält.
- Reset engine (keeps models & outputs): baut die LTX-Engine und die Software, die sie braucht, neu auf. Deine Modelle und fertigen Arbeiten bleiben erhalten. Hailuo H3 ist davon nicht betroffen; zum Reparieren von H3 nutze Repair Hailuo H3.
Phosphene aktualisieren
- Die Versionsanzeige in der Kopfzeile zeigt Aktuell oder Update auf, gefolgt von einer neueren Version. Ist ein Update verfügbar, klicke im Banner auf Jetzt updaten, um es zu installieren, oder auf Später, um zu warten.
- Klicke in der Pinokio-Seitenleiste auf Update, um alles zu aktualisieren, auch die unterstützende Software. Deine Warteschlange, Einstellungen, Modelle und fertigen Arbeiten bleiben erhalten.
- Nach einem Update in der App steht im Banner „Aktualisiert auf … Neustart zum Abschließen“. Klicke in Pinokio auf Stop und dann auf Start.
- Wenn du von einer sehr alten Version aktualisierst und sich scheinbar nur das Panel ändert, klicke noch einmal auf Update. Das erste Update ersetzt den Updater selbst.
- Wenn das Update von Pinokio schon in der ersten Sekunde stoppt (Versionen 4.19.6 und älter können das), klicke stattdessen im eigenen Banner oder in der Versionsanzeige von Phosphene auf Jetzt updaten und starte dann neu. Siehe Update stoppt sofort.
- Verhält sich das Panel weiterhin wie die alte Version, braucht es einen Neustart. Die Versionsanzeige zeigt dann Phosphene neu starten. Klicke darauf oder klicke in Pinokio auf Stop und dann auf Start.
- Hailuo H3 und die Musik-Engine haben eigene unterstützende Software. Sagt das Panel, dass eine von beiden ein Update braucht, klicke in der Pinokio-Seitenleiste auf den Eintrag Update oder Repair dieser Engine. Deine heruntergeladenen Modelldateien bleiben erhalten.
Von Hand aktualisieren (wenn ein Update nicht ankommt)
Phosphene sucht selbst nach Updates, aber eine langsame oder blockierte Verbindung kann verhindern, dass eines ankommt. Du kannst jederzeit die neueste Version selbst installieren. Deine Modelle, fertigen Arbeiten, Einstellungen und deine Pro-Lizenz bleiben erhalten.
Mac-App
- Beende Phosphene (Phosphene → Beenden oder Cmd+Q).
- Lade den neuesten Installer von phosphene.video/download herunter (dieselbe Datei hängt auch an jedem GitHub-Release).
- Öffne die heruntergeladene
.dmgund ziehe Phosphene auf Programme. Wenn der Mac fragt, wähle Ersetzen. - Öffne Phosphene aus Programme. Die Versionsanzeige in der Kopfzeile zeigt die neue Version.
Behalte nur eine einzige Kopie, die in Programme. Ältere Kopien in Downloads oder auf einem Installer-Datenträger können sich statt der neuen öffnen: Bewege sie in den Papierkorb und wirf jeden Phosphene-Datenträger in der Finder-Seitenleiste aus. Deine Arbeit liegt in ~/Library/Application Support/Phosphene, nicht in der App, sodass das Ersetzen oder Löschen der App nichts davon entfernt.
Pinokio
- Klicke in der Pinokio-Seitenleiste von Phosphene auf Stop.
- Öffne die App Terminal, wechsle in den Phosphene-Ordner (
cd ~/pinokio/api/<your Phosphene folder>) und führegit pullaus. - Klicke in der Seitenleiste auf Update, dann auf Start.
Sagt git pull, dass du lokale Änderungen hast, führe zuerst git stash aus und dann git pull noch einmal.
Wenn eine Installation oder ein Update mit einem Fehler stoppt
Schlägt ein nötiger Schritt fehl, hält Pinokio an und zeigt eine Zeile, die mit FATAL error: beginnt. Scrolle im Protokoll, das Pinokio für diese Installation oder dieses Update zeigt, nach oben, um sie zu finden. Die Zeile erklärt das Problem und worauf du als Nächstes klicken sollst. In fast allen Fällen wurde nichts gelöscht. Klicke nach dem Beheben des Problems erneut auf Install oder Update, um fortzufahren.
Ordne den Text nach FATAL error: mit der Tabelle unten zu:
| Die Zeile lautet | Was zu tun ist |
|---|---|
| not enough disk space to install Phosphene | Schaffe den genannten Platz und klicke dann erneut auf Install |
| could not download the video engine version Phosphene needs … (a VPN, proxy or blocked GitHub is the usual cause) | Prüfe deine Verbindung, schalte VPN oder Proxy aus und klicke dann erneut auf Install oder Update |
| the engine environment did not install after 3 attempts | Prüfe deine Internetverbindung und den freien Speicherplatz und klicke dann erneut auf Install oder Update. Wiederholt es sich, melde die Zeile nach der Anleitung unten |
| the video engine is on the wrong version | Klicke erneut auf Install oder Update. Wiederholt es sich, melde die Zeile |
| Hailuo H3 needs a Mac with at least 16 GB of memory | Dein Mac kann H3 nicht ausführen. Nutze weiter LTX, das jeden Modus außer Sound hinzufügen hat |
| Hailuo H3 needs about N GB of free disk space | Für eine Neuinstallation brauchst du etwa 97 GB (der 75-GB-Download plus die 22 GB der kompakten Engine), oder etwa 25 GB, wenn die Modelldateien schon heruntergeladen sind. Schaffe den Platz und klicke dann erneut auf Install Hailuo H3 |
| the compact Hailuo H3 engine could not be built | Meist ist die Festplatte voll (der Aufbau braucht etwa 22 GB). Schaffe Platz und klicke dann erneut in der Pinokio-Seitenleiste auf den H3-Eintrag. Die Engine wird aus den heruntergeladenen Modelldateien neu aufgebaut |
| a Phosphene render has been running for over 60 minutes, so the compact Hailuo H3 engine was not built | Warte, bis Phosphene sein aktuelles Rendering beendet hat, und klicke dann erneut in der Pinokio-Seitenleiste auf den H3-Eintrag |
| the H3 venv has no working Python | Klicke in der Pinokio-Seitenleiste auf Repair Hailuo H3. Deine heruntergeladenen Modelldateien bleiben erhalten |
| YuE2 (the music engine) needs a Mac with at least 16 GB of memory | Dieser Mac kann die Musik-Engine nicht ausführen. Der Rest von Phosphene ist nicht betroffen |
| YuE2 (the music engine) needs at least 14 GB free | Schaffe den Platz und klicke dann erneut auf Install the music engine |
| could not download the YuE2 music engine | Prüfe deine Internetverbindung und ob ein VPN oder Proxy GitHub blockiert, und klicke dann erneut auf Install the music engine |
| untracked/ignored paths obstruct Update. Move them; nothing deleted. | Dateien, die du in den App-Ordner gelegt hast, stehen dem Update im Weg. Die Zeilen direkt darüber listen sie auf. Verschiebe sie aus dem Phosphene-Ordner und klicke dann erneut auf Update |
| fetch failed (offline?) - nothing changed, re-run Update | Verbinde dich wieder und klicke dann erneut auf Update |
| the Update safety check did not pass - not updating | Nichts wurde geändert. Klicke erneut auf Update. Wiederholt es sich, melde die Zeile |
Steht dein Fehler nicht in der Liste, folge den Anweisungen in seiner FATAL error:-Zeile. Um einen Fehler zu melden, kopiere diese Zeile und die paar Zeilen darüber in einen Fehlerbericht. Siehe Ein Problem melden.
Neu anfangen, ohne deine Arbeit zu verlieren
- Klicke in Pinokio auf Reset engine, um die LTX-Engine neu aufzubauen. Deine Modelle, fertigen Arbeiten und Einstellungen bleiben erhalten.
- Um deine fertigen Arbeiten zu finden, klicke in der Pinokio-Seitenleiste auf Outputs. Das öffnet
mlx_outputsim Phosphene-Ordner. - Um deine heruntergeladenen Modelle zu finden, klicke in der Seitenleiste auf Models. Das öffnet
mlx_models. Lösche diesen Ordner nicht, außer du willst alles erneut herunterladen.
Wenn Phosphene sich öffnet, aber eine Aufgabe fehlschlägt, Modelle fehlen oder deine Warteschlange pausiert, siehe Fehlerbehebung.
Quelle: webapp/docs/install.md im öffentlichen Repo. Für diese Website vor der Veröffentlichung geprüft. Aus dem englischen Original übersetzt. Änderung vorschlagen.