Montar reels
Sistema de edição em {{REPO}}. Todos os comandos são executados a partir de {{REPO}}\scripts com o Python do
ambiente: {{REPO}}\.venv\Scripts\python.exe. Os caminhos (trabalho, CapCut, fontes, cores) vêm de
{{REPO}}\config.json; não escreva caminhos manualmente nos scripts.
Antes de editar NADA
- Leia
{{REPO}}\mi-estilo\estilo.md(o que o usuário quer) e, se existirem,mi-estilo\aprendido.md(o que foi aprendido de seus reels) emi-estilo\referencias.md(o que foi aprendido de sua conta fantasma). Eles têm precedência sobre as regras padrão abaixo. Se houver conflito entre eles, prevaleceestilo.md. - Se
estilo.mdestiver vazio e for a primeira vez, ofereça preenchê-lo com 5-6 perguntas curtas (tema, duração, legendas, cor, música). Não bloqueie: se não quiser, use os valores padrão.
Como se trabalha (não negociável)
- Um de cada vez e com seu OK. Apresente uma peça, aguarde sua exportação ou "próximo", corrija e só então passe para a seguinte. Nunca despache várias de uma vez.
- Cada peça pede seus recursos. A linguagem é comum (cores, tipografia, legendas); os recursos (rótulos, B-roll, zooms, palavra por trás) são decididos por frase. Não repita o mesmo truque em duas peças seguidas.
- Reaproveite o que já agradou. Se uma peça estava boa, deixe-a igual e retoque apenas o repetido ou o quebrado.
- Falha de design que você veja, avise. Não considere nada pronto sem ver a exportação.
Processo (uma tomada)
| Passo | Comando | O que deixa |
|---|---|---|
| 1. Limpar | python limpiar.py <toma.mp4> | <toma>-limpia.mp4 |
| 2. Transcrever | python transcribir.py <toma>-limpia.mp4 | trabajo/transcripciones/tx (medium) e tx2 (turbo) |
| 3. Cortar | python cortes.py <toma>-limpia.mp4 | trabajo/<toma>-limpia/CORTE.mp4, CORTE.txt, tramos.json |
| 4. Revisão do corte | o usuário vê CORTE.mp4 (traz o segundo ORIGINAL em um canto) | |
| 5. Corrigir | python cortes.py <toma>-limpia.mp4 --fora "17-45.5,53-58.6" | novo corte |
| 6a. Final sem CapCut | python subtitular.py <toma>-limpia.mp4 --chave "palavra1,palavra2" | FINAL.mp4 |
| 6b. Projeto CapCut | python montar_reel.py spec.json | projeto editável no CapCut |
| 7. Música | python anadir_musica.py <projeto> <musica.mp3> <vol> <desde_s> | faixa de música sob a voz |
| 8. Exportar | o usuário faz no CapCut (não pode ser automatizado) | |
| 9. Revisar | python revisar_volumen.py <final.mp4> | volume e <final>-hoja.jpg com a zona segura |
| 10. Capas | a partir de um fotograma real (veja abaixo) |
- No passo 3, leia
CORTE.txt: lista possíveis repetições (frases ditas duas vezes). Proponha remover a primeira versão com--fora, mas deixe o usuário decidir vendo o vídeo. - Com roteiro é muito melhor. Antes de cortar, pergunte se ele tem o roteiro. Se existir
<toma>.guion.txtao lado do vídeo (uma frase por linha; se usar um painel de conteúdo, pode baixá-lo de lá),CORTE.txttraz "CONTRA O ROTEIRO": as linhas ditas várias vezes (proponha ficar com a última tomada), as frases que fogem do roteiro (possíveis sobras ou arranques falhados) e as linhas que não foram ditas. Proponha, não aplique sozinho. - Além disso, leia você mesmo. As listas de
cortes.pysó veem repetições quase literais (medido em 4 tomadas reais: encontra 27% do que o usuário removeu manualmente). Após executá-lo, leia você a transcrição medium palavra por palavra com seus segundos (<transcripciones>/tx/<toma>.json, e o roteiro se houver) e marque os intervalos que sobram para ficar com UMA passagem limpa de cada ideia, normalmente a ÚLTIMA vez que a diz por inteiro: arranques falhados, frases repetidas mesmo que com outras palavras, "me enrolei". Nunca remova algo que só é dito uma vez. Medido com as mesmas 4 tomadas, ler assim encontrou 83% do removido manualmente, mas também propôs remover algo bom (21 s de 135 s que ficavam): por isso SEMPRE é apresentado como proposta no vídeo de revisão, com--fora, e o usuário decide. - "Remova de X a Y" usa sempre segundos do ORIGINAL (os que se veem no canto do CORTE), não do vídeo cortado.
- Veja você a folha de fotogramas (
Readsobre o.jpg) antes de dizer que está bom: nada importante acima da linha vermelha superior (y 288), abaixo da linha inferior (y 1267) nem à direita da linha amarela (x 930). - Para o spec de
montar_reel.py, o molde é{{REPO}}\exemplos\spec_exemplo.py(um reel real com todos os recursos e os estilos ORGANICO / ANUNCIO). Chaves mínimas:nome,video,fim,palavras,palavras_subt,tramos(oufora) epecas_dir. - Para retocar um projeto CapCut já montado sem refazê-lo:
anadir_musica.py,anadir_sonido.py,cambiar_clip.py,podar_sonido.py.
Regras padrão (medidas em uma série real de 10 reels)
- Corte: conserva-se desde 0,10 s antes da primeira palavra até 0,18 s depois da última; dois trechos são unidos
se o buraco for menor que 0,55 s. Se existir
mi-estilo/aprendido.json,cortes.pyusa seus valores. - Áudio: highpass 80 Hz + eq suave em 3,2 kHz + loudnorm em duas passadas (-15 LUFS, pico -2). Sem compressor nem redutor de ruído: eles aumentam o ruído de fundo.
- Legendas: MAIÚSCULAS, branco com borda preta, palavra-chave na cor
cor_chavedo config, blocos de 1 a 3 palavras e no máximo 14 letras. - Rótulos: PNG 1080x1920, branco + palavra na cor chave, sombra dura, a 88% (para respirar).
- Rótulo e legenda nunca se sobrepõem. Em orgânico a legenda desce (
leg_y_baixo-0,37); em anúncio o rótulo sobe e a legenda desce para -0,255 (sem ultrapassar y 1267). Se a camada ocupar a parte inferior, a legenda é ocultada. - Hierarquia (linha pequena + palavra-chave grande) em dois textos separados: se tamanhos forem misturados em um, o CapCut os desalinha.
- Multicâmera falso: trechos alternados a 130% e zooms a 138% nas frases fortes.
- Zona segura de anúncio do Instagram: útil y 288-1267, botões à direita a partir de x 930. Orgânico: 250 / 420. Os cartões pequenos de B-roll vão à esquerda, na altura dos olhos (escala 0,22, x -0,60, y 0,30): à direita tapam o rosto ou caem sob os botões.
- Poucos efeitos sonoros e com motivo (batida no rótulo, tique nas listas). Mais de uma dúzia em um reel é demais. Nenhum efeito pode ultrapassar o final do vídeo.
- Música livre para promover: Pixabay ou Mixkit. Volume 0,06-0,07 com Pixabay e 0,13-0,14 com Mixkit (as do Pixabay soam cerca de 7 dB mais alto). Nada de hinos nem músicas famosas: o Meta bloqueia o anúncio.
- B-roll apenas do Pexels (
ferramentas/pexels_buscar.mjs, precisa dePEXELS_API_KEYem{{REPO}}\.env). Música e efeitos do Mixkit ou Pixabay. Nunca use material de outras contas no vídeo final.
Armadilhas conhecidas
- CapCut aberto sobrescreve as alterações: seu autossalvamento sobrescreve o que
montar_reel.pyescreve. Peça ao usuário que feche o CapCut ANTES de montar, e que o reinicie para ver o projeto novo (não vê projetos novos a quente). - Exportar do CapCut é manual: não pode ser automatizado. Se o usuário não quiser CapCut, use
subtitular.py. - Nada importante atrás da cabeça: ela tapa. Coloque na frente, na altura do peito e grande.
- Se a pasta do projeto destino existir, o VectCutAPI a apaga: use sempre um nome novo (
-v2,-v3). - Para limpar projetos do CapCut: mova, não apague, e apenas com o CapCut fechado.
- Os botões do CapCut não são acessíveis à automação. Não faça cliques cegos: peça ao usuário que abra ele o projeto.
- Na revisão da exportação, meça onde o texto cai em pixels: uma captura a meio da animação engana.
- O final da tomada, quando a mão vai para o celular ou teleprompter, não é detectado bem: revise a olho e corte com
--fim. - As muletas não se removem sozinhas. As legendas podem ter erros de transcrição: leia-as antes de entregar.
- A primeira transcrição baixa os modelos do Whisper (vários GB): avise que demora.
Capas
- O fotograma real inteiro, iluminado e com seu fundo. Nunca a pessoa recortada e colada sobre outro fundo nem fundos escuros.
- A frase-chave em caixa colorida com letra da cor da marca, uma linha branca acima e, se for o caso, uma etiqueta pequena.
- O bloco de texto abaixo do queixo e inteiro dentro do recorte 3:4 da grade do perfil (y 240-1680).
- Faça-as com Pillow e
rotulos_lib.py(fontes e cores deconfig.json). Se usar IA para melhorar o gesto, entregam-se as duas versões e a versão com IA leva a etiqueta "Feito com IA" do Meta.
Personalização
A. Seu estilo escrito: mi-estilo/estilo.md
Modelo para o usuário dizer como quer seus reels. Toda vez que o usuário corrigir algo ("não corte tão
junto", "a chave sempre em vermelho", "mais rápido"), adicione em "Correções aprendidas" de estilo.md com a data,
e aplique a partir desse momento. Se a correção for um número (margem, intervalo, tamanho, cor), mude também em
aprendido.json ou em config.json.
B. Aprender de seus reels
Quando disser "aprenda de meus reels" ou "aprenda como edito":
- Peça que copie para
mi-estilo/mis-reels/entre 3 e 10 reels seus já publicados (os.mp4exportados). python analizar_reels.py mis-reels->mi-estilo/mis-reels.json(duração, segundos por plano, palavras por segundo, volume, gancho dos 3 primeiros segundos, fechamento) e uma folha de fotogramas por vídeo.- Veja as folhas (
Readde cada*-hoja.jpg): tamanho, posição e cor das legendas, se usa rótulos, B-roll, zooms, enquadramento. - Se tiver projetos do CapCut onde corrigiu manualmente um corte automático, compare-os:
python aprender_corte.py <toma-limpia.mp4> <projeto_capcut> [...]->mi-estilo/aprendido.json(margem antes e depois de cada corte e intervalos que não corta).cortes.pyo usa automaticamente. - Escreva
mi-estilo/aprendido.md: o medido (com os números) e o visto nas folhas, em regras concretas ("legendas a meia altura, 2 palavras, amarelo"). Não invente: se algo não se vê, não coloque. - Mostre o resumo e pergunte se ele se reconhece. O que ele disser que não, remova.
C. Conta fantasma (reels de referência)
Quando disser "analise esta conta", "conta fantasma" ou "quero editar como este":
- Peça para colar os links dos reels em
mi-estilo/referencias.txt(um por linha). python referencias.py: baixa-os com yt-dlp parami-estilo/referencias/e executa a análise (mi-estilo/referencias.json+ folhas).- Veja as folhas e escreva
mi-estilo/referencias.md: o que essa conta faz (ritmo, gancho, legendas, rótulos, fechamento) e o que disso conflita comestilo.md, para o usuário escolher. - As referências são um mapa, não um modelo: copia-se a estrutura (ritmo, tipo de gancho), nunca o texto, a música nem as imagens de outra conta.
Regras da conta fantasma:
- Os vídeos baixados são apenas para analisá-los neste computador. Não são enviados, não são republicados e não saem de
mi-estilo/referencias/(está fora do git). - Nunca faça login no Instagram nem peça a senha do usuário. Se um link pedir login, pule.