MLT Scripting

Automatizar operações do Kdenlive usando scripts MLT/ Melt.

tutorial mlt scripting melt automatizacao avancado

O que você vai aprender

  • Entender a estrutura MLT de projetos Kdenlive: Playlist, Tractor, Filter e Producer
  • Usar o comando melt para reprodução, informação e conversão de arquivos
  • Criar scripts bash para automação de processamento em lote
  • Exportar projetos Kdenlive como XML MLT puro para uso com melt

MLT Scripting🔗

O Kdenlive é construído sobre o framework MLT (Media Lifecycle Toolkit). Isso significa que você pode usar a ferramenta melt para scripting e automação de operações de vídeo.

O Que Você Vai Aprender🔗

  • Entender a estrutura MLT de projetos Kdenlive
  • Usar o comando melt para operações básicas
  • Criar scripts simples para automação
  • Converter entre formatos com melt

Duração: ~25 minutos Pré-requisito: Conforto com linha de comando

Entendendo a Estrutura MLT🔗

Um projeto Kdenlive é basicamente um arquivo XML que descreve uma estrutura MLT:

  • Playlist : contém clipes em sequência
  • Tractor : gerencia múltiplas playlists
  • Filter: efeitos aplicados a clipes
  • Producer : fontes de mídia

O Kdenlive salva projetos como .kdenlive (XML) que pode ser lido pelo melt.

O Comando Melt🔗

melt é a ferramenta de linha de comando do MLT. Vamos ver operações básicas:

Listar Formatos Suportados🔗

melt -h formats
Terminal executando comando melt para processamento de vídeo

Reproduzir um Arquivo🔗

melt /caminho/para/video.mp4

Ver Informações de um Arquivo🔗

melt /caminho/para/video.mp4 -filter info

Scripting Básico: Conversão de Formato🔗

Converter MP4 para MKV🔗

melt input.mp4 -filter avformat vcodec=libx264 acodec=aac output.mkv

Converter com Configurações Específicas🔗

melt input.mp4 -filter avformat vcodec=libx265 crf=23 vb=0 acodec=flac output.mkv

Scripting Intermediário: Criar Compilação🔗

Criar Playlist de Clipes🔗

melt clip1.mp4 out=0 -mix 30 \
      clip2.mp4 out=0 -mix 30 \
      clip3.mp4 out=0 \
      -transition mix -a

Adicionar Fade In/Out🔗

melt clip.mp4 -filter filter=opacity:0.0 \
              -filter filter=opacity:1.0:start=0:end=50

Scripting Avançado: Efeitos Encadeados🔗

Pipeline Completo🔗

melt input.mp4 \
    -filter filter=volume:0=-20db \
    -filter filter=avfilter/lut3d=lut_file.cube \
    -transition mix \
    -consumer avformat:output.mp4 vcodec=libx264 crf=23

Automação com Bash🔗

Crie um script de compilação:

#!/bin/bash
# compilacao.sh - Compila todos os videos de uma pasta

for file in *.mp4; do
    echo "Processando: $file"
    melt "$file" \
        -filter filter=volume:0=-10db \
        -consumer avformat:"compiled_$file" \
        vcodec=libx264 crf=23
done
chmod +x compilacao.sh
./compilacao.sh

Usando Profiles🔗

O melt respeita profiles de vídeo:

# Usar profile 1080p 30fps
melt input.mp4 -profile square_dvb -consumer avformat:output.mp4

Integração com Kdenlive🔗

O Kdenlive pode exportar como XML MLT puro:

  1. Menu → Projeto → Exportar como XML
  2. Escolha “MLT XML” (não “Kdenlive XML”)
  3. Use o XML exportado com melt

Isso permite:

  • Processamento batch em servidores
  • Automação de renderização
  • Workflows de processing mais complexos

Limitações🔗

  • Melt não tem interface gráfica
  • Alguns filtros podem não estar disponíveis
  • Debugging pode ser difícil

Dicas🔗

Verbose Mode🔗

melt input.mp4 -verbose

Mostra informações detalhadas sobre o que está acontecendo.

Listar Filtros🔗

melt -filter help

Lista todos os filtros instalados.

Exercício🔗

Desafio: Crie um script que:

  1. Processa todos os arquivos em uma pasta
  2. Aplica fade in de 1 segundo
  3. Aplica fade out de 1 segundo
  4. Exporta como MP4 com CRF 23

Execute o script e verifique os resultados no Kdenlive.

Erros comuns

  • Não testar com um arquivo primeiro: sempre teste o comando melt em um único arquivo antes de rodar em lote.
  • Caminhos com espaços: use aspas em volta dos paths no script bash.
  • Esquecer o -consumer: sem -consumer, melt apenas reproduz na tela — não gera arquivo de saída.

Você aprendeu

  • Projetos Kdenlive são arquivos XML que descrevem estruturas MLT — legíveis pelo melt
  • melt é a ferramenta de linha de comando para reprodução, conversão e scripting
  • Scripts bash com melt permitem processamento em lote de múltiplos arquivos
  • Exporte como MLT XML (não Kdenlive XML) para compatibilidade com melt

Referências🔗