Communitygithub.com

FFmpeg (Procesamiento de Medios)

Transcodifica, convierte, edita y procesa audio y video con FFmpeg. Úsalo cuando un usuario solicite convertir formatos de video (webm a mp4, mkv a mp4), extraer audio de video, comprimir archivos de video, recortar o cortar clips, concatenar videos, agregar subtítulos, crear miniaturas, aplicar filtros, cambiar resolución o tasa de bits, recodificar medios, crear GIFs a partir de video, agregar marcas de agua, normalizar audio, transmitir medios o construir tuberías automatizadas de procesamiento de medios.

¿Qué es FFmpeg (Procesamiento de Medios)?

FFmpeg es la navaja suiza del procesamiento de medios, compatible con prácticamente todos los formatos, códecs y contenedores de audio y video. Esta habilidad permite realizar conversiones entre formatos como WebM a MP4 o MKV a MP4, recortar clips, concatenar videos, extraer audio, comprimir archivos, crear miniaturas y screenshots, agregar y extraer subtítulos, aplicar filtros como escalado, rotación y fundidos, crear GIFs animados, agregar marcas de agua, normalizar volumen, y cambiar resolución y tasa de bits. También incluye instrucciones para procesamiento por lotes, creación de reels de highlights con transiciones, e integración con herramientas como yt-dlp y gallery-dl. Ofrece pautas clave como usar copia de flujo cuando sea posible para evitar recodificaciones, usar el flag `-movflags +faststart` para reproducción web/móvil, y verificar el formato de entrada con `ffprobe` antes de procesar. Soporta Ubuntu/Debian y macOS.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/TerminalSkills/skills/tree/HEAD/skills/ffmpeg

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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:

  1. Verificará si los archivos WebM contienen H.264+AAC (posible copia de flujo) o VP9+Opus (necesita recodificación) usando ffprobe.
  2. 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
  3. El flag -movflags +faststart mueve los metadatos al inicio del archivo, permitiendo la reproducción instantánea en dispositivos móviles y navegadores web.
  4. 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:

  1. Recortará cada clip a las marcas de tiempo especificadas usando los flags -ss y -to.
  2. 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
  3. 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 +faststart al crear archivos MP4 para reproducción web o móvil; mueve el átomo moov al inicio del archivo para transmisión instantánea.
  • Usar ffprobe antes 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.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

TerminalSkills/skills

>- Run GitHub Actions locally with act. Use when a user asks to test GitHub Actions workflows locally, debug CI pipelines without pushing, or run workflows offline.

TerminalSkills/skills

>- You are an expert in AG2 (formerly AutoGen), the open-source multi-agent conversation framework. You help developers build systems where multiple AI agents collaborate through structured conversations — with tool use, human-in-the-loop, code execution, group chat orchestration, and nested conversations — for complex tasks like software development, research, and data analysis.

TerminalSkills/skills

>- Generate short-form videos with AI — script writing, text-to-speech narration, stock footage selection, subtitle generation, and video assembly. Use when: creating TikTok/YouTube Shorts/Reels content, automating video production, building content pipelines.

TerminalSkills/skills

>- Animate 3D objects and characters in Blender with Python. Use when the user wants to keyframe properties, create armatures and rigs, set up IK/FK chains, animate shape keys for facial animation, edit F-Curves, use the NLA editor to blend actions, add drivers for expression-based animation, or script any animation workflow in Blender.

TerminalSkills/skills

>- Automate motion capture and tracking workflows in Blender with Python. Use when the user wants to import BVH or FBX mocap data, retarget motion to armatures, track camera or object motion from video, solve camera motion, clean up motion capture data, or script any tracking pipeline in Blender.

TerminalSkills/skills

>- You are an expert in Bolt.new by StackBlitz, the AI-powered full-stack development environment that runs entirely in the browser. You help developers go from idea to deployed app in minutes using natural language prompts — Bolt generates complete applications with frontend, backend, database, and deployment, all running in a WebContainer without local setup.

TerminalSkills/skills

