Documentação completa sobre MLT XML Framework e Shotcut para criação de vídeos automatizados.
docs/
├── README.md (este arquivo)
├── mlt-xml.md (documentação principal MLT XML)
└── research_tasks/ (guias de pesquisa para expandir docs)
├── README.txt (guia completo de uso dos research tasks)
├── 01-09_*.txt (9 tópicos de pesquisa detalhados)
└── RESPOSTAS/ (diretório para resultados de pesquisas)
Arquivo: docs/mlt-xml.md (54 KB)
Guia completo do MLT XML Framework focado no Shotcut:
- Fundamentos do Framework MLT
- Profile (configurações de vídeo)
- Producer e Chain (fontes de mídia)
- Playlist (organização sequencial)
- Tractor e Multitrack (composição multi-faixa)
- Transitions (transições entre faixas)
- Filters (efeitos de vídeo e áudio)
- Exemplos Completos Funcionais
- Referência Rápida de Filtros
- Referência Rápida de Transitions
- Propriedades Shotcut-Específicas
- Troubleshooting e Edge Cases
- Problemas Comuns e Soluções ⭐
- Recursos e Referências Online
- Conclusão
- ✅ Sintaxe XML completa e funcional
- ✅ Exemplos práticos testados
- ✅ Troubleshooting de problemas reais
- ✅ Otimizações para YouTube (1080p 30fps)
- ✅ Solução do problema "INVALIDE" (texto como filtro)
- ✅ Animação de texto com flutuação suave
- ✅ Correção de posicionamento para textos longos
- ❌→✅ Erro "INVALIDE" com producers de texto
- ❌→✅ Texto saindo da tela (upscaling incorreto)
- ❌→✅ Layers transparentes bloqueando vídeo
- ❌→✅ Otimização para YouTube
- ❌→✅ Problemas com transitions
Diretório: docs/research_tasks/ (9 arquivos, ~91 KB)
Guias estruturados para expandir a documentação com recursos avançados.
- Filtros:
frei0r.select0r,frei0r.keyspillm0pup - Composição de foreground + background
- Troubleshooting: edge bleeding, color spill
- Filtros:
timewarp,speed,reverse,freeze - Slow-mo, fast-mo, reverse, speed ramping
- Cálculo de duração e frame interpolation
- Filtros:
avfilter.lut3d,frei0r.curves,lift_gamma_gain - Arquivos .cube cinematográficos
- Looks populares: Teal & Orange, Vintage, Nordic
- Transition:
frei0r.cairoblend - Lista completa: Multiply, Screen, Overlay, Color, etc.
- Tabela com todos os modos + valores numéricos
- Transition:
affinecom múltiplos rects - 2-way, 4-way (quad), 6-way layouts
- Multi-camera sync e audio mixing
- Filtros:
ladspa.sc4ou keyframes manuais - Sidechain compression para narração
- Envelope de volume automático
- Filtros:
frei0r.alphaspot,frei0r.alpha0ps - Shape masks (círculo, retângulo)
- Máscaras PNG externas e animadas
- Transition:
lumacom mapas .pgm - Lista completa: barn door, clock, iris, burst, spiral
- Como criar custom luma maps
- Filtros:
audiolevelgraph,audiospectrum - Waveform, spectrum analyzer, VU meters
- Super relevante para o projeto lofi! 🎵
Cada arquivo de pesquisa contém:
================================================================================
TÓPICO DE PESQUISA: [NOME]
================================================================================
📋 CONTEXTO - O QUE JÁ SABEMOS
🎯 OBJETIVO - O QUE PRECISA SER ADICIONADO
📍 LOCALIZAÇÃO NO ARQUIVO (linha exata no mlt-xml.md)
🔍 REQUISITOS ESPECÍFICOS DA PESQUISA
🚫 NEGATIVE PROMPT - O QUE NÃO QUEREMOS ⚠️ CRÍTICO
📐 FORMATO ESPERADO DA RESPOSTA (markdown pronto)
✅ CRITÉRIOS DE VALIDAÇÃO (checklist)
📚 FONTES SUGERIDAS
🎬 PRIORIDADE: [ALTA/MÉDIA/BAIXA]
- Leia
research_tasks/README.txtprimeiro - Escolha um tópico (sugestão: começar pelo #04 - mais fácil)
- Pesquise usando deep research seguindo as especificações
- Retorne com markdown pronto no formato especificado
- Salve em
research_tasks/RESPOSTAS/0X_nome_RESPOSTA.md - Integre ao
mlt-xml.mdna localização especificada
1º → 04_blend_modes (tabela simples, doc existe)
2º → 05_split_screen (usa recursos conhecidos)
3º → 09_audio_visualization (relevante para lofi!) ⭐
4º → 02_time_remapping (popular)
5º → 03_luts_color_grading (profissional)
6º → 08_transicoes_luma (criativo)
7º → 01_chroma_key (compositing avançado)
8º → 07_mascaras (máscaras e alpha)
9º → 06_audio_ducking (pode ser complexo)
- ✅ Fundamentos completos
- ✅ Exemplos funcionais
- ✅ Troubleshooting documentado
- ✅ Otimizado para YouTube
- ⏳ Recursos avançados pendentes (9 tópicos)
[ ] 01_chroma_key_green_screen.txt
[ ] 02_time_remapping_slow_motion.txt
[ ] 03_luts_color_grading.txt
[ ] 04_blend_modes_complete.txt
[ ] 05_split_screen_layouts.txt
[ ] 06_audio_ducking.txt
[ ] 07_mascaras_rotoscopia.txt
[ ] 08_transicoes_criativas_luma.txt
[ ] 09_audio_visualization.txt
Total: 0/9 completados
Este projeto nasceu da necessidade de criar vídeos lofi automatizados:
- 27 músicas sequenciais
- 6 vídeos em loop
- Texto animado (nome da música)
- Export otimizado para YouTube
- ✅ Texto como filtro (não producer) evita erro "INVALIDE"
- ✅ Geometria com largura total + halign resolve textos longos
- ✅ 720p nativo melhor que 1080p upscaled (Mac M1)
- ✅ libx264 software encoder > hardware encoder (Mac M1)
- ✅ CRF 18 + preset slow = qualidade visualmente lossless
- MLT Framework 7.x
- Shotcut (video editor)
- Python (geração automatizada de XML)
- FFmpeg/libx264 (encoding)
⚠️ Sempre ler o NEGATIVE PROMPT nos research tasks⚠️ Focar em sintaxe XML (não tutoriais de GUI)⚠️ Exemplos devem ser completos e funcionais⚠️ Usar resolução 1920x1080 30fps (padrão YouTube)
- Profile: HD 1080p 30fps colorspace 709
- Frame rate: 30fps (YouTube otimizado)
- Texto: qtext filter aplicado em entries
- Export: H.264 High Profile, CRF 18, preset slow
Criado em: 2026-01-13 Última atualização: 2026-01-13 Projeto: LoFi Video Editor (MLT/Shotcut Automation) Objetivo: Documentação completa de básico → profissional
Para adicionar novos tópicos de pesquisa:
- Seguir formato dos arquivos 01-09
- Incluir todas as seções (contexto, objetivo, negative prompt, etc)
- Especificar localização exata no mlt-xml.md
- Fornecer template markdown de resposta esperada
- Adicionar ao README.txt em research_tasks/
Boa documentação = Resultados consistentes! 📖✨