Millwright is a self-hosted FFmpeg automation tool. Convert individual files or apply rules to a library to change codecs, containers, audio tracks, and subtitles.
Warning
I've tested NVIDIA, Intel QSV, and software encoders on my own library AMD encoders are not tested.
- WatchState: Sync your media servers without relying on 3rd parties.
- YTPTube: Media downloader, automation, and library manager for yt-dlp.
- DCompose: Manage your servers/nodes compose stacks from one WebUI.
Dashboard:
Statistics:
Job details:
Add a Library and preview a Flow to see which files it would change. Nodes run conversions on the server or on other machines. Millwright checks the output before replacing the original.
Warning
Keep originals in Trash while trying a new flow.
- Convert video with software or hardware encoders.
- Remux MKV and MP4 files, convert selected audio tracks, and filter tracks by language.
- Extract subtitles, burn subtitles into video, and embed metadata from NFO or yt-dlp sidecars.
- Use conditions to apply different processing to different files.
- Schedule processing, wait for new files to finish copying, and pause work without cancelling active jobs.
- Play media in the browser and inspect conversion logs, progress, and before-and-after media details.
- Restore retained originals and track disk space saved.
- Receive import notifications from Sonarr or Radarr and notify them after a conversion.
Follow the installation guide to run the installer, claim a node, and add your first library. See the documentation index for setup guides and references.
Millwright is built for my own needs and use cases first. Discuss contributions with me before starting any work that i may decline to accept. Read CONTRIBUTING.md. I use AI tools in this project. You're welcome to use the project if it works for you. However, if you object to that, then this project is not good fit for you. Build your own using technologies you approve of.
For short questions, join the Discord server. Millwright is maintained as a solo project, so replies may take some time.
If you want to support the work financially, please donate to a children's charity such as Make-A-Wish international instead.


