EncodeX — la interfaz gráfica de FFmpeg gratuita y de código abierto para Windows, macOS y Linux.
EncodeX es la interfaz gráfica gratuita y de código abierto de FFmpeg que lleva todo su poder a una interfaz de escritorio moderna e intuitiva. Te permite convertir medios entre formatos, extraer audio, cortar vídeos y comprimir imágenes: todo a través de una interfaz limpia y receptiva con cola por lotes, aceleración por hardware, modo CLI y una internacionalización completa.
¿Quieres que un asistente de IA haga el trabajo? EncodeX también incluye un servidor MCP integrado, para que herramientas como Claude Desktop, Cursor, VS Code y agentes personalizados puedan convertir y gestionar tus archivos multimedia por ti mediante el Model Context Protocol — sin salir de tu propia máquina.
- ✅ Gratis para siempre — código abierto (MIT), sin nivel de pago
- ✅ 100 % privado — tus archivos nunca salen de tu máquina
- ✅ Sin cuenta, sin registro, sin rastreo
- ✅ Sin marcas de agua, sin límites de tamaño de archivo, sin anuncios
- ✅ Potenciado por FFmpeg — 51 códecs de vídeo, 27 códecs de audio, 56 formatos de píxel
- ✅ Aceleración por hardware — NVIDIA, Intel, AMD, Apple Silicon para codificaciones rápidas
- ✅ Procesamiento por lotes — convierte carpetas completas a la vez
- ✅ Servidor MCP listo para IA — usa EncodeX desde Claude, Cursor, VS Code y agentes personalizados
- ✅ Multiplataforma — Windows 10+, macOS 11+, Linux
- ✅ 35+ idiomas con soporte RTL
- 🔄 Conversión multimedia — 51 códecs de vídeo, 27 códecs de audio, 56 formatos de píxel con controles de códec/bitrate/escala/calidad
- 🌀 Rotación y espejo — Rota vídeos e imágenes 90°, 180° o 270° en el sentido de las agujas del reloj y reflejalos horizontal o verticalmente; en el modo de copia de flujo para MP4/MOV/MKV, la rotación se guarda como metadatos sin pérdida de calidad
- 🎛️ Perfiles de conversión — más de 140 preconfiguraciones en 8 categorías (YouTube, Instagram, TikTok, Apple, Android, ProRes, HLS y más) con creación de perfiles personalizados y seguimiento de uso reciente
- ⚡ Aceleración por hardware — NVIDIA NVENC, Intel QSV, AMD AMF, VAAPI, Apple VideoToolbox, Media Foundation
- ✂️ Corte de vídeo — Recorte con precisión de fotograma gracias a un reproductor integrado (conductos rawvideo + PCM, Canvas + Web Audio) y una línea de tiempo ampliable (onda de forma + montaje de miniaturas)
- 📋 Cola por lotes — Procesamiento en paralelo (hasta 4 tareas simultáneas) con progreso en tiempo real, errores por tarea, pausa/reanudación, reordenamiento por arrastrar y soltar, edición de opciones de tarea, filtros por estado, exportación/importación JSON y acciones de energía al terminar (apagado/suspensión/hibernación)
- 🖼️ Compresión de imágenes — JPEG/PNG/WebP/BMP/GIF/TIFF con calidad/escala, visor EXIF, histogramas RGB/luma
- 🎵 Extracción de audio — Cualquiera de los 27 códecs de audio a partir de cualquier archivo de vídeo
- ℹ️ Información multimedia — Sondeo completo por flujo: códec, perfil, resolución, metadatos de color, frecuencia de fotogramas, etc.
- ⌨️ Modo CLI — Scripting sin interfaz gráfica con subcomandos (
convert,info,capabilities,compress,extract-audio,batch) - 🤖 Servidor MCP — servidor Model Context Protocol integrado: 13 herramientas principales, 3 recursos y 4 prompts mediante stdio (
encodex --mcp), además de un endpoint HTTP local integrado que añade 6 herramientas de paridad con la GUI (cola en vivo, vista previa, línea de tiempo, información del sistema, actualizaciones). Ejecuta conversiones puntuales o gestiona trabajos asíncronos desde Claude Desktop, Claude Code, Cursor, VS Code o cualquier cliente MCP - ⚙️ 3 núcleos de transcodificación — API de FFmpeg (fluent-ffmpeg), CLI de FFmpeg (child_process), plataforma BMF
- 🌍 56 configuraciones regionales — 35 idiomas con soporte RTL (árabe, hebreo)
- ⌨️ Atajos de teclado — Más de 60 atajos en todas las páginas con un diálogo de ayuda integrado (
Ctrl+/) - 🔔 Blips de actividad — Indicadores de navegación en vivo con ventanas emergentes al pasar el cursor que muestran el progreso de cada tarea de un vistazo
- 🛡️ Confirmación de cierre — Advierte antes de cerrar la ventana mientras haya tareas en ejecución
- 🎉 Huevos de pascua — Logotipos temáticos de la aplicación en fechas especiales
- 🔄 Actualizaciones integradas — Comprueba las versiones de GitHub Releases, descarga el instalador de la plataforma, progreso en tiempo real
- 🛡️ Manejo de errores — 16 códigos de error tipados, snackbar global, banners integrados, limites de error de React
- 🌗 Tema oscuro/claro — Consciente del sistema con conmutador manual y preferencias persistentes
Consulta Referencia de características para conocer el desglose completo de las características, los formatos compatibles y las listas de códecs.
🏠 Panel principal
 🔄 Conversión multimedia |
 🎵 Extracción de audio |
 ✂️ Corte de vídeo |
 🖼️ Compresión de imágenes |
 📋 Cola por lotes |
 ℹ️ Información multimedia |
