ConvX Documentation
Everything you need to convert files locally with ConvX, whether you prefer a GUI, a terminal, or an AI agent.
Getting started
ConvX is a universal file converter that supports 46 formats across images, video, audio, documents, data files, and eBooks with over 400 conversion paths. Everything runs locally on your machine. No uploads, no cloud, no internet required.
Three ways to convert
- Desktop app: Drag-and-drop interface with real-time progress, quality slider, and size comparison.
- CLI:
convx convert,convx watch,convx presets, batch processing with parallel jobs. Full CLI reference → - MCP server: 9 tools exposed for AI agents so they can convert files natively. MCP guide →
Supported formats
| Category | Formats |
|---|---|
| Images | PNG, JPG, WebP, GIF, BMP, TIFF, ICO, SVG, HEIC, HEIF, AVIF |
| Video | MP4, MOV, WebM, AVI, MKV, WMV, FLV, M4V, MPEG, TS |
| Audio | MP3, WAV, FLAC, M4A, AAC, OGG, WMA, AIFF, Opus, AC3 |
| Documents | DOC, PDF, DOCX, PPTX, XLSX, TXT, MD, HTML |
| Data | CSV, JSON, YAML, XML |
| eBooks | EPUB, MOBI |
Built-in presets
ConvX ships with 14 presets for common workflows. Each preset applies the right format, quality, size constraints, and encoding settings automatically.
| Preset | What it does | Output |
|---|---|---|
discord | Upload-friendly video, targets <8MB | MP4 |
discord-nitro | Higher quality, targets <50MB | MP4 |
twitter-image | 1200px wide, optimized JPEG | JPG |
twitter-gif | 480px @ 15fps | GIF |
instagram-story | 1080×1920 vertical @ 30fps | MP4 |
web-image | WebP, stripped metadata, 80% quality | WebP |
email-friendly | Under 1MB, 1200px JPEG | JPG |
heic-to-jpg | iPhone photos to universal JPEG | JPG |
archive-lossless | Lossless PNG for archival | PNG |
extract-audio | Pull audio from video at 192kbps | MP3 |
pdf-to-images | Export PDF pages as images | PNG |
markdown-to-pdf | Render Markdown as PDF | |
json-to-csv | Flatten JSON arrays to CSV | CSV |
epub-to-pdf | eBook to portable PDF |
Checking your setup
Run convx check to verify everything is set up correctly and see which formats are available on your system.
Need help?
Check the CLI Reference for command details, the MCP Guide for AI agent integration, or email us at support@convx.dev.