README.md

dita

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.

About

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.

Installation

• 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_tags

Configuration will be initialised through a few simple prompts. The configuration file can be edited subsequently.

Usage

Some convenient entry points are defined as follows:

• poetry run convert_files
• poetry run discogs_rate
• poetry run discogs_release
• poetry run fix_tags
• poetry run move_files
• poetry run pmp

To invoke the scripts from any location, add the following to your .bashrc:

export PATH=$PATH:~/.cache/pypoetry/virtualenvs/dita-*/bin

Contributing

If you find any issues or need any help, please file an issue. Pull requests are also welcome.