- Node.js 22+
- FFmpeg — incluido a través de
ffmpeg-static; recurre alffmpegdel sistema si el binario incluido no está disponible
Los instaladores precompilados están disponibles en la página de Releases.
EncodeX no está firmado con código (sin cuenta de desarrollador de Apple). Gatekeeper de macOS bloqueará la aplicación en la primera apertura.
Opción 1 — Clic derecho para abrir:
- Haz clic derecho (o Control-clic) en la aplicación EncodeX y selecciona Abrir
- Haz clic en Abrir en el diálogo de confirmación
Opción 2 — Elimina la cuarentena mediante Terminal:
xattr -cr /Applications/EncodeX.appDescarga el instalador .exe (Windows) o .AppImage (Linux) desde la página de Releases y ejecútalo.
npm install# Inicia el servidor de desarrollo de Vite + observador de tsc (sin ventana de Electron)
npm run dev
# Entorno de desarrollo completo con ventana de Electron
npm run electron:dev
# Inicio rápido (compila y luego ejecuta)
npm run dev:startnpm run dev inicia dos procesos de forma concurrente:
- Vite — sirve el renderizador de React en
http://localhost:5173con HMR - tsc — observa y compila el TypeScript del proceso principal en
dist/main/
npm run electron:dev espera a que Vite esté listo, compila tanto el proceso principal como el preload y luego inicia Electron con la bandera --dev apuntando a la URL del servidor de desarrollo de Vite. DevTools se abre automáticamente.
# Compilación de producción (renderizador + principal + preload)
npm run build
# Empagueta para la plataforma actual (sin instalador)
npm run pack
# Crea el instalador distribuible
npm run dist| Script | Descripción |
|---|---|
npm run dev:renderer |
Solo el servidor de desarrollo de Vite |
npm run dev:main |
tsc -p tsconfig.main.json --watch |
npm run build:renderer |
Compilación de producción de Vite: salida en dist/renderer/ |
npm run build:main |
tsc -p tsconfig.main.json — salida en dist/main/ |
npm run build:preload |
tsc -p tsconfig.preload.json — salida en dist/preload/ |
npm run build |
Los tres en secuencia |
npm run start |
Ejecuta la aplicación compilada desde dist/ mediante electron . |
npm run electron:dev |
Entorno de desarrollo de Vite + Electron |
npm run dev:start |
Compila y luego ejecuta |
npm run format |
prettier --write sobre todo el TypeScript/JSON de src |
npm run format:check |
prettier --check sobre todo el TypeScript/JSON de src |
npm run pack |
Compila + electron-builder --dir |
npm run dist |
Compila + electron-builder (NSIS/DMG/AppImage) |
Compila primero y luego invoca a través de encodex:
encodex convert input.mp4 output.avi --video-codec libx265 --audio-codec aac
encodex info input.mp4 --json
encodex compress photo.png -f jpg -q 30
encodex extract-audio input.mp4
encodex batch 'videos/**/*.mov' --concurrency 2 --output-dir converted
# Ejecutar como servidor MCP para asistentes de IA y automatización
encodex --mcpConsulta Uso de la CLI para conocer todos los subcomandos, opciones y ejemplos.
npm test # Ejecuta los 123 archivos de prueba / 1603 pruebas
npm run test:watch
npm run test:coverage
npm run test:unit
npm run test:integration
npm run test:e2e # Requiere compilación previaConsulta Pruebas para conocer el desglose completo de la suite de pruebas, la configuración de las pruebas y las especificaciones E2E.
| Documento | Descripción |
|---|---|
| Referencia de características | Características, formatos multimedia compatibles, tablas de códecs, utilidades de validación |
| Uso de la CLI | Uso de la CLI, subcomandos, tablas de todas las opciones, códigos de salida |
| Servidor MCP | Catálogo de herramientas del servidor MCP, configuraciones de cliente, servidor HTTP integrado, seguridad |
| Pruebas | Suite de pruebas, configuración de las pruebas, especificaciones E2E |
| Canales IPC | Canales IPC, puente electronAPI, todos los métodos y eventos |
| Estructura del proyecto | Árbol de directorios completo con anotaciones |
| Resumen de la arquitectura | Panorama de la arquitectura interna y enlaces a análisis detallados |
| Arquitectura de procesos | Modelo de procesos, sistema de compilación, secuencia de inicio, modo CLI |
| Arquitectura de transcodificadores | Abstracción de transcodificador, núcleos FFmpeg/BMF, aceleración por hardware |
| Arquitectura del renderizador | Árbol de renderizado, páginas, almacenes, cola, reproductor, i18n, temas |
| Gestor de actualizaciones | Detalles de implementación del gestor de actualizaciones integrado |
| Wiki | Wiki de la comunidad (refleja los documentos en un formato navegable) |
| Sitio de documentación | Sitio de VitePress con recorrido por las características, guías y blog de versiones |
| Contribuir | Guía de contribuciones |
| Seguridad | Reporte de vulnerabilidades |
| Código de conducta | Código de conducta |
Consulta Contribuir para conocer las guías. Todas las contribuciones son bienvenidas: abre primero una incidencia para los cambios significativos.
Este proyecto se rige por un Código de conducta.
Reporta las vulnerabilidades de seguridad a los mantenedores del proyecto mediante el proceso de asesorías de seguridad. Consulta Seguridad.
MIT