>- Assists with using Bun as an all-in-one JavaScript/TypeScript runtime, package manager, bundler, and test runner. Use when building HTTP servers, managing packages, running tests, or migrating from Node.js. Trigger words: bun, bun serve, bun install, bun test, bun build, javascript runtime, bun runtime.

TerminalSkills/skills

>- Self-host customer support with Chatwoot. Use when a user asks to set up open-source customer support, add live chat without SaaS costs, build a multi-channel inbox, or deploy a free Intercom alternative.

TerminalSkills/skills

>- You are an expert in Chi, the lightweight, idiomatic Go HTTP router built on `net/http`. You help developers build composable HTTP services using Chi's middleware stack, route groups, URL parameters, sub-routers, and context-based request scoping — providing Express-like ergonomics while staying 100% compatible with Go's standard library.

TerminalSkills/skills

When the user wants to edit, review, or improve existing marketing copy. Also use when the user mentions 'edit this copy,' 'review my copy,' 'copy feedback,' 'proofread,' 'polish this,' 'make this better,' or 'copy sweep.' This skill provides a systematic approach to editing marketing copy through multiple focused passes.

TerminalSkills/skills

>- Add live chat and customer support with Crisp. Use when a user asks to add a chat widget, implement live customer support, set up a help desk, create a knowledge base, or add a chatbot to a website.

TerminalSkills/skills

>- Assists with building custom interactive data visualizations using D3.js. Use when creating charts, graphs, maps, force layouts, or hierarchical diagrams that require fine-grained control beyond what charting libraries provide. Trigger words: d3, data visualization, chart, svg, scales, force graph, treemap, choropleth.

TerminalSkills/skills

dbt (data build tool) transforms data in your warehouse using SQL SELECT statements. Learn project setup, models, tests, documentation, incremental materializations, and integration with data warehouses like PostgreSQL, BigQuery, and Snowflake.

TerminalSkills/skills

>- You are an expert in dlt, the open-source Python library for building data pipelines. You help developers load data from any API, file, or database into warehouses and lakes using simple Python decorators — with automatic schema inference, incremental loading, and built-in data contracts. dlt is the "requests library for data pipelines.

TerminalSkills/skills

Data Version Control for ML projects. Track large datasets and models alongside Git, build reproducible ML pipelines, and run experiments with metric comparison. Works with any storage backend including S3, GCS, Azure, and local filesystems.

TerminalSkills/skills

>- You are an expert in E2B, the cloud platform for running AI-generated code in secure sandboxes. You help developers give AI agents the ability to execute code, install packages, read/write files, and run long processes in isolated cloud environments — each sandbox is a lightweight VM that boots in ~150ms with full Linux, filesystem, and networking.

TerminalSkills/skills

>- Create advanced animations with GSAP. Use when building complex timelines, scroll-driven animations, SVG morphing, text animations, or high-performance web animations beyond CSS capabilities.

TerminalSkills/skills

>- Generate deterministic MP4 videos from HTML, CSS, media, and seekable animations using HeyGen's HyperFrames framework. Use when someone asks to "render HTML to video", "make a video with HyperFrames", "create a programmatic video", "turn an animation into MP4", "build a launch/product video from HTML", "render GSAP/Lottie/Three.js to video", or set up an agent-driven video pipeline. Covers init/preview/render/add/lint/inspect commands, data-* timing attributes, animation adapters, and the component catalog.

TerminalSkills/skills

When the user wants to perform load testing, stress testing, or performance testing of APIs and websites using k6. Also use when the user mentions "k6," "load test," "performance test," "stress test," "spike test," "soak test," "thresholds," "virtual users," or "VUs." For browser-based testing, see selenium.

TerminalSkills/skills

>- Lovable (formerly GPT Engineer) is a browser-based AI app builder that turns a natural-language description into a working full-stack web app with a built-in backend, authentication, database and one-click publishing. Use when the user wants to prototype or ship a web app with Lovable, write effective Lovable prompts, connect Supabase or GitHub, review generated security rules, or move a Lovable project into their own editor.

Skills relacionados