Reel a partir de vídeo bruto
Comprovado em dois reels: Linux Day 2 e Linux Day 1 (com efeitos sonoros). library/Reel.tsx é o reel do Day 1. Copie seus padrões. Não invente um novo estilo.
Funciona no macOS e no Linux / Windows WSL. Configuração: veja README.md no repositório.
Regras estritas
- Cada sobreposição é temporizada a partir de
work/words.txtem segundos. Nunca adivinhe um tempo. - Use apenas componentes em
src/(biblioteca). Adicione um novo componente somente quando nenhum componente da biblioteca se encaixa em um beat. - Mantenha o rosto visível. Zonas seguras (1080x1920):
- Tags e títulos no topo: y 90 a 400.
- Rosto e pescoço: y aproximadamente 450 a 1350. Nada aqui, exceto cartões de título em tela cheia (máx. 3 s).
- Todo o resto vai abaixo do pescoço (primeiro botão da camisa): y 1360 a 1880. O
Panelcomeça emBELOW_NECK(1360). Usefitpara dimensionar um painel alto para que ele termine por volta de 1880. - Encontre a linha do pescoço para cada novo vídeo: capture um quadro com uma grade y e observe. Atualize
BELOW_NECKemui.tsx.
- Não renderize o vídeo completo a menos que o usuário peça no chat. Use
scripts/stills.shpara verificar. Um hook bloqueiaremotion rendersemRENDER_OK=1. - Não baixe nada (modelos, fontes, músicas, pacotes de som) sem perguntar ao usuário.
- Leia
reference/known-problems.mdantes de depurar qualquer coisa. - No OpenCode, o plugin
~/.config/opencode/plugins/reel-from-rawfaz o mesmo trabalho que os hooks Claude (bloqueio de render, verificação de tipo, lembrete de stills). Abra as imagens da folha com a ferramenta de leitura. Se seu modelo não conseguir ver imagens, peça ao usuário para verificar as folhas.
Regras de escopo (siga exatamente)
- Faça apenas o que o usuário pediu. Altere apenas os arquivos e valores que a solicitação precisa.
- Uma verificação (verificação de tipo, verificação de stills, lembrete de um hook ou plugin) é apenas uma verificação. Corrija apenas o que quebra uma regra neste arquivo ou em
reference/style-spec.md. Nunca reformate, adicione um componente, adicione uma cena, ou altere texto, temporização ou volume por causa de uma verificação. - Se você acha que algo mais deve mudar, diga ao usuário em uma linha. Não mude.
- Nunca edite
~/.claude/skills/reel-from-raw/(este skill) enquanto trabalha em um vídeo. Edite apenas o projeto de vídeo. - Um arquivo de teste que você criar (por exemplo
src/__probe.ts) deve ser deletado antes de terminar.
Fluxo de trabalho (novo vídeo)
Execute cada etapa. Cada script imprime OK: em caso de sucesso. Pare e corrija em qualquer ERROR.
| # | Etapa | Comando / ação |
|---|---|---|
| 1 | Criar projeto | bash ~/.claude/skills/reel-from-raw/scripts/new-project.sh <dir> <raw.mp4> (por exemplo ~/Coding/motion-videos/<name>). Ele copia a biblioteca, os arquivos de som e os hooks, e instala os pacotes npm (ou os clona de $REEL_SEED). |
| 2 | Transcrever | bash ~/.claude/skills/reel-from-raw/scripts/transcribe.sh <dir> hi (use en para inglês apenas). Em seguida, corrija erros de audição com reference/glossary.md. |
| 3 | Cortar silêncios | python3 ~/.claude/skills/reel-from-raw/scripts/cuts.py <dir>. Use --start/--end para descartar um falso início ou final. |
| 4 | Folha de beats | Siga reference/beat-sheet-prompt.md. Escreva work/beats.md. Mostre ao usuário se ele quiser aprovar o plano. |
| 5 | Construir | src/Reel.tsx é o reel do Day 1. Reescreva-o a partir da folha de beats. Em Root.tsx, defina id (por exemplo LinuxDay3) e o handle real. Exclua componentes de cena que o reel não usa. Mantenha os helpers At e r(). |
| 6 | Verificação de tipo | Automática: um hook executa tsc --noEmit após cada edição. Corrija todos os erros que ele reportar. |
| 7 | Verificação visual | bash ~/.claude/skills/reel-from-raw/scripts/stills.sh <dir> auto, depois leia cada out/stills/sheet*.jpg. Também verifique quadros de beat: stills.sh <dir> 120,450,.... Verifique em relação a reference/style-spec.md. Corrija e repita. |
| 8 | Verificação de som | Os efeitos sonoros vêm com os componentes (veja "Efeitos sonoros"). Verifique se public/sfx/typing.wav e public/sfx/pop.wav existem. Não adicione sons fora da tabela a menos que o usuário peça. |
| 9 | Pré-visualização | Adicione uma entrada launch.json executando npx remotion studio --no-open --port <free> no projeto. Dê ao usuário a URL http://localhost:<port>. O usuário ouve os sons lá. |
| 10 | Renderizar (apenas sob solicitação) | RENDER_OK=1 npx remotion render <Id> out/<name>.mp4 --gl=angle (execute em segundo plano, cerca de 3-5 min para 90 s). |
Efeitos sonoros
src/sfx.tsx guarda cada som. SFX lista os sons. <Sfx src at volume frames name> reproduz um som at quadros dentro da Sequência atual.
Chave em SFX | Fonte | Internet necessária |
|---|---|---|
whoosh, ding, click, switch, whip | @remotion/sfx (arquivos em remotion.media) | Sim, para Studio e render |
pop | public/sfx/pop.wav (criado por código) | Não |
typing | public/sfx/typing.wav (criado por scripts/make-typing-sound.py) | Não |
Os componentes da biblioteca já reproduzem esses sons. Você não os adiciona manualmente.
| Momento | Arquivo (no projeto) | Som | Volume |
|---|---|---|---|
| Título do gancho / sub-chip | scenes/Intro.tsx (Hook) | whoosh / whip | 0.54 / 0.48 |
| Cartão de título do dia | scenes/Intro.tsx (DayTitle) | whoosh / ding | 0.6 / 0.36 |
| Chips da lista de comandos | scenes/Intro.tsx (CommandList) | pop por chip | 0.36 |
| Tag de comando / nome do comando | scenes/Commands.tsx (CommandTag) | whoosh / switch | 0.54 / 0.48 |
| Linhas do bloco de notas | scenes/Commands.tsx (NoteCard) | typing por linha | 0.6 |
| Painel inferior aparece | ui.tsx (Panel) | pop | 0.48 |
| Comando do terminal digitado | ui.tsx (Terminal) | typing para cada linha de comando | 0.6 |
| Vazamento de luz | Reel.tsx | whoosh | 0.48 |
| Emblema "Concluído" / Clique em Seguir | scenes/Outro.tsx (DayDone, FollowCard) | ding / click | 0.48 / 0.72 |
Qualquer <Sfx> sem volume | sfx.tsx (padrão) | - | 0.42 |
O volume varia de 0 (silêncio) a 1 (máximo). Mantenha todo som abaixo da voz.
Solicitações comuns (receita exata)
| Usuário pede | Faça exatamente isso |
|---|---|
| "Aumentar / diminuir todos os efeitos sonoros em N%" | Multiplique cada volume={x} em uma linha <Sfx, e o padrão em sfx.tsx, por (1 ± N/100). Arredonde para 2 casas decimais. Não toque em CutVideo.tsx (essa é a voz). Execute grep -rn "<Sfx" src antes e depois, e mostre os valores alterados. |
| "Alterar apenas o volume do som do teclado / digitação" | Altere apenas as linhas com src={SFX.typing} (ui.tsx Terminal e scenes/Commands.tsx NoteCard). |
| "Alterar apenas o som X" | Encontre sua linha na tabela acima. Altere apenas aquele volume. |
| "O som do teclado está fraco / crie um novo" | python3 ~/.claude/skills/reel-from-raw/scripts/make-typing-sound.py <project>/public/sfx/typing.wav. Mantenha uma cópia do arquivo antigo primeiro. Edite os números no script apenas se o usuário pedir uma sensação diferente. |
| "Remover um som" | Exclua aquela linha <Sfx .../>. |
| "Onde posso ouvir antes de renderizar?" | Studio (etapa 9). Pressione play ou Espaço. O Studio recarrega sozinho após cada edição salva. |
| "Como faço para renderizar sozinho?" | Terminal: cd <project> && npx remotion render <Id> out/<name>.mp4 --gl=angle. Interface do Studio: Botão Render (extremidade direita da barra acima da linha do tempo) → guia Vídeo → defina Nome de saída → Renderizar vídeo. O progresso é mostrado na guia Trabalhos. A configuração OpenGL já é angle. |
| "Renderize isso" | Etapa 10, com RENDER_OK=1. Em seguida, forneça o caminho completo do arquivo de saída. |
| "Alterar o handle" | Root.tsx defaultProps.handle. |
Como a temporização funciona
src/timeline.ts:CUTS(segundos brutos removidos),out(sec)mapeia um segundo bruto para um quadro de saída.<At from={rawSec} to={rawSec} name="...">mostra um bloco para aquela duração falada.r(t0, t)fornece um atraso de quadro dentro de um bloco, para "aparecer quando a palavra em t é dita".CutVideoalterna zoom 1.0 / 1.14 por segmento (zoom em cada corte). Não adicione mais zoom.
Mapa da biblioteca
| Arquivo | Exportações | Uso para |
|---|---|---|
theme.ts | DISPLAY (Anton), SANS (Inter), MONO, cores C, extrude() | Todo texto e cor. Sem novas fontes ou cores. |
sfx.tsx | SFX, Sfx | Efeitos sonoros (veja acima) |
ui.tsx | Pop, useIn, useOut, BELOW_NECK, Panel, TermFrame, Terminal | Efeito de pop com mola, painel da metade inferior, terminal digitado |
scenes/Intro.tsx | Hook({title, sub, subAt}), DailyStep({children}), DayTitle({day}), CommandList({commands, line, lineAt}), LightLeak | Abertura, transições de seção |
scenes/Commands.tsx | CommandTag({n, total, name, nameAt, meaning, meaningAt, color}), FolderPath, FileGrid, MoveSwap, NoteCard | Um tópico por seção: tag no topo, visual no Panel |
scenes/Commands.tsx (Day 2, texto codificado) | IdCard, OwnerSwap, PhoneApps, Snapshot, TopView, PdfSearch | Adicione props para o texto antes de reutilizar um |
scenes/Outro.tsx | DayDone({day}), NextDay({day, commands, at}), FollowCard({handle}) | Finalização (NextDay é opcional) |
Reel.tsx | Reel | Reel completo do Day 1. Use como exemplo para estrutura. |
Mantenha tamanhos, cores e animação ao alterar o texto.