This program reads meta data from aiff audio files. The audio stream waveform picture will be rendered into a png image. Album, track information and the waveform picture can be freely used in templated html files.

Following dependencies need to be fullfilled.

pip install mutagen
pip install jinja2
pip install pydub
pip install Pillow

vinyllabel.py [-h] [--template T] [--debug D] PATH

Using conf/config.json you are free to map ID3 meta tags on to keys. Each key will be present in the jinja2 html template. Use --debug argument to print all tags present in a media file.

"keymapping": {
        "album": {
            "name": "TALB",
            "artist": "TPE2",
            "publisher": "TPUB",
            "country": "TXXX:COUNTRY",
            "year": "TDRC"
        },
        "track": {
            "pos": "TRCK",
            "title": "TIT2",
            "artist": "TPE1",
            "key": "TKEY",
            "genre": "TCON",
            "bpm": "TBPM",
            "rpm": "TXXX:TMT/TT",
            "energy": "TXXX:EnergyLevel"
        }
    }

Tag content can be modified freely by regular expressions. In this example key and bpm are getting removed from the track title.

    "regex": {
        "track": {
            "title": "^[0-9]+[a-zA-Z]+ - [0-9]+ - (.*)$"
        }
    }

ID3 tags are generated by programs like iTunes or added later by programs like Mp3tag or TagScanner. Programs like Recordbox, Engine PRIME or Serato are also analysing audio data and thus generating additional meta data.

See mutagen-specs.readthedocs.io for a reference how ID3 tags are being used.

Following keys are coming from the media file header or are altered by vinyltag.

This program uses the jinja2 templating engine. As such you are free to generate any output file format (for example xml or csv). In the default template we are using as demonstration simple html enriched by a css stylesheet.

See jinja.palletsprojects.com as a reference for syntax.

Use the --template argument along with your jinja template file name. You are free to create multiple templates.

Use a folder with the same name as the template for additional data (for example a css stylesheet). This folder gets exported along with the rendered template.