Mux Magic is a self-hosted media operations server and command-line toolkit. It can inspect, rename, remux, and reorganize media files through repeatable jobs and multi-step sequences.
Set up Mux Magic with Docker →
- A web interface for jobs, logs, and reusable sequence templates.
- A REST API for commands, job control, and live progress events.
- A CLI for direct local operation.
- Media workflows for MKV tracks, subtitles, disc titles, naming, audio, and metadata.
- Sequence templates that can be stored as YAML or shared through a URL.
Most operations modify files. Mount media with write access and keep a backup or snapshot before the first run.
docker run -d --init --name mux-magic \ -p 3000:3000 \ -e MAX_THREADS=2 \ -e ANIDB_CACHE_FOLDER=/cache/anidb \ -e APP_DATA_DIR=/app/.config \ -v /path/to/media:/media \ -v mux-magic-anidb:/cache/anidb \ -v mux-magic-data:/app/.config \ ghcr.io/sawtaytoes/mux-magic:latest
Open http://localhost:3000. See the setup guide before you add metadata credentials or enable permanent deletion.
- Setup and configuration
- Web interface
- REST API and sequence runner
- CLI commands
- Local development
- Operation guides
- Architecture decisions
corepack yarn install corepack yarn dev
The web interface, API, and Storybook use one port. The default address is http://localhost:3000.