A command-line interface for automated mp3 file tagging using data from Discogs, inspired by the foo_discogs component for foobar2000.
Only Linux is officially supported at this time.
Goals set out in the development of the project include:
- Retrieval of data through the Discogs REST API
- Wrangling and validation of data, often of varying quality
- Semi-automated writing of audio metadata
- A minimal REPL for manual metadata fixes
- Data visualization
Since these goals have largely been met and I am reasonably satisfied with its present scope, this project is effectively in maintenance mode.
While there is an underlying Python interface to the Discogs API, which probably has similarities to that of the joalla team's client, exposing it to the user has not been the primary objective of the project.
- Install poetry
- Generate a Discogs API token
git clone https://github.com/hejops/dita
cd dita
# in case you want to remove existing installation
# ~/.cache/pypoetry/virtualenvs/dita-*
poetry install
poetry run fix_tagsConfiguration will be initialised through a few simple prompts. The configuration file can be edited subsequently.
Some convenient entry points are defined as follows:
poetry run convert_filespoetry run discogs_ratepoetry run discogs_releasepoetry run fix_tagspoetry run move_filespoetry run pmp
To invoke the scripts from any location, add the following to your .bashrc:
export PATH=$PATH:~/.cache/pypoetry/virtualenvs/dita-*/binIf you find any issues or need any help, please file an issue. Pull requests are also welcome.