artcom-net / mp3-tagger

ID3 data editor
MIT License
35 stars 16 forks source link

ID3 data editor

This Python package allows to access ID3 tags in MP3 files. There are the usual operations such as set, get, update, delete.

Prerequisites


- Python 3.x

Supported ID3 versions:

- 1.x

- 2.2

- 2.3

- 2.4

Usage

.. code-block:: python

from mp3_tagger import MP3File, VERSION_1, VERSION_2, VERSION_BOTH

# Create MP3File instance.
mp3 = MP3File(path_to_mp3)

# Get/set/del tags value.
 alb = mp3.album
 mp3.album = 'some title..'
 del mp3.album

"""
Allowed tags:

    - artist;
    - album;
    - song;
    - track;
    - comment;
    - year;
    - genre;
    - band (version 2.x);
    - composer (version 2.x);
    - copyright (version 2.x);
    - url (version 2.x);
    - publisher (version 2.x).
"""

# Get all tags.
tags = mp3.get_tags()
print(tags)

"""
Output:
{'ID3TagV1': {'song': 'Prowler', 'artist': 'Iron Maiden', 'album': 'Iron Maiden',
'year': '1980', 'comment': None, 'track': 1, 'genre': 'Other'},
'ID3TagV2': {'artist': 'Iron Maiden', 'band': 'Iron Maiden', 'album': 'Iron Maiden',
'song': 'Prowler', 'track': '1/9', 'genre': 'Heavy Metal', 'year': '1980'}}
"""

# By default selected tags in both versions.
mp3.set_version(VERSION_BOTH)

# Change to 2.x version.
mp3.set_version(VERSION_2)

# For 1.x version
mp3.set_version(VERSION_1)

# After the tags are edited, you must call the save method.
mp3.save()