Skip to content

About

Local batch file converter for Windows, macOS, and Linux: images, JSON/YAML/TOML/CSV, audio, and video. Built in Rust with egui; files never leave your machine.

Topics

Resources

Stars

10 stars

Watchers

0 watching

Forks

Repository files navigation

ConvertCraft — orange and blue conversion arrows forming a C

ConvertCraft

Your files. A new format. All on your desktop.

CI status Platforms: Windows, macOS, Linux License: GPL-3.0

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.

ConvertCraft after converting a video, two data files, an audio file, and an image

What you can do

  • 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.

Getting started

Prerequisites

  • 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 PATH for audio and video. Images and structured data work without it.

Build and launch

git clone https://github.com/PierrunoYT/ConvertCraft.git
cd ConvertCraft
cargo run --release --locked

To build without launching:

cargo build --release --locked

The 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.

Windows

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.

macOS

Install the Xcode Command Line Tools (xcode-select --install), then build a double-clickable app:

scripts/bundle-macos.sh

This 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/convertcraft

Linux

Build 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 ffmpeg

Fedora

sudo dnf install gcc libxkbcommon libxkbcommon-x11 mesa-libGL mesa-libEGL mesa-dri-drivers \
  libX11 libXcursor libXrandr libXi libwayland-client ffmpeg-free

Fedora'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 ffmpeg

openSUSE Tumbleweed

sudo zypper install gcc libxkbcommon0 libxkbcommon-x11-0 Mesa-libGL1 Mesa-libEGL1 Mesa-dri \
  libX11-6 libXcursor1 libXrandr2 libXi6 libwayland-client0 ffmpeg

openSUSE'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 --locked

On 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).

Enable audio and video

Install FFmpeg using your platform's package manager or an FFmpeg build, then check it in the same environment used to launch ConvertCraft:

ffmpeg -version

For 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.

Convert a batch

  1. Add files. Use Add files…, Add folder…, drag and drop, or click the empty queue's browse prompt. Unsupported extensions are skipped.
  2. Select formats. Set each row's Convert to menu, or choose a category under Convert all.
  3. 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.
  4. Convert. Click Convert and watch each row move from Pending to Converting…, then Done or Failed. The progress bar counts finished jobs, including failures.
  5. 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.

Supported formats

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.

Know before converting

  • 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.50 becomes 1.5 and true becomes a boolean; values with leading zeros such as 00123 stay text. TOML rejects nulls and wraps non-object roots under items. 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.

Development

cargo check --locked
cargo test --locked
cargo build --release --locked

The 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.

Documentation and help

License

ConvertCraft is licensed under the GNU General Public License v3.0.

About

Local batch file converter for Windows, macOS, and Linux: images, JSON/YAML/TOML/CSV, audio, and video. Built in Rust with egui; files never leave your machine.

Topics

Resources

Stars

10 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages