Bases: object
Fundamental unit of ID3 data.
ID3 tags are split into frames. Each frame has a potentially different structure, and so this base class is not very featureful.
ID3v2 three or four character frame ID
An internal key used to ensure frame uniqueness in a tag
Construct this ID3 frame from raw string data.
Return a human-readable representation of the frame.
Bases: mutagen._id3frames.Frame
Binary data
The ‘data’ attribute contains the raw byte string.
Bases: mutagen._id3frames.Frame
A frame with optional parts.
Some ID3 frames have optional data; this class extends Frame to provide support for those parts.
Bases: mutagen._id3frames.Frame
Paired text strings.
Some ID3 frames pair text strings, to associate names with a more specific involvement in the song. The ‘people’ attribute of these frames contains a list of pairs:
[['trumpet', 'Miles Davis'], ['bass', 'Paul Chambers']]
Like text frames, these frames also have an encoding attribute.
Bases: mutagen._id3frames.Frame
Text strings.
Text frames support casts to unicode or str objects, as well as list-like indexing, extend, and append.
Iterating over a TextFrame iterates over its strings, not its characters.
Text frames have a ‘text’ attribute which is the list of strings, and an ‘encoding’ attribute; 0 for ISO-8859 1, 1 UTF-16, 2 for UTF-16BE, and 3 for UTF-8. If you don’t want to worry about encodings, just set it to 3.
Append a string.
Extend the list by appending all strings from the given list.
Bases: mutagen._id3frames.Frame
A frame containing a URL string.
The ID3 specification is silent about IRIs and normalized URL forms. Mutagen assumes all URLs in files are encoded as Latin 1, but string conversion of this frame returns a UTF-8 representation for compatibility with other string conversions.
The only sane way to handle URLs in MP3s is to restrict them to ASCII.
Bases: mutagen._id3frames.TextFrame
Multivalue numerical text strings.
These strings indicate ‘part (e.g. track) X of Y’, and unary plus returns the first value:
frame = TRCK('4/15')
track = +frame # track == 4
Bases: mutagen._id3frames.TextFrame
Numerical text strings.
The numeric value of these frames can be gotten with unary plus, e.g.:
frame = TLEN('12345')
length = +frame
Bases: mutagen._id3frames.TextFrame
A list of time stamps.
The ‘text’ attribute in this frame is a list of ID3TimeStamp objects, not a list of strings.
Bases: mutagen._id3frames.UrlFrame
Bases: mutagen._id3frames.FrameOpt
Audio encryption.
Attributes:
Mutagen cannot decrypt files.
Bases: mutagen._id3frames.Frame
Attached (or linked) Picture.
Attributes:
Mutagen will automatically compress large images when saving tags.
Bases: mutagen._id3frames.Frame
Audio seek point index.
Attributes: S, L, N, b, and Fi. For the meaning of these, see the ID3v2.4 specification. Fi is a list of integers.
Bases: mutagen._id3frames.TextFrame
User comment.
User comment frames have a descrption, like TXXX, and also a three letter ISO language code in the ‘lang’ attribute.
Bases: mutagen._id3frames.FrameOpt
Commercial frame.
Bases: mutagen._id3frames.Frame
Encryption method registration.
The standard does not allow multiple ENCR frames with the same owner or the same method. Mutagen only verifies that the owner is unique.
Bases: mutagen._id3frames.Frame
Equalisation (2).
Attributes: method – interpolation method (0 = band, 1 = linear) desc – identifying description adjustments – list of (frequency, vol_adjustment) pairs
Bases: mutagen._id3frames.Frame
Event timing codes.
Bases: mutagen._id3frames.Frame
General Encapsulated Object.
A blob of binary data, that is not a picture (those go in APIC).
Attributes:
Bases: mutagen._id3frames.FrameOpt
Group identification registration.
Bases: mutagen._id3frames.TIPL
Involved People List
Bases: mutagen._id3frames.FrameOpt
Linked information.
Attributes:
Bases: mutagen._id3frames.BinaryFrame
Binary dump of CD’s TOC
Bases: mutagen._id3frames.Frame
MPEG location lookup table.
This frame’s attributes may be changed in the future based on feedback from real-world use.
Bases: mutagen._id3frames.Frame
Ownership frame.
Bases: mutagen._id3frames.Frame
Play counter.
The ‘count’ attribute contains the (recorded) number of times this file has been played.
This frame is basically obsoleted by POPM.
Bases: mutagen._id3frames.FrameOpt
Popularimeter.
This frame keys a rating (out of 255) and a play count to an email address.
Attributes:
Bases: mutagen._id3frames.Frame
Position synchronisation frame
Attribute:
Bases: mutagen._id3frames.Frame
Private frame.
Bases: mutagen._id3frames.FrameOpt
Recommended buffer size.
Attributes:
Mutagen will not find the next tag itself.
Bases: mutagen._id3frames.Frame
Relative volume adjustment (2).
This frame is used to implemented volume scaling, and in particular, normalization using ReplayGain.
Attributes:
When storing ReplayGain tags, use descriptions of ‘album’ and ‘track’ on channel 1.
Bases: mutagen._id3frames.Frame
Reverb.
Bases: mutagen._id3frames.Frame
Seek frame.
Mutagen does not find tags at seek offsets.
Bases: mutagen._id3frames.Frame
Signature frame.
Bases: mutagen._id3frames.Frame
Synchronised lyrics/text.
Bases: mutagen._id3frames.Frame
Synchronised tempo codes.
This frame’s attributes may be changed in the future based on feedback from real-world use.
Bases: mutagen._id3frames.TextFrame
Album
Bases: mutagen._id3frames.NumericTextFrame
Beats per minute
Bases: mutagen._id3frames.NumericTextFrame
iTunes Compilation Flag
Bases: mutagen._id3frames.TextFrame
Composer
Bases: mutagen._id3frames.TextFrame
Content type (Genre)
ID3 has several ways genres can be represented; for convenience, use the ‘genres’ property rather than the ‘text’ attribute.
A list of genres parsed from the raw text data.
Bases: mutagen._id3frames.TextFrame
Copyright (c)
Bases: mutagen._id3frames.TextFrame
Date of recording (DDMM)
Bases: mutagen._id3frames.TimeStampTextFrame
Encoding Time
Bases: mutagen._id3frames.TextFrame
iTunes Podcast Description
Bases: mutagen._id3frames.NumericTextFrame
Audio Delay (ms)
Bases: mutagen._id3frames.TimeStampTextFrame
Original Release Time
Bases: mutagen._id3frames.TimeStampTextFrame
Recording Time
Bases: mutagen._id3frames.TimeStampTextFrame
Release Time
Bases: mutagen._id3frames.TimeStampTextFrame
Tagging Time
Bases: mutagen._id3frames.TextFrame
Encoder
Bases: mutagen._id3frames.TextFrame
Lyricist
Bases: mutagen._id3frames.TextFrame
File type
Bases: mutagen._id3frames.TextFrame
iTunes Podcast Identifier
Bases: mutagen._id3frames.TextFrame
Time of recording (HHMM)
Bases: mutagen._id3frames.PairedTextFrame
Involved People List
Bases: mutagen._id3frames.TextFrame
Content group description
Bases: mutagen._id3frames.TextFrame
Title
Bases: mutagen._id3frames.TextFrame
Subtitle/Description refinement
Bases: mutagen._id3frames.TextFrame
Starting Key
Bases: mutagen._id3frames.TextFrame
Audio Languages
Bases: mutagen._id3frames.NumericTextFrame
Audio Length (ms)
Bases: mutagen._id3frames.PairedTextFrame
Musicians Credits List
Bases: mutagen._id3frames.TextFrame
Source Media Type
Bases: mutagen._id3frames.TextFrame
Mood
Bases: mutagen._id3frames.TextFrame
Original Album
Bases: mutagen._id3frames.TextFrame
Original Filename
Bases: mutagen._id3frames.TextFrame
Original Lyricist
Bases: mutagen._id3frames.TextFrame
Original Artist/Performer
Bases: mutagen._id3frames.NumericTextFrame
Original Release Year
Bases: mutagen._id3frames.TextFrame
Owner/Licensee
Bases: mutagen._id3frames.TextFrame
Lead Artist/Performer/Soloist/Group
Bases: mutagen._id3frames.TextFrame
Band/Orchestra/Accompaniment
Bases: mutagen._id3frames.TextFrame
Conductor
Bases: mutagen._id3frames.TextFrame
Interpreter/Remixer/Modifier
Bases: mutagen._id3frames.NumericPartTextFrame
Part of set
Bases: mutagen._id3frames.TextFrame
Produced (P)
Bases: mutagen._id3frames.TextFrame
Publisher
Bases: mutagen._id3frames.NumericPartTextFrame
Track Number
Bases: mutagen._id3frames.TextFrame
Recording Dates
Bases: mutagen._id3frames.TextFrame
Internet Radio Station Name
Bases: mutagen._id3frames.TextFrame
Internet Radio Station Owner
Bases: mutagen._id3frames.NumericTextFrame
Size of audio data (bytes)
Bases: mutagen._id3frames.TextFrame
iTunes Album Artist Sort
Bases: mutagen._id3frames.TextFrame
Album Sort Order key
Bases: mutagen._id3frames.TextFrame
iTunes Composer Sort
Bases: mutagen._id3frames.TextFrame
Perfomer Sort Order key
Bases: mutagen._id3frames.TextFrame
Title Sort Order key
Bases: mutagen._id3frames.TextFrame
International Standard Recording Code (ISRC)
Bases: mutagen._id3frames.TextFrame
Encoder settings
Bases: mutagen._id3frames.TextFrame
Set Subtitle
Bases: mutagen._id3frames.TextFrame
User-defined text data.
TXXX frames have a ‘desc’ attribute which is set to any Unicode value (though the encoding of the text and the description must be the same). Many taggers use this frame to store freeform keys.
Bases: mutagen._id3frames.NumericTextFrame
Year of recording
Bases: mutagen._id3frames.Frame
Unique file identifier.
Attributes:
Bases: mutagen._id3frames.Frame
Terms of use.
Attributes:
Bases: mutagen._id3frames.Frame
Unsynchronised lyrics/text transcription.
Lyrics have a three letter ISO language code (‘lang’), a description (‘desc’), and a block of plain text (‘text’).
Bases: mutagen._id3frames.UrlFrameU
Commercial Information
Bases: mutagen._id3frames.UrlFrame
Copyright Information
Bases: mutagen._id3frames.UrlFrame
iTunes Podcast Feed
Bases: mutagen._id3frames.UrlFrame
Official File Information
Bases: mutagen._id3frames.UrlFrameU
Official Artist/Performer Information
Bases: mutagen._id3frames.UrlFrame
Official Source Information
Bases: mutagen._id3frames.UrlFrame
Official Internet Radio Information
Bases: mutagen._id3frames.UrlFrame
Payment Information
Bases: mutagen._id3frames.UrlFrame
Official Publisher Information
Bases: mutagen._id3frames.UrlFrame
User-defined URL data.
Like TXXX, this has a freeform description associated with it.
Bases: mutagen._id3frames.RBUF
Recommended buffer size
Bases: mutagen._id3frames.PCNT
Play counter
Bases: mutagen._id3frames.COMM
Comment
Bases: mutagen._id3frames.AENC
Audio encryption
Bases: mutagen._id3frames.Frame
Encrypted meta frame
Bases: mutagen._id3frames.ETCO
Event timing codes
Bases: mutagen._id3frames.GEOB
General Encapsulated Object
Bases: mutagen._id3frames.IPLS
Involved people list
Bases: mutagen._id3frames.LINK
Linked information
Bases: mutagen._id3frames.MCDI
Binary dump of CD’s TOC
Bases: mutagen._id3frames.MLLT
MPEG location lookup table
Bases: mutagen._id3frames.APIC
Attached Picture.
The ‘mime’ attribute of an ID3v2.2 attached picture must be either ‘PNG’ or ‘JPG’.
Bases: mutagen._id3frames.POPM
Popularimeter
Bases: mutagen._id3frames.RVRB
Reverb
Bases: mutagen._id3frames.SYLT
Synchronised lyrics/text
Bases: mutagen._id3frames.SYTC
Synced tempo codes
Bases: mutagen._id3frames.TALB
Album
Bases: mutagen._id3frames.TBPM
Beats per minute
Bases: mutagen._id3frames.TCOM
Composer
Bases: mutagen._id3frames.TCON
Content Type (Genre)
Bases: mutagen._id3frames.TCMP
iTunes Compilation Flag
Bases: mutagen._id3frames.TCOP
Copyright (C)
Bases: mutagen._id3frames.TDAT
Date of recording (DDMM)
Bases: mutagen._id3frames.TDLY
Audio Delay (ms)
Bases: mutagen._id3frames.TENC
Encoder
Bases: mutagen._id3frames.TFLT
File Type
Bases: mutagen._id3frames.TIME
Time of recording (HHMM)
Bases: mutagen._id3frames.TKEY
Starting Key
Bases: mutagen._id3frames.TLAN
Audio Language(s)
Bases: mutagen._id3frames.TLEN
Audio Length (ms)
Bases: mutagen._id3frames.TMED
Source Media Type
Bases: mutagen._id3frames.TOPE
Original Artist/Perfomer
Bases: mutagen._id3frames.TOFN
Original Filename
Bases: mutagen._id3frames.TOLY
Original Lyricist
Bases: mutagen._id3frames.TORY
Original Release Year
Bases: mutagen._id3frames.TOAL
Original Album
Bases: mutagen._id3frames.TPE1
Lead Artist/Performer/Soloist/Group
Bases: mutagen._id3frames.TPE2
Band/Orchestra/Accompaniment
Bases: mutagen._id3frames.TPE3
Conductor
Bases: mutagen._id3frames.TPE4
Interpreter/Remixer/Modifier
Bases: mutagen._id3frames.TPOS
Part of set
Bases: mutagen._id3frames.TPUB
Publisher
Bases: mutagen._id3frames.TSRC
International Standard Recording Code (ISRC)
Bases: mutagen._id3frames.TRDA
Recording Dates
Bases: mutagen._id3frames.TRCK
Track Number
Bases: mutagen._id3frames.TSIZ
Audio Data size (bytes)
Bases: mutagen._id3frames.TSSE
Encoder settings
Bases: mutagen._id3frames.TIT1
Content group description
Bases: mutagen._id3frames.TIT2
Title
Bases: mutagen._id3frames.TIT3
Subtitle/Description refinement
Bases: mutagen._id3frames.TEXT
Lyricist
Bases: mutagen._id3frames.TXXX
User-defined Text
Bases: mutagen._id3frames.TYER
Year of recording
Bases: mutagen._id3frames.UFID
Unique File Identifier
Bases: mutagen._id3frames.USLT
Unsychronised lyrics/text transcription
Bases: mutagen._id3frames.WOAF
Official File Information
Bases: mutagen._id3frames.WOAR
Official Artist/Performer Information
Bases: mutagen._id3frames.WOAS
Official Source Information
Bases: mutagen._id3frames.WCOM
Commercial Information
Bases: mutagen._id3frames.WCOP
Copyright Information
Bases: mutagen._id3frames.WPUB
Official Publisher Information
Bases: mutagen._id3frames.WXXX
User-defined URL