tunedex¶
A free, local-first, scriptable DJ library manager.
Your music folder, and optionally your beets library, is the source of truth. DJ apps such as Mixxx are targets you sync to safely: every write is planned first, shown as a diff, and backed by a snapshot you can restore.
Alpha
tunedex is young. Try it with a scratch home and a test profile of your DJ app before you point it at the library you play from.
Where to start¶
- New to tunedex? Install it, then follow the tutorial: scan a folder, clean the tags and export to Mixxx in ten minutes.
- Cleaning up a library? The guides cover importing from Mixxx or beets, fixing tags, enriching them from MusicBrainz, merging duplicates, writing tags to your files and renaming files.
- Building an app or a script on top? Read using tunedex from another program, then the JSON formats and the Python API.
- Looking something up? Every command and option is in the command reference.
What it does¶
- Imports your music folder, Mixxx and beets, read only.
- Cleans tags with bundled fixes and your own rules in YAML.
- Recognizes tracks by their sound and takes their tags from MusicBrainz, when you ask it to.
- Finds and merges duplicates, keeping the best file and moving the others to the system trash.
- Writes the cleaned tags into your files, keeping cover art and the audio intact, and renames files from their tags.
- Finds moved files after a disk or a folder changes.
- Exports playlists to Mixxx and M3U.
- Undoes any write: a snapshot is taken before each one.
Principles¶
- Never break your library. Imports are read-only. Writes need a plan, a snapshot and your confirmation. Dry-run is the default. See plan, snapshot, apply.
- Library as code. Cleanup rules live in YAML you can version with git.
- Open data. A documented SQLite database. No accounts, no telemetry, no cloud.
- Headless first. Everything works from the command line, with JSON output for other programs.
- Runs everywhere: Linux, macOS and Windows.
tunedex is free software under the GPL-3.0-or-later license.