Edição de Áudio Universal
Operações gerais de áudio, exceto remoção de ruído: corte, transcodificação, normalização de volume, extração de faixa, concatenação, fade in/out, alteração de velocidade. Tudo através do script compartilhado skills/shared/scripts/audio_ops.py que encapsula ffmpeg, com parâmetros determinísticos e reproduzíveis, sem comandos manuais.
Entrada
| Campo | Obrigatório | Descrição |
|---|---|---|
| input_file | Sim | Caminho do arquivo de áudio ou vídeo |
| operation | Sim | trim / convert / normalize / extract / concat / fade / speed / denoise / info |
| output_file | Não | Padrão: outputs/nome_do_tópico/{name}-{op}.{ext} |
Formatos suportados: wav / mp3 / m4a / aac / flac; contêineres de vídeo: mp4 / mkv / mov (para extração de faixa).
Saída
- Arquivo de áudio processado (colocado em
outputs/nome_do_tópico/) - A cada operação, imprime o comando ffmpeg real executado + duração/taxa de bits/canais/taxa de amostragem do arquivo de saída
Passos de Execução
Caminho do script (relativo à raiz do projeto): skills/shared/scripts/audio_ops.py. Cada subcomando suporta -h.
0. Verificação de ambiente + sondagem
python skills/shared/scripts/audio_ops.py info input.mp3
O script verifica se ffmpeg/ffprobe estão disponíveis; se não, exibe dicas de instalação. Use info primeiro para exibir duração/taxa de bits/canais antes de prosseguir.
1. Corte (trim)
# Tempo inicial e final
python skills/shared/scripts/audio_ops.py trim in.mp3 -o outputs/nome_do_tópico/clip.mp3 --start 00:00:05 --end 00:00:20
# Início + duração
python skills/shared/scripts/audio_ops.py trim in.mp3 -o clip.mp3 --start 5 --duration 15
2. Transcodificação (convert)
python skills/shared/scripts/audio_ops.py convert in.wav -o out.mp3 --bitrate 192k
python skills/shared/scripts/audio_ops.py convert in.m4a -o out.wav --sample-rate 44100 --channels 2
O formato de saída é determinado pela extensão (mp3/wav/m4a/aac).
3. Normalização de volume (normalize)
python skills/shared/scripts/audio_ops.py normalize in.mp3 -o out.mp3
Padrão: loudnorm para -14 LUFS / -1.5 dBTP (volume comum para redes sociais/podcasts). Pode ser sobrescrito com --i --tp --lra.
4. Extração de faixa (extract)
python skills/shared/scripts/audio_ops.py extract video.mp4 -o audio.m4a
python skills/shared/scripts/audio_ops.py extract video.mp4 -o audio.aac --copy # sem recompressão, mais rápido
5. Concatenação (concat)
python skills/shared/scripts/audio_ops.py concat a.mp3 b.mp3 c.mp3 -o all.mp3
Concatena na ordem dos parâmetros, com recompressão para compatibilidade entre diferentes taxas de amostragem/contêineres.
6. Fade in/out (fade)
python skills/shared/scripts/audio_ops.py fade in.mp3 -o out.mp3 --fade-in 2 --fade-out 3
--fade-out posiciona automaticamente nos N segundos finais.
7. Alteração de velocidade (speed) com preservação de pitch
python skills/shared/scripts/audio_ops.py speed in.mp3 -o out.mp3 --factor 1.5 # 1.5x velocidade
python skills/shared/scripts/audio_ops.py speed in.mp3 -o out.mp3 --factor 0.8 # desacelerar
Baseado em atempo que preserva o pitch. Para fatores fora de 0.5–2.0, faz cascateamento automático.
8. Remoção de ruído (denoise) — fallback; para uso especializado, use audio-denoise
python skills/shared/scripts/audio_ops.py denoise in.wav -o out.wav --tier 2
Limite com audio-denoise
- audio-denoise: Skill dedicada à remoção de ruído, responsável por seleção de tier, download de modelos, relatórios de denoising — use-a quando precisar de remoção de ruído séria.
- audio-editing: Processamento geral de áudio. O subcomando
denoiseé apenas um fallback rápido. Ambos chamam o mesmoaudio_ops.py denoise, com capacidade idêntica, mas propósitos diferentes.
Regras
- Nunca excluir arquivos originais — apenas escrever novos arquivos em
outputs/nome_do_tópico/. - Primeiro info, depois processar — exibir informações do arquivo para evitar erros.
- Entrada de vídeo mexe apenas no áudio — denoise em vídeo faz automaticamente
-c:v copy; extração pura de áudio use extract. - Execução transparente — o script imprime o comando ffmpeg real.
- Funciona sem Profile — processamento de áudio não depende de perfil de usuário.
Sensibilidade a Perfil (Profile)
Com Profile, é possível escolher parâmetros padrão baseados na preferência da plataforma (ex.: loudness para vídeos curtos, taxa de bits alvo); sem Profile, usa padrões universais (-14 LUFS, 192k).