Vídeo de Contagem Regressiva
Transforme uma lista ranqueada em um vídeo de lista finalizado no estilo de canais de filmes/listas. Dois modos:
"mode": "countdown"(padrão): NºN → Nº1, um "NºX" laranja com impacto antes de cada entrada."mode": "timeline": um vídeo de "evolução" (ex.: Evolução da Animação LAIKA 2005–2022), do mais antigo ao mais novo, um grande cartão de ano antes de cada entrada.
Em ambos os modos, uma entrada pode incluir um clipe de trailer que toca em tela cheia logo após seu cartão, com um título inferior e o som próprio do trailer (a música é atenuada por baixo). Em canais de listas, o formato cartão + ~25–30 s de trailer por filme é o que mantém a atenção dos espectadores por mais tempo.
O vídeo tem uma introdução, depois para cada entrada um impacto "NºX" seguido de um cartão animado (imagem, título, ano, gênero, estatísticas financeiras com barras, classificações, um fato curioso), um indicador de progresso e uma tela final com espaços para elementos de tela final do YouTube. Tudo é orientado a dados: a pesquisa vai para items.json, o motor renderiza.
Converse com o usuário no idioma de sua preferência; mantenha o código e items.json em inglês, a menos que o usuário queira texto na tela em outro idioma.
Arquivos (relativos a esta pasta da skill)
| Arquivo | Finalidade |
|---|---|
templates/countdown_template.html | O motor: introdução, cartões de posição, cartões de item, indicador, encerramento. Tema e temporização podem ser sobrescritos em items.json. |
scripts/build_countdown.py | items.json → _work/build.html, timeline.json, cues.json (efeitos sonoros), chapters.txt; sinaliza imagens ausentes/ilegíveis. |
scripts/render.py | Renderizador determinístico de intervalos de quadros (Playwright → x264). |
scripts/compose_clips.py | Insere o clipe de trailer de cada entrada em quadro cheio (com letterbox) com um título inferior "TRAILER · Título (Ano)", e extrai o áudio do clipe. Executado automaticamente por make_countdown.sh. |
scripts/countdown_audio.py | Loop de música animada original (ou --music sua_musica.mp3), efeitos sonoros de whoosh/golpe/pop/tique nos momentos indicados, áudio do trailer com música atenuada para --clip-music (padrão 0.12), voz de classificação opcional. |
scripts/make_countdown.sh | Pipeline completo: construção → renderização paralela → áudio → MP4 + folha de QA + capítulos. |
Configuração: pip install playwright soundfile scipy pillow --break-system-packages e playwright install chromium se faltar; ffmpeg no PATH. Voz opcional: Kokoro TTS (veja a skill de Animação PPT voiceover.py).
Fluxo de trabalho
- Briefing. Tópico, modo (contagem regressiva ou linha do tempo), quantas entradas (N), métrica de classificação (ex.: bilheteria mundial), quais campos mostrar, se deve incluir clipes de trailer (e por quanto tempo, padrão 25 s), duração do vídeo (≈ 5 s de intro + N × (~11 s + clipe) + 12 s de encerramento), música (faixa do usuário ou gerada). Pergunte uma vez se o usuário estiver presente; caso contrário, escolha padrões sensatos e informe.
- Pesquise a classificação. Use pesquisa na web e abra as páginas de origem; nunca preencha números de memória. Fontes preferidas: Box Office Mojo / The Numbers (orçamento, bilheteria mundial), IMDb, Rotten Tomatoes, Metacritic (classificações), Wikipedia para anos e gêneros. Registre a(s) URL(s) em
sourcesde cada item. Se duas fontes discordarem, use uma fonte consistentemente para a métrica de classificação e anote. Se um valor não puder ser encontrado, omita o campo (o cartão se adapta) — nunca o invente. - Escreva
items.json(esquema abaixo), classificações 1..N onde 1 é a entrada principal. O vídeo conta de N → 1 ("order": "up"inverte). - Imagens e clipes. Use imagens e arquivos de trailer fornecidos pelo usuário (
posters/<slug>.jpg, 2:3 retrato;clips/<slug>.mp4). Não baixe pôsteres, trailers, imagens fixas ou fotos de pessoas da web; peça ao usuário para colocá-los na pasta. Sem imagem, o cartão mostra um espaço reservado de título limpo, e um clipe ausente é ignorado, permitindo renderizar um rascunho primeiro. Para cada clipe, escolhastart(pule logotipos de estúdio e quadros pretos) eduration. Trailers podem gerar reivindicações Content ID no YouTube; isso é decisão do proprietário do canal, então mencione isso uma vez. - Construção + pré-visualização.
python3 scripts/build_countdown.py items.json _work/e depois tire prints de alguns momentos (intro ~3 s, um cartão de classificação, um cartão de item completo no final, o encerramento) e VERIFIQUE: nada sobreposto, títulos longos cabem, números legíveis a 360p. - Renderização.
bash scripts/make_countdown.sh items.json out.mp4 [chunks] [-- --music track.mp3 --music-vol 0.5 --voice vo_dir]. - QA. Abra
out_sheet.png; verifique números contraitems.json; confirme a duração e que cada classificação aparece uma vez. - Entrega. O MP4, os capítulos (
out_chapters.txt, cole na descrição do YouTube), a lista de fontes e um título/descrição/tags sugeridos. Lembre o usuário de adicionar os elementos de tela final sobre os espaços de encerramento no YouTube Studio.
Esquema items.json
Os valores abaixo são placeholders que mostram a forma, não dados reais.
{
"title": "Top 5 Filmes Stop-Motion de Maior Bilheteria",
"subtitle": "Classificados por bilheteria mundial",
"channel": "Nome do Canal",
"currency": "$",
"order": "down",
"mode": "countdown",
"intro_image": "logo.png",
"outro_title": "Qual é o seu favorito?",
"outro_subtitle": "Diga-nos nos comentários!",
"timing": {"intro": 5, "rank": 1.8, "item": 9, "outro": 12},
"theme": {"bgA": "#8BE36A", "bgB": "#F7E25A", "border": "#F0385C", "money": "#9B59D0", "ratings": "#5BD3F5"},
"items": [
{
"rank": 1, "title": "Chicken Run", "year": 2000, "subtitle": "Família/Comédia",
"image": "posters/chicken-run.jpg",
"stats": [{"label": "Orçamento", "value": 45000000}, {"label": "Bilheteria", "value": 225100000}],
"multiple": "5x seu orçamento",
"ratings": {"imdb": 7.0, "rt": 90, "rt_audience": 75, "metacritic": 80},
"fact": "Uma frase curta e com fonte.",
"teaser": "linha opcional sob o impacto NºX",
"clip": {"file": "clips/chicken-run-trailer.mp4", "start": "0:12", "duration": 25},
"label": "texto opcional para o cartão de impacto em vez de NºX / o ano",
"seconds": 9,
"sources": ["https://www.boxofficemojo.com/title/tt0120630/"]
}
]
}
stats[].valuecomo número → contagem animada + barra de comparação (barras compartilham uma escala por cartão); como string → exibido como está (ex.:"N/A","8.848 m"). Qualquer rótulo funciona, então o mesmo motor serve para contagens regressivas não cinematográficas (prédios mais altos, pessoas mais ricas, carros mais rápidos).- As chaves de
ratingssão opcionais:imdb(0–10, estrela),rt/rt_audience/metacritic(0–100, anel). Chaves ausentes desaparecem; um cartão sem classificações centraliza suas outras caixas. clip.startaceita segundos oum:ss; o clipe é letterboxado para 16:9 e é reproduzido após o cartão. Capítulos e a temporização da tela final levam em conta a duração do clipe automaticamente.intro_image(ex.: logotipo do estúdio fornecido pelo usuário) substitui o selo TOP N / EVOLUÇÃO na introdução.- No modo linha do tempo, as entradas são ordenadas por
year; o selo de classificação no cartão é ocultado e os capítulos exibem "Título (Ano)". multipleé uma pequena pílula de destaque abaixo da caixa de dinheiro; calcule-a a partir dos números com fonte (arredonde para uma casa decimal).- As classificações são exibidas apenas como rótulos de texto — sem logotipos de marcas.
- Qualquer classificação, número ou fato exibido na tela deve vir de uma fonte em
sources.
Notas de estilo
- O tema padrão combina com canais de listas clássicas: cartões alternados com textura de giz verde/amarelo, borda vermelha, impacto "NºX" laranja com raios, caixa de dinheiro roxa, caixa de classificações azul. Substitua qualquer cor em
theme. - Legibilidade a 360p: mantenha títulos curtos (o subtítulo carrega o gênero), mantenha fatos com ≤ 2 linhas, não adicione mais de 4 estatísticas.
- Retenção: ~11 s por entrada; coloque as entradas mais fortes por último; o impacto da classificação + efeitos sonoros de whoosh/golpe resetam a atenção a cada entrada; mantenha a introdução ≤ 5 s.
- Capítulos do YouTube precisam de ≥ 10 s cada, então a introdução é automaticamente incorporada ao capítulo da primeira classificação.