Your files. A new format. All on your desktop.
Get started · Supported formats · User guide · Development
ConvertCraft is a native desktop batch converter for images, structured data, audio, and video on Windows, macOS, and Linux, built with Rust and egui/eframe. Files are processed locally without uploading them to a conversion service. Image and data conversion run in Rust; audio and video use your local FFmpeg installation.
ConvertCraft is one of the open-source desktop apps from Pierruno.
- Build a batch: pick multiple files, import a folder recursively, or drag files and folders into the window.
- Mix formats: choose a target for each file or apply one target to an entire category.
- Keep working: conversions run on up to four background workers, with per-file status and batch progress.
- Choose your destination: save beside each source or collect outputs in one folder.
- Avoid accidental replacement: overwriting is off by default; filename collisions receive numbered suffixes.
- Tune image output: set JPEG/AVIF quality from 10 to 100 (default 90) and optionally shrink images to fit a maximum width and height.
- Find the result: click a completed file's Done status to reveal it in your file manager.
- A current stable Rust toolchain, including Cargo. The crate uses edition 2024; its dependencies may require a newer compiler than the edition's minimum.
- Native build tools for your platform: MSVC tools on Windows, Xcode Command Line Tools on macOS, or a C/C++ toolchain and development libraries on Linux.
- A graphical desktop to run the application. ConvertCraft is not a command-line converter or web app.
- Optional: FFmpeg on
PATHfor audio and video. Images and structured data work without it.
git clone https://github.com/PierrunoYT/ConvertCraft.git
cd ConvertCraft
cargo run --release --lockedTo build without launching:
cargo build --release --lockedThe executable is target/release/convertcraft on Linux/macOS or target/release/convertcraft.exe on Windows. The Cargo package and executable were previously named transmute; update any scripts or shortcuts that use the old name.
Install the MSVC build tools (Visual Studio Build Tools with the C++ workload). The executable carries the ConvertCraft icon for Explorer, the taskbar, and shortcuts. For audio and video, add the directory containing ffmpeg.exe to PATH.
Install the Xcode Command Line Tools (xcode-select --install), then build a double-clickable app:
scripts/bundle-macos.shThis builds the release binary and wraps it in target/release/ConvertCraft.app with the logo as its icon. Drag the app to /Applications, or open it from Finder. A Homebrew FFmpeg (brew install ffmpeg) is found even when the app is opened from Finder or the Dock. The bundle is ad-hoc signed, which is enough on the Mac that built it; a copy downloaded from elsewhere needs a Developer ID signature and notarization before Gatekeeper will open it.
Homebrew's ffmpeg formula has no Vorbis encoder, so OGG and OGV output fail with it. For those, run brew install ffmpeg-full. That formula is keg-only, so the app opened from Finder does not find it; start ConvertCraft from a terminal instead:
PATH="$(brew --prefix ffmpeg-full)/bin:$PATH" target/release/ConvertCraft.app/Contents/MacOS/convertcraftBuild ConvertCraft on the distro you run it on: a binary built on a newer distro needs a newer glibc and will not start on an older one. Install a C compiler, the graphics and keyboard libraries, and FFmpeg, then build with Cargo as shown above. The windowing libraries are loaded when the app starts rather than linked, so no -dev packages are needed; if one is missing, the build succeeds but the app exits at launch naming the library (for example libXcursor.so.1).
These commands were tested by building and launching ConvertCraft in a clean container of each distro:
Debian 12+ / Ubuntu 22.04+
sudo apt-get update
sudo apt-get install build-essential libxkbcommon0 libxkbcommon-x11-0 libgl1 libegl1 \
libgl1-mesa-dri libx11-6 libxcursor1 libxrandr2 libxi6 libwayland-client0 ffmpegFedora
sudo dnf install gcc libxkbcommon libxkbcommon-x11 mesa-libGL mesa-libEGL mesa-dri-drivers \
libX11 libXcursor libXrandr libXi libwayland-client ffmpeg-freeFedora's ffmpeg-free has no H.264 encoder, so MP4, MOV, M4V, MKV, TS, and FLV output fail. For those, replace it with ffmpeg from RPM Fusion.
Arch Linux
sudo pacman -S --needed gcc libxkbcommon-x11 mesa libx11 libxcursor libxrandr libxi wayland ffmpegopenSUSE Tumbleweed
sudo zypper install gcc libxkbcommon0 libxkbcommon-x11-0 Mesa-libGL1 Mesa-libEGL1 Mesa-dri \
libX11-6 libXcursor1 libXrandr2 libXi6 libwayland-client0 ffmpegopenSUSE's ffmpeg also lacks H.264; use the Packman build for MP4, MOV, M4V, MKV, TS, and FLV output.
Alpine Linux
sudo apk add build-base libxkbcommon libxkbcommon-x11 mesa-gl mesa-egl mesa-dri-gallium \
libx11 libxcursor libxrandr libxi wayland-libs-client ffmpeg
RUSTFLAGS="-C target-feature=-crt-static" cargo build --release --lockedOn musl, Rust links statically by default, and a static binary cannot load the windowing libraries ("Dynamic loading not supported"), so build with the flag above.
The FFmpeg packages from Debian, Ubuntu, Arch, and Alpine include every encoder ConvertCraft uses. Other distros, NixOS, and ARM have not been tested.
ConvertCraft runs natively on both X11 and Wayland. File pickers use the desktop's XDG portal service and fall back to zenity when no portal is available. If Add files… or Add folder… does nothing, install xdg-desktop-portal with the backend for your desktop, or install zenity (sudo apt-get install zenity).
Install FFmpeg using your platform's package manager or an FFmpeg build, then check it in the same environment used to launch ConvertCraft:
ffmpeg -versionFor example, use sudo apt-get install ffmpeg on Debian/Ubuntu or brew install ffmpeg on macOS with Homebrew. On Windows, add the directory containing ffmpeg.exe to PATH.
The header shows checking ffmpeg… briefly, then ffmpeg ✔ (hover for the path in use) or ffmpeg missing. Only absolute PATH entries are searched, never ConvertCraft's own folder. On macOS, Homebrew's /opt/homebrew/bin and /usr/local/bin are also searched, because apps opened from Finder or the Dock do not get your shell's PATH. Restart ConvertCraft after installing FFmpeg or changing PATH: availability is checked at startup. Available encoders depend on your FFmpeg build.
- Add files. Use Add files…, Add folder…, drag and drop, or click the empty queue's browse prompt. Unsupported extensions are skipped.
- Select formats. Set each row's Convert to menu, or choose a category under Convert all.
- Set output options. Keep Next to source file or choose a destination folder. Adjust JPEG/AVIF quality if needed; leave overwriting off unless you intend to replace existing outputs.
- Convert. Click Convert and watch each row move from Pending to Converting…, then Done or Failed. The progress bar counts finished jobs, including failures.
- Inspect results. Click Done to reveal the output. Hover over Failed for the error. Clear finished removes successful rows, not files.
Failed rows can be retried with Convert. Successful rows are skipped on subsequent runs; remove and re-add a source to convert it again. Queue and option controls are disabled during a batch.
| Category | Inputs | Outputs | Backend |
|---|---|---|---|
| Images | PNG/APNG, JPG/JPEG/JFIF, WebP, BMP, GIF, TIF/TIFF, ICO, TGA, QOI, PNM/PBM/PGM/PPM/PAM, HDR, EXR, Farbfeld (FF), DDS | PNG, JPG, WebP, AVIF, BMP, GIF, TIFF, ICO, TGA, QOI, PNM, HDR, EXR, Farbfeld | Rust image |
| Structured data | JSON, YAML/YML, TOML, CSV | JSON, YAML, TOML, CSV | Rust parsers and serializers |
| Audio | MP3/MP2, WAV/W64, FLAC, OGG/OGA, M4A/M4B, AAC, Opus, WMA, AIFF/AIF/AIFC, AC3, E-AC3, DTS, MKA, CAF, WavPack, TTA, AU | MP3, WAV, FLAC, OGG, M4A, Opus, AAC, AIFF, WMA, AC3 | FFmpeg |
| Video | MP4, MKV, WebM, AVI/DivX, MOV, WMV/ASF, FLV/F4V, M4V, MPG/MPEG/M2V, VOB, TS/MTS/M2TS, 3GP/3G2, OGV, MXF, RM/RMVB, DV, Y4M | MP4, MKV, WebM, AVI, MOV, M4V, TS, FLV, WMV, OGV, animated GIF/WebP; audio extraction to every audio target | FFmpeg |
Targets are restricted to each category. Extension recognition is case-insensitive, but it does not guarantee that a file's contents or codecs can be decoded. See the format reference for encoding presets and exact conversion rules.
- Keep originals and backups. Each output is written to a temporary file and only published after a successful conversion, so a failed job leaves no partial file. Publication is still pathname-based and does not detect every filesystem alias. On Linux and macOS, outputs get the usual permissions for new files (0644 with the common umask); replacing an existing output does not keep its old permissions.
- Images are not archival copies. JPEG has no transparency, so transparent areas become white. ICO output fits within 256×256. Image conversion does not preserve animation frames or metadata; only PNG, TIFF, PNM, and Farbfeld keep 16-bit depth, and only HDR and EXR keep float samples. HDR/EXR converted to other formats are clipped without tone mapping.
- Data conversion can change representation. Comments and formatting are lost. CSV infers numbers and booleans, so
1.50becomes1.5andtruebecomes a boolean; values with leading zeros such as00123stay text. TOML rejects nulls and wraps non-object roots underitems. See data compatibility. - Media is re-encoded. Fixed presets determine quality and codec selection; there are no bitrate, trimming, subtitle, or stream-selection controls.
- Sessions are temporary. Settings and the queue are not saved. A running batch can be cancelled; image and data jobs already in progress finish first.
cargo check --locked
cargo test --locked
cargo build --release --lockedThe existing tests exercise image targets, structured data round trips, output-path collisions, and media conversions. The media test skips itself when FFmpeg is absent; install it with the required encoders to exercise that path, or set CONVERTCRAFT_REQUIRE_FFMPEG=1 to make a missing FFmpeg fail the test. CI runs formatting, Clippy, tests on Linux/Windows/macOS, and cargo deny check (see development docs).
| Path | Responsibility |
|---|---|
src/main.rs |
Native UI layout, queue, worker scheduling, progress, and file-manager integration |
src/theme.rs |
Light visual style: palette, egui style, cards, and styled buttons |
src/converter.rs |
Format detection, conversion backends, and tests |
src/output.rs |
Output planning, batch input protection, and staged publication |
src/import.rs |
Bounded background folder scan for file and folder import |
scripts/bundle-macos.sh |
Builds ConvertCraft.app on macOS |
assets/screenshots/ |
README screenshot of the main window |
assets/logos/ |
Transparent logo (logo.png) and light/dark previews (logo-light.png, logo-dark.png) |
docs/ |
User guide, format details, and architecture |
The window title and in-app name use APP_NAME in src/main.rs. The embedded logo is decoded once at startup and reused for the native icon and UI texture; no external asset folder is needed beside the compiled executable.
For implementation details and extension guidance, read Development and architecture. CI builds and tests ConvertCraft on Windows, macOS, and Linux and builds the macOS app bundle; the user interface itself has no automated tests.
- User guide and troubleshooting
- Supported formats and conversion behavior
- Development and architecture
- Changelog
- Report an issue — include your OS, source/target formats, and the error text; use non-sensitive sample files when possible.
ConvertCraft is licensed under the GNU General Public License v3.0.

