Skip to content

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

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.