PEREGRINO FÁBRICA DE CRIATIVOS
=============================

INSTALAR NA HOSTINGER
1. Use uma hospedagem que permita publicar arquivos HTML próprios (não apenas o editor visual de sites).
2. No Gerenciador de Arquivos, abra public_html ou uma subpasta do seu domínio.
3. Envie o ZIP e extraia. index.html, app.js, style.css e a pasta vendor precisam ficar juntos no diretório escolhido. Evite substituir um site existente: você pode usar public_html/peregrino.
4. Ative o HTTPS/SSL do domínio e acesse o endereço pelo navegador.
5. Se extrair dentro de uma pasta adicional, mova o conteúdo dela para a pasta de publicação ou use o endereço dessa pasta.
Não precisa instalar Node, PHP, banco de dados, WordPress ou um servidor de vídeo.
Não abra index.html com duplo clique: o renderizador precisa de HTTP local ou HTTPS.

USAR
Escolha a montagem: Hook + Desenvolvimento + CTA; Hook + Frase de aterrissagem + Desenvolvimento + CTA; ou Hook + Desenvolvimento.
A frase de aterrissagem é um trecho de VÍDEO enviado por você, não texto ou voz gerada.
Adicione seus vídeos nas etapas correspondentes. Clique no nome para ver/ouvir o arquivo original.
A prévia do arquivo original não aplica a mixagem; confira o resultado final em Assistir depois da exportação.
Selecione as combinações desejadas, ajuste o volume de cada etapa e escolha a música opcional.
O volume de uma etapa vale para todos os arquivos dela. A música repete até o final e pode ter fade de entrada e saída.
Escolha proporção, resolução, FPS e o enquadramento (barras ou corte central).
Use Gerar lote. Os trechos únicos são preparados uma vez e reaproveitados nas combinações.
Opcionalmente escolha uma pasta de saída em navegadores compatíveis (Chrome/Edge no computador). Caso contrário, baixe cada MP4 pelos resultados.
Cancelar interrompe o trabalho atual; os vídeos concluídos permanecem disponíveis. Para refazer um item, selecione sua combinação e gere novamente.

RESOLUÇÕES
Vertical: HD 720x1280; Full HD 1080x1920; 2K/QHD 1440x2560.
Horizontal: HD 1280x720; Full HD 1920x1080; 2K/QHD 2560x1440.
Quadrado: 720x720, 1080x1080 ou 1440x1440.
Aqui 2K significa QHD/1440p, não DCI 2048x1080.
24, 30 ou 60 FPS. Saída MP4, vídeo H.264 e áudio AAC estéreo a 48 kHz.
Converter um vídeo de 30 para 60 FPS repete quadros; não cria movimento intermediário com IA. Aumentar a resolução não recupera detalhes ausentes.

PROCESSAMENTO E ARQUIVOS
Tudo é executado no dispositivo pelo FFmpeg/WebAssembly. Nenhum vídeo é enviado ao servidor. Os arquivos do renderizador (cerca de 32 MB) vêm da própria hospedagem, sem dependências de CDN.
Esta versão usa processamento por CPU em uma thread para funcionar em hospedagens comuns, sem cabeçalhos especiais. Não promete aceleração por GPU. HD/30 FPS é um bom ponto de partida para um teste no Mac Intel.
2K/60 FPS pode ser lento e consumir muita memória, mesmo em lotes pequenos. Mantenha a página aberta, o computador acordado e conectado à energia. Não há garantia de execução em segundo plano, com a aba fechada ou o computador em repouso.
Limite preventivo de entrada: 800 MB por vídeo e 200 MB por música. Arquivos abaixo desses limites ainda podem exceder a memória disponível; reduza o lote ou a resolução se necessário.
Os resultados são guardados no armazenamento local deste navegador. Não são sincronizados com outros computadores e podem ser removidos ao limpar dados do navegador. Baixe os MP4 para mantê-los.
Ao recarregar a página, os resultados persistem, mas você precisa selecionar novamente os arquivos de origem e as configurações. Uma fila interrompida não retoma automaticamente.
Prefira testar primeiro uma combinação curta. Em dispositivos com pouca memória, reduza resolução/FPS. A compatibilidade real com Safari, versões de macOS e celulares deve ser testada no dispositivo.

LICENÇAS
Veja THIRD-PARTY.txt. O renderizador inclui software de terceiros distribuído com suas licenças e referências de código-fonte.

NOMES AUTOMÁTICOS
Os arquivos recebem [ CTV 01 ] - [ DD.MM ] - [ H1-A1-D1-C1 ].mp4.
A data é a data local do navegador no início do lote. Somente etapas usadas aparecem; A representa aterrissagem. Não há personalização do nome.

MÚSICA POR INTERVALO
Até quatro faixas podem tocar no vídeo inteiro, em uma etapa ou em um intervalo em segundos. Cada faixa tem volume, fade in e fade out próprios. A faixa repete desde o início até terminar seu intervalo. Fades muito longos são limitados a metade do intervalo.
Sobreposições misturam as faixas. Intervalos são cortados na duração final; etapas ausentes e intervalos após o final não tocam.
A duração antes de renderizar é uma estimativa calculada pelos arquivos locais. Confira cada combinação. Na exportação os limites das etapas são recalculados após ajustar os quadros ao FPS escolhido.