🛠️ toolkit
A unified FFmpeg workflow CLI for common media tasks.
A fast, single-binary replacement for mixed PowerShell/Go media scripts. Built with Rust, it provides safe, cross-platform media conversion workflows with progress feedback and batch processing capabilities.
✨ Features
- Unified CLI: One binary for all media workflows (
ts2mp4,mkv2mp3,mp32mp4,vidwrap) - Batch Processing: Automatic directory scanning with skip/overwrite logic
- Safe Defaults: Prevents accidental data loss with explicit
--forceflags - Rich UX: Spinners, progress bars, and colored output (disable with
--no-color) - Testable Core: Dependency-injected FFmpeg runner for deterministic testing
- Zero Runtime Dependencies: Single static binary, no PowerShell or Go required
📦 Installation
From crates.io (Recommended)
From Source
Prerequisites
- FFmpeg must be installed and available in your PATH
- Optional: Use
--ffmpeg-path <PATH>to specify a custom FFmpeg location
🚀 Usage
Global Options
| Flag | Description |
|---|---|
--verbose |
Print FFmpeg commands and diagnostic output to stderr |
--no-color |
Disable ANSI color codes and styling |
--ffmpeg-path <PATH> |
Explicit path to ffmpeg executable |
--ffprobe-path <PATH> |
Explicit path to ffprobe binary (reserved) |
-h, --help |
Print help information |
-V, --version |
Print version information |
Commands
ts2mp4 — Remux TS to MP4
Convert Transport Stream files to MP4 via stream copy (no re-encoding).
# Convert all .ts files in current directory
# Convert specific files to custom output directory
# Overwrite existing outputs
mkv2mp3 — Extract Audio from MKV
Convert MKV files to MP3 with optional cover art extracted from video frames.
# Default: 320kbps, 600px cover art
# Custom bitrate and cover size
# Force overwrite existing MP3s
mp32mp4 — Create Video from MP3
Convert MP3 files to MP4 videos using embedded cover art as the video track.
# Use embedded cover art (black video fallback if missing)
# Skip files without embedded cover art
# Custom audio bitrate
vidwrap — Wrap Video with Thumbnail
Combine a video with a companion image to create a new video with an embedded thumbnail. Supports interactive post-processing.
# Requires a same-basename image (e.g., video.mp4 + video.jpg)
Supported companion image formats (in priority order): .png, .jpg, .jpeg, .bmp, .gif, .webp
Batch Arguments
All batch commands (ts2mp4, mkv2mp3, mp32mp4) share these options:
| Flag | Default | Description |
|---|---|---|
--output-dir <DIR> |
./out |
Directory for converted files (created automatically) |
--force |
false |
Overwrite existing output files instead of skipping |
🔧 Development
# Build debug binary
# Run tests
# Clippy linting
# Format check