Discover MCPs & agents
Loading MCPs and agents…
Loading MCPs and agents…
A cross-platform multimedia conversion tool with AI built on FFmpeg, React, TypeScript, and Electron.
From the repo.
EncodeX — the free, open-source FFmpeg GUI for Windows, macOS & Linux.
EncodeX brings the full power of FFmpeg to a modern, intuitive desktop app — no command line required. Convert video and audio between formats, extract music from videos, trim clips, compress images, and batch-process whole folders. Developer? The same engine is available headless through the EncodeX CLI.
Want an AI assistant to do the work? EncodeX also ships a built-in MCP server, so tools like Claude Desktop, Cursor, VS Code, and custom agents can convert and manage your media for you over the Model Context Protocol — still entirely on your own machine.
Everything runs locally on your computer — no accounts, no uploads, no watermarks, no subscriptions.
convert, info, capabilities, compress, extract-audio, remux, demux, batch)encodex --mcp), plus an embedded localhost HTTP endpoint that adds 6 GUI-parity tools (live queue, preview, timeline, system info, updates) for 21 in total. Run one-off conversions or manage async jobs from Claude Desktop, Claude Code, Cursor, VS Code, or any MCP clientCtrl+/)See docs/FEATURES.md for the full feature breakdown, supported formats, and codec lists.
🏠 Home Dashboard
 🔄 Media Conversion |
 🎵 Audio Extraction |
 ✂️ Video Cutting |
 🖼️ Image Compression |
 📋 Batch Queue |
 ℹ️ Media Info |
Simple enough for everyday users. Powerful enough for developers. The GUI and CLI share the same engine:
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
# Run as an MCP server for AI assistants and automation
encodex --mcp
See docs/CLI.md for all subcommands, options, and exit codes.
Pre-built installers are available on the Releases page — or the friendly version at encodex.in/download.
EncodeX is not code-signed (no Apple Developer account). macOS Gatekeeper will block the app on first open.
Option 1 — Right-click to open:
Option 2 — Remove quarantine via Terminal:
xattr -cr /Applications/EncodeX.app
Download the .exe (Windows) or .AppImage (Linux) installer from the Releases page and run it.
ffmpeg-static; falls back to system ffmpeg if the bundled binary is unavailablenpm install
# Start Vite dev server + tsc watch (no Electron window)
npm run dev
# Full dev environment with Electron window
npm run electron:dev
# Quick start (build then launch)
npm run dev:start
npm run dev starts two processes concurrently:
http://localhost:5173 with HMRdist/main/npm run electron:dev waits for Vite to be ready, compiles both main and preload, then launches Electron with the --dev flag pointing at the Vite dev server URL. DevTools open automatically.
# Production build (renderer + main + preload)
npm run build
# Package for current platform (no installer)
npm run pack
# Create distributable installer
npm run dist
| Script | Description |
|---|---|
npm run dev:renderer | Vite dev server only |
npm run dev:main | tsc -p tsconfig.main.json --watch |
npm run build:renderer | Vite production build — outputs to dist/renderer/ |
npm run build:main | tsc -p tsconfig.main.json — outputs to dist/main/ |
npm run build:preload | tsc -p tsconfig.preload.json — outputs to dist/preload/ |
npm run build | All three in sequence |
npm run start | Launch compiled app from dist/ via electron . |
npm run electron:dev | Vite + Electron dev environment |
npm run dev:start | Build then launch |
npm run format | prettier --write on all src TypeScript/JSON |
npm run format:check | prettier --check on all src TypeScript/JSON |
npm run pack | Build + electron-builder --dir |
npm run dist | Build + electron-builder (NSIS/DMG/AppImage) |
npm test # Run all 123 test files / 1603 tests
npm run test:watch
npm run test:coverage
npm run test:unit
npm run test:integration
npm run test:e2e # Requires build
See docs/TESTING.md for the full test suite breakdown, test setup, and E2E specs.
| Document | Description |
|---|---|
| docs/FEATURES.md | Features, supported media formats, codec tables, validation utilities |
| docs/CLI.md | CLI usage, subcommands, all option tables, exit codes |
| docs/MCP.md | MCP server tool catalogue, client configs, embedded HTTP server, security |
| docs/TESTING.md | Test suite, test setup, E2E specs |
| docs/IPC.md | IPC channels, electronAPI bridge, all methods and events |
| docs/PROJECT_STRUCTURE.md | Full directory tree with annotations |
| docs/ARCHITECTURE.md | Internal architecture overview and links to deep dives |
| docs/ARCHITECTURE_PROCESSES.md | Process model, build system, startup sequence, CLI mode |
| docs/ARCHITECTURE_TRANSCODERS.md | Transcoder abstraction, FFmpeg/BMF cores, hardware acceleration |
| docs/ARCHITECTURE_RENDERER.md | Render tree, pages, stores, queue, player, i18n, theming |
| docs/UPDATE_MANAGER.md | In-app update manager implementation details |
| Wiki | Community wiki (mirrors the docs in a browsable form) |
| CONTRIBUTING.md | Contribution guidelines |
| SECURITY.md | Vulnerability reporting |
| CODE_OF_CONDUCT.md | Code of conduct |
See CONTRIBUTING.md for guidelines. All contributions are welcome — please open an issue first for significant changes.
This project is governed by a Code of Conduct.
Report security vulnerabilities to the project maintainers via the security advisory process. See SECURITY.md.
MIT
Replace {MCP_ENDPOINT_URL} with this MCP’s endpoint URL (from its repo or docs above). No API key — you connect directly.
Tool
OS
Config file: ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"url": "{MCP_ENDPOINT_URL}"
}
}
}Paste into mcpServers in the config file. Restart Cursor after saving.
If this MCP is also published on mcpchannel.ai, you can subscribe from Browse and use the gateway config there instead.