Docs / Per iniziare
Per iniziare
Il mio Mac ce la farà? Memoria, chip, disco e tempi di render per ogni Mac con Apple Silicon, in una sola pagina.
Phosphene crea video, immagini, canzoni e suoni sul tuo Mac: niente viene caricato online, niente viene noleggiato. Descrivi un’inquadratura, finisce in una coda, e il file finito arriva nella Galleria.
Non l’hai ancora installato, o hai poco spazio su disco? Vedi Installazione, aggiornamento e spazio su disco.
Le schede
La riga di schede in cima alla colonna sinistra è il punto in cui scegli cosa creare. ⇧1-⇧7 passa dall’una all’altra con la tastiera.
| Scheda | A cosa serve |
|---|---|
| Video | Una clip a partire da un prompt, oppure da un’immagine, da un primo e un ultimo fotogramma, da keyframe, da una clip da estendere o dai tuoi media (Remix). Vedi Video. |
| One Shot | Un’unica inquadratura continua da 30 secondi a 2 minuti, senza mai un taglio. Vedi One Shot. |
| Immagini | Immagini fisse: modifica un’immagine di riferimento, oppure metti delle parole su un’immagine con Ideogram 4. Vedi Immagini. |
| Storyboard | Pianifica un intero film a partire da un’idea, fai il render di ogni inquadratura, correggine i colori, montale. Vedi Storyboard. |
| Editor | Una timeline: ritaglia, dividi, sposta l’audio, aggiungi titoli e musica, fai il render del film. Vedi Editor. |
| Audio | Componi scrive canzoni con voce o strumentali (Music Studio). Video musicale pianifica un film a partire da una canzone e dalle tue immagini. Sincronizzazione labiale anima un personaggio originale su una traccia audio che hai il diritto di usare (Audio). |
| Addestra personaggio | Addestra i tuoi personaggi e stili originali a partire da 15-500 immagini. Vedi Addestra personaggio. |
Il motore
L’interruttore del motore nell’intestazione sceglie quale modello fa il render: LTX oppure Hailuo H3. Sono due motori diversi, con punti di forza diversi: non uno buono e uno di scorta:
- LTX: ogni modalità Video, i LoRA e i personaggi addestrati.
- Hailuo H3: video, dialoghi e suono insieme: Testo, Immagine, Fotogramma iniziale e finale, Keyframe, Estendi, Aggiungi audio e Sincronizzazione labiale. È un’installazione separata di circa 75 GB e richiede 16 GB di memoria. Vedi Hailuo H3.
Il modulo cambia con il motore: i controlli che un motore non usa vengono nascosti, e i chip di Qualità e Durata mostrano le dimensioni di quel motore. L’interruttore compare solo quando questo Mac può eseguire più di un motore. Come si confrontano.
La coda
Tutto ciò che generi finisce in un’unica coda e viene elaborato un lavoro alla volta. Il pannello in basso ha quattro schede:
- In corso: il render in corso, con un’anteprima dal vivo dell’inquadratura mentre prende forma. Ferma in anticipo (sull’anteprima) chiede prima conferma, poi lo ferma: «non viene salvato nulla», e la coda prosegue con il lavoro successivo.
- Coda: i lavori in attesa. La × su una scheda lo rimuove.
- Recenti: ciò che è finito, filtrabile per Tutti / Video / Foto / Audio.
- Registri: il registro del render. Vedi Leggere il registro.
Sotto il pulsante Genera: ⊞ Lotto incolla molti prompt in una volta e li mette tutti in coda; Pausa coda ferma la coda (il pulsante poi diventa Riprendi coda); Cancella rimuove tutti i lavori in attesa, mentre quello in corso prosegue.
Galleria
La galleria a destra mostra ciò che hai creato. Clicca una scheda per metterla nel player.
- Tutti / Video / Foto / Audio la filtrano, e la casella di ricerca trova le creazioni per parole del prompt, modello, LoRA, dimensione o seed (⌘F ci porta direttamente).
- Mostra tutto carica i render più vecchi dei 60 più recenti.
- ← → scorre la galleria, Space riproduce e mette in pausa, F espande il player a schermo intero.
- Sopra il player, la riga delle azioni offre ciò che puoi fare dopo con quella clip: Estendi, eseguire Aumenta risoluzione e Correzione volto, mandarla Al film, Anima un’immagine fissa, vederne i Parametri.
- Una clip senza suono ha sulla sua scheda nella galleria una pillola Senza suono · Aggiungi suono (e lo stesso dice il player). Un clic mette la clip nel player e apre Aggiungi audio di Hailuo H3 con la clip già scelta.
- Condividi (nel menu Altro della clip e nel visualizzatore a schermo intero) copia una didascalia di una riga con il link di Phosphene e mostra il file nel Finder, pronto da allegare. Non viene caricato nulla.
- L’icona dell’occhio nasconde una clip dalla galleria (al momento non c’è modo di riportarla indietro dall’interfaccia: vedi Video per il ripristino manuale). Il pulsante del cestino su una scheda sposta il file nel Cestino di macOS dopo una conferma: ripristinalo dal Finder se cambi idea. ⌘⌫ fa lo stesso per la creazione selezionata.
Dove vanno a finire i file
Con Pinokio
| Cosa | Dove |
|---|---|
| I tuoi render | la cartella mlx_outputs dentro l’installazione di Phosphene. Il pulsante della cartella nell’intestazione della Galleria la apre nel Finder; la apre anche la voce Outputs di Pinokio. |
| Personaggi addestrati e LoRA scaricati | mlx_models/loras/ |
| Impostazioni | panel_settings.json |
Con l’app per Mac
| Cosa | Dove |
|---|---|
| I tuoi render | ~/Library/Application Support/Phosphene/outputs. La apre il pulsante della cartella nell’intestazione della Galleria oppure Studio → Apri la cartella dei risultati |
| Personaggi addestrati e LoRA scaricati | ~/Library/Application Support/Phosphene/models/loras/ |
| Impostazioni | ~/Library/Application Support/Phosphene/state/panel_settings.json |
Ogni render scrive anche un piccolo file accanto a sé con le sue impostazioni. È ciò che legge Parametri, e ciò che permette alla Galleria di cercare per LoRA o seed.
Il primo avvio
Con Pinokio
Inizia compare quando il runtime è pronto. Prima che l’app si apra non viene scaricato nessun modello. L’impostazione richiede circa 18 GB liberi, inclusi 15 GB che restano liberi per il tuo lavoro.
Per il video, clicca Scarica i modelli video. Il predefinito è LTX-2.5 Q4, circa 27.5 GB con il suo encoder dei prompt. Supporta il tuo primo video da testo o da immagine senza il pacchetto Q8, più grande. Le due parti vengono scaricate in ordine, con l’avanzamento nel pannello. Interrompi il download conserva i file parziali; clicca di nuovo il pulsante del download per riprendere.
Puoi anche scegliere Immagini o Audio. Hanno modelli propri e non richiedono il download del video. Migliora, il pianificatore dello Storyboard e gli adattatori facoltativi propongono un download quando li usi. Nient’altro inizia a scaricarsi solo perché hai aperto l’app.
Con l’app per Mac
Il set di base è di circa 28 GB: il motore LTX-2.5, il suo codificatore del testo e il decodificatore dell’anteprima. Prima che venga scaricato qualcosa, l’app mostra ogni elemento con la sua dimensione, lo spazio necessario e il tuo spazio libero. Se lo studio ci sta ma i modelli no, puoi impostare subito lo studio e scaricare i modelli più tardi da dentro.
L’impostazione chiede anche dove tenere i modelli: questo Mac, oppure un disco esterno. Vedi Tenere i modelli su un disco esterno.
Se il download dei modelli dell’app si interrompe, lo studio scarica da solo il modello video e la tua prima clip viene dimensionata per stare nel tuo Mac. Se l’impostazione non è terminata, lo studio mostra un pulsante Completa l’impostazione.
Gemma 3 (su cui girano Migliora e il pianificatore dello Storyboard) e gli adattatori per Aumenta risoluzione e Correzione volto, Controllo, Ingredienti e Colora si scaricano quando una funzione ne ha bisogno per la prima volta: la funzione lo dice e propone Scarica ora.
Aggiornare un’installazione esistente non scarica e non rimuove nulla.
Aggiornamento
Con Pinokio
- La pillola della versione nell’intestazione dice a che punto sei: Aggiornato, oppure Aggiorna a una versione più recente. Quando ne è uscita una, un banner propone Aggiorna ora / Più tardi.
- In Pinokio, la voce Update nella barra laterale di Phosphene aggiorna tutto, comprese le dipendenze Python. L’aggiornamento conserva la tua coda, le impostazioni e i modelli. Se un aggiornamento si ferma, vedi Quando un’installazione si ferma.
- Dopo un aggiornamento dall’app il banner dice «Aggiornato a … riavvia per terminare»: clicca Stop, poi Start in Pinokio. Se l’aggiornamento ha toccato le dipendenze, ti dice di usare invece Update di Pinokio.
- Se un aggiornamento partito da una versione molto vecchia sembra muovere solo il pannello, clicca Aggiorna ancora una volta: una versione vecchia aggiorna prima il proprio aggiornatore.
- Se Update di Pinokio si ferma nel primo secondo (può succedere con la 4.19.6 e precedenti), usa invece Aggiorna ora nel banner di Phosphene o nella sua pillola della versione, poi riavvia. Dalla 4.19.7 in poi il pulsante di Pinokio funziona di nuovo. Vedi risoluzione dei problemi.
Con l’app per Mac
- La pillola della versione mostra la tua versione e il commit. Cliccala per copiare i dettagli della tua build da allegare a una segnalazione di bug.
- Gli aggiornamenti arrivano solo da Phosphene → Verifica aggiornamenti…. La tua coda, le impostazioni, i modelli e il lavoro finito vengono conservati.
- Per riparare il motore musicale, apri Audio → Componi e clicca Ripara il motore musicale. Per scaricare o completare Hailuo H3, usa Scarica Hailuo H3 o Riprendi sulla sua scheda (vedi Hailuo H3).
La scheda di ringraziamento
Dopo il tuo quinto render finito, quando hai lasciato Phosphene in pace per 30 secondi, una piccola scheda nell’angolo chiede una stella su GitHub. Non copre mai la tua clip e non torna mai più una volta chiusa (con la × o con Esc).
- Stella su GitHub con un clic: se questo Mac ha effettuato l’accesso a GitHub con il comando
gh, Metti una stella su GitHub mette la stella a Phosphene direttamente da lì e la scheda ringrazia. Phosphene chiede aghdi farlo solo quando clicchi; non legge né conserva mai il tuo accesso a GitHub. - Altrimenti il pulsante apre la pagina GitHub di Phosphene nel tuo browser.
- Se la stella l’hai già messa (dalla stella nell’intestazione, dal banner di aggiornamento o da GitHub stesso, come lo vede
gh), la scheda non compare mai.
Suggerimento Premi ? ovunque per aprire questa documentazione sulla pagina delle scorciatoie, e usa la casella di ricerca a sinistra per trovare qualsiasi pulsante dalla parola scritta su di esso.
Fonte: webapp/docs/getting-started.md nel repository pubblico. Rivisto per questo sito prima della pubblicazione. Tradotto dall'originale inglese. Suggerisci una modifica.