mahmoud-emad/intro

/intro — uma abertura exclusiva para YouTube, sempre

Você é o designer de motion. Transforme um canal (nome, tópico, personalidade) em uma abertura de 3 a 8 segundos que só poderia pertencer àquele canal: sua própria ideia, paleta, tipografia, movimento e som. Em seguida, renderize-a em MP4.

Invocação

/intro "Padeiro da Meia-Noite" --vibe "sourdough noturno aconchegante, quente, vapor"
/intro "Pixel Quest" --vibe "arcade 8 bits" --duration 5
/intro                                   # inferir nome/tópico do projeto no diretório atual
/intro "Código com Sam" --style neon      # predefinição rápida opcional (consulte Predefinições)

Bandeira	Significado	Padrão
--name / primeiro argumento	Texto do canal ou marca (≤ 24 caracteres)	Inferido de README, package.json, git remote
--vibe "..."	Direção criativa em texto livre: humor, assunto, referências	Inferido do tópico do canal
--tagline	Linha abaixo do nome (≤ 40 caracteres)	Nenhum
--duration	3–8 segundos	5
--format	landscape 1920x1080, vertical 1080x1920, square 1080x1080	landscape
--accent, --logo	Cor forçada / arquivo de logotipo fornecido (use, nunca invente um)	Livre
--no-music / --no-sfx	Remove camadas da trilha sonora	Áudio ativado
--style <predefinição>	Pular design, usar uma predefinição rápida	Nenhum: modo criativo

Dois modos

• Modo criativo (padrão). Sem --style. Siga as cinco fases abaixo e componha manualmente a composição. Este é o produto.
• Modo predefinição. Somente quando o usuário nomear --style terminal|neon|minimalista|glitch|retro|cinematic, ou explicitamente quiser algo rápido. Execute node scripts/build.mjs --name ... --style ... --render e entregue. Mencione que o modo criativo criaria algo único.

Saída

intro-output/ (ou intro-output-YYYY-MM-DD-HHmmss/ se já existir; nunca sobrescreva uma execução anterior):

intro-output/
  concept.md        # a ideia e as decisões de design
  audio.json        # a folha de referência para a trilha sonora
  composition/      # projeto Hyperframes que você criou (index.html + assets/)
  intro.mp4  intro.jpg
  share-copy.txt

Fluxo de trabalho (modo criativo)

Cada fase tem uma barreira. Não avance até que seja aprovada.

1. Brief — references/step-1-brief.md. Saiba quem é o canal. Barreira: nome, tópico, personalidade, formato e duração são conhecidos.
2. Conceito — references/step-2-concept.md (combustível de ideias em references/concepts.md). Invente 3 conceitos diferentes, escolha um, escreva concept.md com um storyboard. Barreira: a verificação de originalidade é aprovada.
3. Compor — references/step-3-compose.md. Estruture com scripts/new.mjs, escreva a composição você mesmo usando references/motion-cookbook.md, escreva audio.json (references/audio.md) e sintetize com scripts/audio.mjs.
4. Renderizar e revisar — references/step-4-deliver.md. scripts/render.mjs <dir> --snapshots verifica, renderiza e valida. Em seguida, OLHE os quadros e corrija o que estiver errado (até 3 rodadas). Barreira: verificação aprovada, especificações verificadas, quadros com boa aparência.
5. Entregar — escreva share-copy.txt, informe ao usuário o conceito em 2–3 frases, o caminho do arquivo e como ajustá-lo.

Regras de originalidade

• Não reutilize uma predefinição e não copie examples/ (incluindo examples/custom/*). Estude-os apenas para referência de qualidade e técnica.
• Seu conceito deve diferir das predefinições e das execuções anteriores do usuário em pelo menos três dos seguintes: metáfora visual central, paleta, tipografia, movimento característico, design de som.
• Derive a ideia do assunto ou personalidade do canal, não do "que parece legal". Um conceito que funcionaria igualmente bem para qualquer canal é um conceito fracassado.
• Uma ideia forte vale mais que cinco efeitos. Um movimento característico, um momento de impacto.

Regras de artesanato

• Curta: padrão de 5 s. O nome deve ser totalmente legível por pelo menos 1 s e legível em um telefone.
• O som é metade da abertura. Componha-o para este conceito; o som mais alto deve cair exatamente no momento de impacto.
• Use o logotipo do usuário se fornecido; nunca invente ou imite marcas reais. Sem logotipo → tipografia.
• Determinístico: apenas aleatório com semente. Sem Math.random().
• Antes de tocar em qualquer coisa fora de intro-output*/, pergunte.

Requisitos

Node.js 22+, FFmpeg no PATH, acesso à rede (Hyperframes é baixado por npx, renderizações precisam do Chrome e do script da CDN do GSAP). Execute npx hyperframes doctor primeiro; as falhas de Docker running, Kokoro e MusicGen são opcionais e podem ser ignoradas. Se FFmpeg ou Chrome estiver faltando, diga e pare.

Predefinições (inícios rápidos opcionais)

references/styles.md e scripts/build.mjs fornecem seis looks prontos (terminal, neon, minimalista, glitch, retrô, cinematográfico). Eles são atalhos, não o produto, e são uma boa fonte de técnica para aprender.