FFmpeg
Resumen
FFmpeg es la navaja suiza del procesamiento multimedia. Maneja prácticamente todos los formatos de audio y video, códecs y contenedores existentes. Esta habilidad cubre conversión de formatos, transcodificación de códecs, recorte, concatenación, filtrado, compresión, extracción de miniaturas, incrustación de subtítulos, normalización de audio, creación de GIF, marcas de agua e integración en tuberías con herramientas como yt-dlp y gallery-dl.
Instrucciones
Paso 1: Instalación
# Ubuntu/Debian
sudo apt install -y ffmpeg
# macOS
brew install ffmpeg
# Verificar
ffmpeg -version
ffprobe -version # herramienta de información multimedia, incluida con ffmpeg
Paso 2: Conversión de formato
La tarea más común: convertir entre formatos de contenedor y códecs.
# WebM → MP4 (re-codificar a H.264 + AAC para compatibilidad universal)
ffmpeg -i input.webm -c:v libx264 -c:a aac -movflags +faststart output.mp4
# WebM → MP4 (copiar flujos si ya son H.264/AAC — instantáneo, sin pérdida de calidad)
ffmpeg -i input.webm -c copy output.mp4
# MKV → MP4 (copia de flujo, sin re-codificación)
ffmpeg -i input.mkv -c copy output.mp4
# AVI → MP4
ffmpeg -i input.avi -c:v libx264 -crf 23 -c:a aac -b:a 128k output.mp4
# MOV → MP4 (Apple ProRes a H.264)
ffmpeg -i input.mov -c:v libx264 -crf 18 -preset slow -c:a aac output.mp4
# Cualquier formato → MP4 con inicio rápido optimizado para web
ffmpeg -i input.* -c:v libx264 -crf 23 -preset medium -c:a aac -movflags +faststart output.mp4
CRF (Factor de Tasa Constante): Controla la calidad. Menor = mejor calidad, archivo más grande.
- 18: Sin pérdida visual
- 23: Valor predeterminado, buen equilibrio
- 28: Archivo más pequeño, algo de pérdida de calidad
- 51: Peor calidad
Paso 3: Operaciones de audio
# Extraer audio de un video
ffmpeg -i video.mp4 -vn -c:a copy audio.aac # Copiar códec (rápido)
ffmpeg -i video.mp4 -vn -c:a libmp3lame -q:a 2 audio.mp3 # Convertir a MP3
ffmpeg -i video.mp4 -vn -c:a flac audio.flac # FLAC sin pérdida
# Convertir entre formatos de audio
ffmpeg -i input.wav -c:a libmp3lame -b:a 320k output.mp3
ffmpeg -i input.mp3 -c:a libopus -b:a 128k output.opus
ffmpeg -i input.flac -c:a aac -b:a 256k output.m4a
# Normalizar volumen de audio
ffmpeg -i input.mp3 -af loudnorm=I=-16:LRA=11:TP=-1.5 output.mp3
# Cambiar frecuencia de muestreo
ffmpeg -i input.wav -ar 44100 output.wav
# Fusionar audio en video
ffmpeg -i video.mp4 -i audio.mp3 -c:v copy -c:a aac -map 0:v:0 -map 1:a:0 output.mp4
Paso 4: Recortar, cortar y concatenar
# Recortar desde una marca de tiempo hasta una duración
ffmpeg -i input.mp4 -ss 00:01:30 -t 00:00:45 -c copy clip.mp4 # 45s comenzando en 1:30
# Recortar desde una marca de inicio hasta una de fin
ffmpeg -i input.mp4 -ss 00:05:00 -to 00:10:00 -c copy clip.mp4 # 5:00 a 10:00
# Primeros 30 segundos
ffmpeg -i input.mp4 -t 30 -c copy first30.mp4
# Concatenar archivos (crear lista de archivos primero)
cat > filelist.txt << 'EOF'
file 'clip1.mp4'
file 'clip2.mp4'
file 'clip3.mp4'
EOF
ffmpeg -f concat -safe 0 -i filelist.txt -c copy output.mp4
# Concatenar con re-codificación (cuando los códecs difieren)
ffmpeg -f concat -safe 0 -i filelist.txt -c:v libx264 -c:a aac output.mp4
Paso 5: Resolución y compresión
# Redimensionar a 1080p (mantener relación de aspecto)
ffmpeg -i input.mp4 -vf "scale=-2:1080" -c:v libx264 -crf 23 -c:a copy output.mp4
# Redimensionar a 720p
ffmpeg -i input.mp4 -vf "scale=-2:720" -c:v libx264 -crf 23 -c:a copy output.mp4
# Redimensionar a un ancho específico (altura automática)
ffmpeg -i input.mp4 -vf "scale=1280:-2" output.mp4
# Comprimir de forma agresiva (archivo más pequeño)
ffmpeg -i input.mp4 -c:v libx264 -crf 28 -preset faster -c:a aac -b:a 96k small.mp4
# Codificación de dos pasadas para un tamaño de archivo objetivo
ffmpeg -i input.mp4 -c:v libx264 -b:v 1M -pass 1 -an -f null /dev/null
ffmpeg -i input.mp4 -c:v libx264 -b:v 1M -pass 2 -c:a aac -b:a 128k output.mp4
# Cambiar velocidad de fotogramas
ffmpeg -i input.mp4 -r 30 output.mp4
Paso 6: Miniaturas y capturas de pantalla
# Una sola captura en una marca de tiempo
ffmpeg -i input.mp4 -ss 00:01:30 -frames:v 1 thumb.jpg
# Captura cada 10 segundos
ffmpeg -i input.mp4 -vf "fps=1/10" thumbs/frame_%04d.jpg
# Cuadrícula de miniaturas (hoja de contactos 4x4)
ffmpeg -i input.mp4 -vf "select='not(mod(n,300))',scale=320:-1,tile=4x4" -frames:v 1 grid.jpg
# Extraer primer fotograma
ffmpeg -i input.mp4 -frames:v 1 first_frame.png
Paso 7: Subtítulos
# Quemar subtítulos en el video (incrustados)
ffmpeg -i input.mp4 -vf "subtitles=subs.srt" output.mp4
# Quemar subtítulos ASS/SSA con estilo
ffmpeg -i input.mp4 -vf "ass=subs.ass" output.mp4
# Agregar pista de subtítulos (subtítulos blandos, el usuario puede activarlos)
ffmpeg -i input.mp4 -i subs.srt -c copy -c:s mov_text output.mp4
# Extraer subtítulos del video
ffmpeg -i input.mkv -map 0:s:0 subs.srt
Paso 8: Filtros y efectos
# Crear GIF a partir de un segmento de video
ffmpeg -i input.mp4 -ss 5 -t 3 -vf "fps=15,scale=480:-1:flags=lanczos" output.gif
# GIF de alta calidad con paleta
ffmpeg -i input.mp4 -ss 5 -t 3 -vf "fps=15,scale=480:-1:flags=lanczos,palettegen" palette.png
ffmpeg -i input.mp4 -i palette.png -ss 5 -t 3 -lavfi "fps=15,scale=480:-1:flags=lanczos[v];[v][1:v]paletteuse" output.gif
# Agregar marca de agua
ffmpeg -i input.mp4 -i watermark.png -filter_complex "overlay=W-w-10:H-h-10" output.mp4
# Acelerar / ralentizar
ffmpeg -i input.mp4 -filter_complex "[0:v]setpts=0.5*PTS[v];[0:a]atempo=2.0[a]" -map "[v]" -map "[a]" fast.mp4
ffmpeg -i input.mp4 -filter_complex "[0:v]setpts=2.0*PTS[v];[0:a]atempo=0.5[a]" -map "[v]" -map "[a]" slow.mp4
# Rotar video
ffmpeg -i input.mp4 -vf "transpose=1" rotated.mp4 # 90° en sentido horario
ffmpeg -i input.mp4 -vf "transpose=2" rotated.mp4 # 90° en sentido antihorario
# Recortar video (ancho:alto:x:y)
ffmpeg -i input.mp4 -vf "crop=1280:720:0:180" cropped.mp4
# Fundido de entrada/salida
ffmpeg -i input.mp4 -vf "fade=in:0:30,fade=out:870:30" -af "afade=in:0:30,afade=out:870:30" output.mp4
Paso 9: Información multimedia
# Información completa del medio
ffprobe -v quiet -print_format json -show_format -show_streams input.mp4
# Solo duración
ffprobe -v quiet -show_entries format=duration -of csv=p=0 input.mp4
# Resolución
ffprobe -v quiet -select_streams v:0 -show_entries stream=width,height -of csv=p=0 input.mp4
# Información del códec
ffprobe -v quiet -select_streams v:0 -show_entries stream=codec_name -of csv=p=0 input.mp4
Paso 10: Procesamiento por lotes
# Convertir todos los archivos WebM a MP4
for f in *.webm; do
ffmpeg -i "$f" -c:v libx264 -crf 23 -c:a aac "${f%.webm}.mp4"
done
# Comprimir todos los archivos MP4 en el directorio
for f in *.mp4; do
ffmpeg -i "$f" -c:v libx264 -crf 28 -preset fast -c:a aac "compressed_${f}"
done
# Extraer audio de todos los videos
for f in *.mp4; do
ffmpeg -i "$f" -vn -c:a libmp3lame -q:a 2 "${f%.mp4}.mp3"
done
Ejemplos
Ejemplo 1: Convertir descargas de yt-dlp de WebM a MP4
Solicitud del usuario: "Descargué videos con yt-dlp pero todos son archivos .webm. Conviértelos a MP4 para que se reproduzcan en mi iPhone."
El agente:
- Verificará si los archivos WebM contienen H.264+AAC (posible copia de flujo) o VP9+Opus (necesita re-codificación) usando
ffprobe. - Para archivos VP9/Opus, ejecutará:
for f in *.webm; do ffmpeg -i "$f" -c:v libx264 -crf 23 -preset medium -c:a aac -movflags +faststart "${f%.webm}.mp4"; done - La bandera
-movflags +faststartmueve los metadatos al inicio del archivo, permitiendo la reproducción instantánea en dispositivos móviles y navegadores web. - Reportará los resultados de la conversión con los tamaños de archivo antes y después.
Ejemplo 2: Crear un reel de highlights a partir de múltiples clips
Solicitud del usuario: "Tengo 5 clips de video de una conferencia. Recorta las mejores partes y únelas en un solo video con transiciones de fundido."
El agente:
- Recortará cada clip a las marcas de tiempo especificadas usando las banderas
-ssy-to. - Re-codificará todos los clips con códec/resolución coincidentes:
ffmpeg -i clip.mp4 -c:v libx264 -crf 23 -vf "scale=1920:1080:force_original_aspect_ratio=decrease,pad=1920:1080:-1:-1,fade=in:0:15,fade=out:st=DURACION:d=0.5" -c:a aac -ar 44100 segmento_N.mp4 - Creará una lista de archivos concat y los fusionará:
ffmpeg -f concat -safe 0 -i filelist.txt -c copy highlight_reel.mp4
Pautas
- Al convertir descargas de yt-dlp (típicamente WebM/VP9+Opus), siempre re-codificar a H.264+AAC para máxima compatibilidad con dispositivos. Usar
-c:v libx264 -crf 23 -c:a aac -movflags +faststart. - Usar copia de flujo (
-c copy) siempre que sea posible para evitar re-codificación; es instantáneo y sin pérdida. Solo re-codificar al cambiar códecs, aplicar filtros o cuando el contenedor de origen y destino sean incompatibles. - Siempre agregar
-movflags +faststartal crear archivos MP4 para reproducción web o móvil; mueve el átomo moov al inicio del archivo para transmisión instantánea. - Usar
ffprobeantes del procesamiento para entender el formato de entrada, evitando re-codificaciones innecesarias. - Para operaciones por lotes, probar siempre el comando en un solo archivo primero antes de ejecutarlo en todo el directorio.
- Preferir el modo CRF sobre el modo de tasa de bits para codificación de una sola pasada; produce una calidad consistente en diferentes tipos de contenido.