Karaokatalog
Tools to manage an Ultrastar DX song library. Features include:
- Deduplication
- Organization
Setup
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
Run
We assume that your song library is stored at $SONG_LIBRARY. Replace this placeholder when running the command, or just set the variable, e.g., like this:
export SONG_LIBRARY=/path/to/library
Deduplication
Find and delete exactly duplicated songs, i.e., songs with the same title and artist that also consist of exactly the same files in the directory.
⚠️ This will irreversibly delete all song folders it considers to be exact duplicates.
ℹ️ Deduplication is (mostly) risk-free: As it only deletes exact duplicates, you will not lose any data (given that I've made no programming errors, which is why the operation is only mostly risk-free).
python3 -m karaokatalog.deduplicate $SONG_LIBRARY
Organization
Rename/move every song folder to $SONG_LIBRARY/<artist>/<title>. If such a folder already exists, a number is appended to distinguish.
ℹ️ Moving will not overwrite already existing files, the operation is therefore risk-free.
python3 -m karaokatalog.organize $SONG_LIBRARY