Beatport Tracktagger

Ever bought tracks from beatport that didn't have tags in it? Or you simply wanted to tag files automatically, by scraping?

This multithread tagging tool uses fuzzy string matching to do the work. It's capable of getting useful tags from beatport (-s) and assigning them into audio file (-t). You can overwrite existing tags in file (-f).

Even though it's able to tag files only using title and artist in attributes (-z), tagger works best with beatport id in front of the filename e.g. 5024319_track.mp3 (that's format from bought beatport tracks). You can change the format of the id regex though. (see Usage)

Fuzzy matching uses probabilities, instead of exact 'yes' or 'no' matching. It can return false match, when info is not accurate enough or when beatport doesn't know about the release yet. I noticed that Beatport sometimes change the id of tracks.

Dependency: Python >= 3.6

Installation

# clone this project
git clone https://github.com/cromize/beatport_tracktagger.git

# install dependencies
pip3 install -r requirements.txt

# run
./tracktagger.py -t -s -a -i some/path

Usage

# it runs from working directory, when no path is supplied

# get tags from beatport into local db, doesn't update actual files
./tracktagger.py -s

# tag files with tags from local db
./tracktagger.py -t

# save artwork from beatport (500x500)
./tracktagger.py -a

# clean all tags and artwork
./tracktagger.py -c

# run recursively
./tracktagger.py -r

# scrape info from file and match using fuzzy matching
./tracktagger.py -z

# specify beatport id regex (default is "^([0-9]+)")
./tracktagger.py --beatport-id-regex "^[0-9]+"

# force tag overwrite
./tracktagger.py -ft

# get tags and artwork from beatport and update local files
./tracktagger.py -t -s -a

# run from supplied path with all possible options (including sub-folders)
./tracktagger.py -t -s -a -r -i some/path

Example

# run with file
./tracktagger.py -t -s -a -r -i 93252_mytrack.mp3

# run with files from mymusicfolder
./tracktagger.py -t -s -a -r -i mymusicfolder

# run with specific beatport id naming
./tracktagger.py -t -s -a -r -i mymusicfolder --beatport-id-regex "[0-9]+$"

# run with files from mymusicfolder with fuzzy matching
./tracktagger.py -t -s -a -r -z -i mymusicfolder

Supported formats

FLAC
MP3

Libraries Used

urllib3 for pulling webpage
lxml for parsing info
mutagen for assigning tags to files
fuzzywuzzy for fuzzy string matching
unidecode for text normalization

cromize / beatport_tracktagger

readme