FFmpeg
Resumen
FFmpeg es la navaja suiza del procesamiento de medios. Maneja prácticamente todos los formatos de audio y video, códecs y contenedores que existen. 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 de medios, incluida con ffmpeg
Paso 2: Conversión de formatos
La tarea más común: convertir entre formatos de contenedor y códecs.
# WebM → MP4 (recodificar 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 recodificació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: Visualmente sin pérdida
- 23: 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 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
# Mezclar 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 marca 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 recodificació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 (alto automático)
ffmpeg -i input.mp4 -vf "scale=1280:-2" output.mp4
# Comprimir agresivamente (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 en dos pasadas para 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
# Incrustar subtítulos en el video (hardcoded)
ffmpeg -i input.mp4 -vf "subtitles=subs.srt" output.mp4
# Incrustar subtítulos ASS/SSA con estilo
ffmpeg -i input.mp4 -vf "ass=subs.ass" output.mp4
# Agregar pista de subtítulos (soft subs, el usuario puede alternar)
ffmpeg -i input.mp4 -i subs.srt -c copy -c:s mov_text output.mp4
# Extraer subtítulos de 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 de medios
# 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 un 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 son todos 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 recodificació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 - El flag
-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 los flags
-ssy-to. - Recodificará todos los clips con el mismo códec/resolución:
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 la fusionará:
ffmpeg -f concat -safe 0 -i filelist.txt -c copy highlight_reel.mp4
Guías
- Al convertir descargas de yt-dlp (típicamente WebM/VP9+Opus), siempre recodificar 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 recodificaciones: es instantáneo y sin pérdida. Solo recodificar al cambiar códecs, aplicar filtros o cuando los contenedores de origen y destino sean incompatibles. - Agregar siempre
-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 de procesar para entender el formato de entrada, evitando recodificaciones innecesarias. - Para operaciones por lotes, siempre probar 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.