Docs / Primeiros passos
Primeiros passos
Meu Mac vai rodar isso? Memória, chip, disco e tempos de renderização de cada Mac Apple Silicon, em uma só página.
O Phosphene cria vídeo, imagens, músicas e som no seu Mac: nada é enviado, nada é alugado. Você descreve um plano, ele entra em uma fila e o arquivo pronto aparece na Galeria.
Ainda não instalou, ou está com pouco espaço em disco? Veja Instalar, atualizar e espaço em disco.
As abas
A fileira de abas no topo da coluna da esquerda é onde você escolhe o que criar. ⇧1-⇧7 alterna entre elas pelo teclado.
| Aba | Para que serve |
|---|---|
| Vídeo | Um clipe a partir de um prompt, ou de uma imagem, de um primeiro e último quadro, de quadros-chave, de um clipe para estender ou da sua própria mídia (Remix). Veja Vídeo. |
| One Shot | Um plano contínuo de 30 segundos a 2 minutos que nunca corta. Veja One Shot. |
| Imagens | Imagens estáticas: edite uma imagem de referência ou coloque palavras em uma imagem com o Ideogram 4. Veja Imagens. |
| Storyboard | Planeje um filme inteiro a partir de uma ideia, renderize cada plano, faça a correção de cor e monte tudo. Veja Storyboard. |
| Editor | Uma linha do tempo: corte, divida, mova o som, adicione títulos e música e renderize o filme. Veja Editor. |
| Áudio | Compor escreve músicas com vocais ou instrumentais (Estúdio de música). Videoclipe planeja um filme a partir de uma música e das suas imagens. Sincronização labial anima um personagem original com uma faixa de áudio que você tem direito de usar (Áudio). |
| Treinar personagem | Treine seus próprios personagens e estilos originais a partir de 15 a 500 imagens. Veja Treinar personagem. |
O motor
A chave de motor no cabeçalho escolhe qual modelo renderiza: LTX ou Hailuo H3. São dois motores diferentes, com pontos fortes diferentes, não um bom e um reserva:
- LTX: todos os modos de Vídeo, LoRAs e personagens treinados.
- Hailuo H3: vídeo, diálogo e som em conjunto: Texto, Imagem, Quadro inicial e final, Quadros-chave, Estender, Adicionar som e Sincronização labial. É uma instalação separada de cerca de 75 GB e exige 16 GB de memória. Veja Hailuo H3.
O formulário muda com o motor: os controles que um motor não usa ficam ocultos, e os chips de Qualidade e Duração mostram os tamanhos próprios daquele motor. A chave só aparece quando este Mac consegue rodar mais de um motor. Como eles se comparam.
A fila
Tudo o que você gera vai para uma única fila e é renderizado um job por vez. O painel na parte de baixo tem quatro abas:
- Agora: a renderização em andamento, com uma prévia ao vivo do plano se formando. Parar antes (na prévia) pergunta primeiro e depois interrompe: “nada é salvo”, e a fila segue com o próximo job.
- Fila: os jobs que esperam. O × em um cartão o remove.
- Recentes: o que terminou, filtrado por Todos / Vídeos / Fotos / Áudio.
- Registros: o log da renderização. Veja Lendo o log.
Abaixo do botão Gerar: ⊞ Lote cola vários prompts de uma vez e coloca todos na fila; Pausar a fila segura a fila (o botão passa a dizer Retomar a fila); Limpar remove todos os jobs que esperam, e o que está rodando continua.
Galeria
A galeria à direita mostra o que você criou. Clique em um cartão para levá-lo ao player.
- Todos / Vídeos / Fotos / Áudio a filtram, e a caixa de busca encontra criações por palavras do prompt, modelo, LoRA, tamanho ou seed (⌘F leva até ela).
- Mostrar tudo carrega renderizações mais antigas que as 60 mais recentes.
- ← → percorre a galeria, Space reproduz e pausa, F expande o player para tela cheia.
- Sobre o player, a linha de ações oferece o que fazer em seguida com aquele clipe: Estender, executar Aumentar resolução e Corrigir rosto, enviar Para o filme, Animar uma imagem, ver seus Parâmetros.
- Um clipe sem som leva uma etiqueta Sem som · Adicionar som no cartão da galeria (e o player diz o mesmo). Um clique leva o clipe ao player e abre o Adicionar som do Hailuo H3 com ele selecionado.
- Compartilhar (no menu Mais do clipe e no visualizador em tela cheia) copia uma legenda de uma linha com o link do Phosphene e mostra o arquivo no Finder, pronto para anexar. Nada é enviado.
- O ícone de olho oculta um clipe da galeria (hoje não há como trazê-lo de volta pela interface; veja Vídeo para a restauração manual). O botão de lixeira em um cartão move o arquivo para a Lixeira do macOS depois de perguntar; restaure pelo Finder se mudar de ideia. ⌘⌫ faz o mesmo com a criação selecionada.
Onde ficam os arquivos
Com o Pinokio
| O quê | Onde |
|---|---|
| Suas renderizações | a pasta mlx_outputs dentro da instalação do Phosphene. O botão de pasta no cabeçalho da Galeria a abre no Finder; o item Outputs do Pinokio também a abre. |
| Personagens treinados e LoRAs baixados | mlx_models/loras/ |
| Ajustes | panel_settings.json |
Com o app para Mac
| O quê | Onde |
|---|---|
| Suas renderizações | ~/Library/Application Support/Phosphene/outputs. O botão de pasta no cabeçalho da Galeria ou Studio → Open Outputs Folder a abre |
| Personagens treinados e LoRAs baixados | ~/Library/Application Support/Phosphene/models/loras/ |
| Ajustes | ~/Library/Application Support/Phosphene/state/panel_settings.json |
Toda renderização também grava ao lado dela um pequeno arquivo auxiliar com os ajustes usados. É isso que o Parâmetros lê, e o que permite buscar na Galeria por LoRA ou seed.
A primeira inicialização
Com o Pinokio
O Start aparece quando o ambiente de execução está pronto. Nenhum modelo é baixado antes de o app abrir. A configuração precisa de cerca de 18 GB livres, incluindo 15 GB mantidos livres para o seu trabalho.
Para vídeo, clique em Baixar modelos de vídeo. O padrão é o LTX-2.5 Q4, com cerca de 27.5 GB incluindo o codificador de prompt. Ele dá conta do seu primeiro vídeo a partir de texto ou imagem sem o pacote Q8, maior. As duas partes são baixadas em ordem, com o progresso no painel. Parar download mantém os arquivos parciais; clique no botão de download de novo para retomar.
Você também pode escolher Imagens ou Áudio. Eles têm modelos próprios e não precisam do download de vídeo. O Aprimorar, o planejador do Storyboard e os adaptadores opcionais oferecem um download quando você os usa. Nada mais começa a baixar só porque você abriu o app.
Com o app para Mac
O conjunto básico tem cerca de 28 GB: o motor LTX-2.5, o codificador de texto dele e o decodificador de prévia. Antes de qualquer download, o app mostra cada item e o tamanho, o espaço necessário e o seu espaço livre. Se o studio cabe mas os modelos não, você pode configurar o studio agora e baixar os modelos depois, de dentro dele.
A configuração também pergunta onde os modelos ficam: neste Mac ou em um disco externo. Veja Manter os modelos em um disco externo.
Se o download de modelos do app parar, o studio busca o modelo de vídeo por conta própria, e o seu primeiro clipe é dimensionado para caber no seu Mac. Se a configuração não terminou, o studio mostra um botão Concluir configuração.
O Gemma 3 (no qual rodam o Aprimorar e o planejador do Storyboard) e os adaptadores de Aumentar resolução e Corrigir rosto, Controle, Ingredientes e Colorir são baixados quando um recurso precisa deles pela primeira vez: o recurso avisa e oferece Baixar agora.
Atualizar uma instalação existente não baixa nem remove nada.
Atualizando
Com o Pinokio
- A etiqueta de versão no cabeçalho diz onde você está: Atualizado, ou Atualizar para uma versão mais nova. Quando há uma, um banner oferece Atualizar agora / Depois.
- No Pinokio, o item Update na barra lateral do Phosphene atualiza tudo, incluindo as dependências do Python. A atualização mantém sua fila, ajustes e modelos. Se uma atualização parar, veja Quando uma instalação para.
- Depois de uma atualização dentro do app, o banner diz “Atualizado para …, reinicie para concluir”: clique em Stop e depois em Start no Pinokio. Se a atualização mexeu em dependências, ele manda usar o Update do Pinokio.
- Se uma atualização iniciada a partir de uma versão bem antiga parece só mover o painel, clique em Atualizar mais uma vez: uma versão antiga atualiza primeiro o próprio atualizador.
- Se o Update do Pinokio para no primeiro segundo (pode acontecer na 4.19.6 e anteriores), use Atualizar agora no banner do próprio Phosphene ou na etiqueta de versão e depois reinicie. A partir da 4.19.7, o botão do Pinokio volta a funcionar. Veja a solução de problemas.
Com o app para Mac
- A etiqueta de versão mostra a sua versão e o commit. Clique nela para copiar os detalhes do seu build para um relato de bug.
- As atualizações vêm apenas de Phosphene → Buscar atualizações…. Sua fila, ajustes, modelos e trabalhos prontos são mantidos.
- Para reparar o motor de música, abra Áudio → Compor e clique em Reparar o motor de música. Para baixar ou concluir o Hailuo H3, use Baixar o Hailuo H3 ou Retomar no cartão dele (veja Hailuo H3).
O cartão de agradecimento
Depois da sua quinta renderização concluída, quando você deixa o Phosphene em paz por 30 segundos, um pequeno cartão no canto pede uma estrela no GitHub. Ele nunca cobre o seu clipe e nunca volta depois que você o fecha (o × ou Escape).
- Estrela no GitHub com um clique: se este Mac está conectado ao GitHub pelo comando
gh, Dar estrela no GitHub dá a estrela ao Phosphene ali mesmo e o cartão agradece. O Phosphene só pede aoghque faça isso quando você clica; ele nunca lê nem guarda o seu login do GitHub. - Caso contrário, o botão abre a página do Phosphene no GitHub no seu navegador.
- Se você já deu a estrela (pela estrela no cabeçalho, pelo banner de atualização ou pelo próprio GitHub, como o
ghenxerga), nunca verá o cartão.
Dica Pressione ? em qualquer lugar para abrir esta documentação na página de atalhos, e use a caixa de busca à esquerda para achar qualquer botão pela palavra escrita nele.
Fonte: webapp/docs/getting-started.md no repositório público. Revisado para este site antes da publicação. Traduzido do original em inglês. Sugerir uma edição.