Skip to content

Install

tunedex needs Python 3.11 or later and runs on Linux, macOS and Windows.

Install it as a command-line tool, isolated from your other Python packages:

uv tool install tunedex
pipx install tunedex

Check that it works:

$ tunedex --version

To upgrade later, run uv tool upgrade tunedex or pipx upgrade tunedex.

The development version

Releases come from PyPI. To try what is coming next, install the dev branch instead: uv tool install git+https://github.com/vonmartins/tunedex@dev. It passes every check, but it is not released yet.

Optional: fpcalc for enrich

tunedex enrich recognizes tracks by their sound. It needs fpcalc from Chromaprint on your PATH:

System Command
Arch Linux pacman -S chromaprint
Debian, Ubuntu apt install libchromaprint-tools
macOS brew install chromaprint
Windows Download it from acoustid.org/chromaprint

Nothing else needs fpcalc.

Next

Follow the tutorial.