Caery Docs

caery is tracked from the Tknott95 crates.io catalog because it is above the 64-download threshold. Current tracked version is 0.1.22, with 75 downloads across 5 versions.

crates.io: https://crates.io/crates/caery

Docs index: https://docs.rs/crate/caery/latest

API docs: https://docs.rs/caery/latest/caery/

Cargo source: https://docs.rs/crate/caery/latest/source/

Keep public site links pointed to crates.io/docs.rs while backend-published formal docs are prepared.

crates.io categories: multimedia::video, gui, multimedia::audio.

crates.io keywords: audio, converter, desktop, ffmpeg, video.

docs.rs package facts: 0.85% documented, 1 of 117 items documented, source code size 2.03 MB, documentation size 2.62 MB.

docs.rs dependencies: eframe, image, and thiserror; dev dependency tempfile.

Caery is a Rust desktop app for converting media files with ffmpeg, styled after the KnottFlasher/Motte monochrome HUD interface.

It supports video-to-audio extraction, video-to-video transcoding, audio-to-audio conversion, Media Vault browsing, path paste, drag-and-drop source selection, suggested output names, overwrite guarding, final route review, live logs, and progress telemetry.

Run desktop app:

cargo run

Quick CLI route inference:

caery song.wav song.mp3
caery clip.mp4 clip.flac
caery clip.mkv clip.webm.

Explicit CLI:

caery --cli --input clip.mp4 --audio-format mp3
caery --cli --input clip.mkv --output clip.webm --mode video-to-video --video-format webm --quality archive
caery --cli --input song.wav --mode audio-to-audio --audio-format flac.

CLI options: --input/-i, --output/-o, --mode/-m, --audio-format, --video-format, --quality/-q, and --overwrite/-y.

Workflow: choose source audio/video with Media Vault, paste a path, or drag a file into the window; confirm/edit output path; pick extract audio, transcode video, or transcode audio; pick output format and quality; review and convert.

Desktop install:

cargo run -- --install writes ~/.local/share/applications/caery.desktop, installs the bundled assets/logo.png under ~/.local/share/icons/hicolor/256x256/apps/caery.png, and writes ~/Desktop/Caery.desktop when Desktop exists.

Caery is designed for Linux desktops and expects ffmpeg and ffprobe to be installed.

Install examples:

sudo pacman -S ffmpeg
sudo apt install ffmpeg
sudo dnf install ffmpeg.

Test commands:

cargo fmt --check
cargo test
cargo check.