Write tags to audio files (mp3, flac, and m4a files are supported) based on their filenames.

To facilitate the tagging of audio files, tags can be generated automatically from the filename of the audio file. Since Napster there are some conventions how to properly name mp3 files - which are followed by this script.

For each album of compilation, the script expects an own directory. For albums the scheme Artist - Album - Tracknumber - Title.mp3 is used whereas for compilations Album - Tracknumber - Artist - Title.mp3 is used. The script automatically determines the total number of tracks that exist within the directory. Compilation tags used by iTunes are automatically set based on the scheme. If enabled, the script also calculates the BPMs by using the Python library librosa. If Cover.jpg exists in the directory it is used as the cover picture.

1.3

usage: py3tag.py [-h] [-V] [-n] [-v] [-b] [-c 4] [-g Electronic] files [files ...]

Writes tags to audio files based on their filenames.

positional arguments:
  files                 List of file(s) and/or directories.

optional arguments:
  -h, --help            show this help message and exit
  -V, --version         Show version.
  -n, --dry-run         Do not do anything, just show what is being done.
  -v, --verbose         Be verbose and show what is being done.
  -b, --disable-bpm     Disable BPM detection.
  -c 4, --cpu 4         Number of cpu cores to use. Default is to use all detected cores
                        and threads.
  -g Electronic, --genre Electronic
                        Genre that is being used. Default is Electronic.

The following additional Python libraries are needed to run the script. They can be best installed via pip.

• audioread
• numpy
• librosa
• mutagen

• fix librosa deprecation issues with numpy

• added flac and m4a support

• librosa now always uses audioread

• added multiprocessing

• small bugfixes

• initial version

BSD-3