Skip to main content

A simple auto-tagging tool for precise music collectors.

Project description


A simple auto-tagging tool for precise music collectors.

This simple tool allows you to automatically tag your audio files by fetching songs information from iTunes APIs and music lyrics from several providers, such as MusixMarch and AZLyrics, directly from your CLI, a GUI version is currently in development. It supports common audio formats such as MP3, AIFF, ALAC (M4A), FLAC and OGG, Wav support has not been added yet due to a missing featured in a required library (mutagen).

Getting Started

Currently this tool is shipped as a CLI tool, GUI application is currently under development and will be released as soon as possible.


If your are going to install this package using pip you don't have to worry about dependencies, however, if you are going to install it manually, all required dependencies are listed in the requirements.txt file, here is a quick list:

  • mutagen: The module used to handle and process the tags from the audio files.
  • beautifulsoup4: The HTML parser used to scrape lyrics providers (couldn't find good quality APIs, sorry).
  • pydub: The module used for file conversion, note that it requires ffmpeg installed in your system.


Installation has been made really simple thanks to the pip package manager, you can easily install this tool by typing in your terminal the following command:

pip install diesis

Once installed you can get a list of all the available options by running:

diesis --help

Contributing, notes and known issues

I made this tool because I broke my HDD containing all my iTunes library. I built my music library very precisely, so I wanted to get it back with all the tags and lyrics associated to the files. Having just the raw files, I had to do all this annoying work manually, then I created this tool, it made me save months of work without having to waste my life finding those information on the internet like I did before.

As I made it a little quickly, it may be not very stable, one known issue is in file conversion, converting files to Apple Alac (.m4a) will leads to an error, I'm currently trying to figure out the issue. Anyone who wants to to add features, fix bugs or just kindly help me to understand this issue in file conversion is free to do it and then open a pull request.

Currently my spare time is short so I couldn't manage to write tests so far, I'll so in a near future.

Last note: some information fetched by this application may be protected copyright, such as lyrics, so use this tool for personal use only, please.


This project is licensed under the MIT License - see the LICENSE.txt file for details.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for Diesis, version 1.0.5
Filename, size File type Python version Upload date Hashes
Filename, size Diesis-1.0.5-py2-none-any.whl (27.4 kB) File type Wheel Python version py2 Upload date Hashes View
Filename, size Diesis-1.0.5.tar.gz (21.2 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page