@codedimension/video-editor

Video Editor CLI

Uma poderosa ferramenta de linha de comando (CLI) em Node.js para tarefas automatizadas de edição de vídeo, focada principalmente em arquivos .mkv. Ela otimiza fluxos de trabalho comuns como remoção de silêncio, mesclagem em lote e processamento de cursos com saída de alta qualidade.

Principais Recursos

• Remoção Automática de Silêncio: Detecta e remove silêncio (início, fim ou meio) usando filtros do FFmpeg.
• Ordenação Natural: Ordena arquivos de forma inteligente por número (ex: parte2.mkv vem antes de parte10.mkv).
• Saída de Alta Qualidade: A codificação padrão usa libx264 com CRF 18 e preset slow para resultados visualmente sem perdas.
• Processamento em Lote: Orquestra estruturas complexas de pastas para cursos ou grandes coleções.

Pré-requisitos

Esta ferramenta depende do FFmpeg. Você deve ter o FFmpeg instalado e disponível no PATH do seu sistema.

• Ubuntu/Debian: sudo apt install ffmpeg
• macOS: brew install ffmpeg
• Windows: Baixe do site oficial ou use winget install ffmpeg

Instalação Global (Recomendado)

Para instalar e usar o video-editor de qualquer lugar no seu terminal sem precisar baixar o código fonte:

npm install -g @codedimension/video-editor

Após a instalação, você pode rodar o comando video-editor diretamente.

Instalação para Desenvolvimento

Se você deseja rodar a CLI a partir do código fonte:

# Instalar dependências
npm install

# Build do projeto
npm run build

Para usar o comando video-editor localmente durante o desenvolvimento:

• Faça o build da versão mais recente:

  npm run build
  

• Vincule o pacote globalmente:

  npm link
  

As alterações no código fonte serão refletidas após cada npm run build.

Comandos

1. Remover Silêncio de Vídeos (remove-silence-of-videos ou rsov)

O comando de corte mais avançado. Ele remove todas as seções de silêncio de um lote de vídeos, incluindo silêncio no meio de uma gravação.

Argumentos:

• [directory]: O diretório contendo arquivos .mkv (O padrão é o diretório atual).

Opções:

• --start <number>: Tempo de início manual em segundos (substitui a detecção de silêncio).
• --end <number>: Tempo de fim manual em segundos (substitui a detecção de silêncio).

Recursos:

• Remove silêncio no meio por padrão.
• Ignora automaticamente arquivos que contenham [skip] no nome.
• Exporta os arquivos processados para uma subpasta trimmed-videos como .mp4.

Exemplo:

video-editor rsov ./gravacoes_brutas --start 5 --end 120

2. Cortar Silêncio (trim-silence)

Uma versão mais simples que foca em remover o silêncio apenas do início e do fim dos arquivos.

Opções:

• --input <path>: O caminho para um único arquivo .mkv ou um diretório. (Obrigatório)
• --output <path>: O caminho onde o(s) arquivo(s) cortado(s) deve(m) ser salvo(s). (Obrigatório)

Exemplo:

video-editor trim-silence --input gravacao.mkv --output ./cortados/

3. Mesclar Vídeos (merge-videos)

Mescla múltiplos arquivos .mkv em um único arquivo .mp4 de alta qualidade.

Opções:

• --videosDir <path>: O diretório contendo os arquivos de vídeo .mkv. (Obrigatório)
• --outputFile <path>: O caminho exato e nome do arquivo para o .mp4 resultante. (Obrigatório)

Recursos:

• Corte Automático: Detecta e remove silêncio nas extremidades de cada clipe antes de mesclar.
• Ordem Natural: Mescla os arquivos em ordem numérica/natural.
• Alta Qualidade: Usa CRF 18 e preset slow para a exportação final.

Exemplo:

video-editor merge-videos --videosDir ./partes/ --outputFile final.mp4

4. Processar Curso (process-course)

Orquestra um fluxo completo de edição de curso através de uma estrutura de diretórios definida.

Estrutura de Entrada:

/MeuCurso
  /nao-editado
    /Modulo-1
      /Aula-A
        - 1_intro.mkv
        - 2_demo.mkv
        - materiais.pdf

Estrutura de Saída (pasta /editado):

/MeuCurso
  /editado
    /Modulo-1
      /Aula-A
        - Aula-A.mp4 (Mesclado e cortado)
        - materiais.pdf (Copiado automaticamente)

Opções:

• <coursePath>: Caminho para a pasta raiz do curso. (Obrigatório)
• --skip-existing: Pula aulas que já possuem um arquivo .mp4 de saída.

Exemplo:

video-editor process-course /caminho/para/MeuCurso --skip-existing

Detalhes Técnicos

• Detecção de Silêncio: Limite definido em -30dB por pelo menos 0.5s.
• Configurações de Codificação:
  • Vídeo: libx264, pix_fmt yuv420p
  • Áudio: aac
  • Qualidade: CRF 18, Preset: slow (otimizado para alta qualidade e tamanho de arquivo razoável).

Solução de Problemas

• FFmpeg não encontrado: Certifique-se de que o comando ffmpeg -version funciona no seu terminal.
• Nenhum silêncio detectado: Se o ruído de fundo for superior a -30dB, a ferramenta pode não detectar o silêncio corretamente.