MP3
MPEG audio stream information and tags.
-
class mutagen.mp3.MP3(*args, **kwargs)
Bases: mutagen.id3.ID3FileType
MP3(filething)
An MPEG audio (usually MPEG-1 Layer 3) file.
Parameters: | (filething) (filething) – |
-
info(`MPEGInfo`)
-
tags(`mutagen.id3.ID3`)
-
class mutagen.mp3.MPEGInfo(*args, **kwargs)
Bases: mutagen.StreamInfo
MPEGInfo()
MPEG audio stream information
Parse information about an MPEG audio file. This also reads the
Xing VBR header format.
This code was implemented based on the format documentation at
http://mpgedit.org/mpgedit/mpeg_format/mpeghdr.htm.
Useful attributes:
-
length
float
audio length, in seconds
-
channels
int
number of audio channels
-
bitrate
int
audio bitrate, in bits per second
-
sample_rate (`int`) audio sample rate, in Hz
-
encoder_info
mutagen.text
a string containing encoder name and
possibly version. In case a lame tag is present this will start
with "LAME ", if unknown it is empty, otherwise the
text format is undefined.
-
encoder_settings
mutagen.text
a string containing a guess about
the settings used for encoding. The format is undefined and
depends on the encoder.
-
bitrate_mode
BitrateMode
a BitrateMode
-
track_gain
float or None
replaygain track gain (89db) or None
-
track_peak
float or None
replaygain track peak or None
-
album_gain
float or None
replaygain album gain (89db) or None
Useless attributes:
-
version
float
MPEG version (1, 2, 2.5)
-
layer
int
1, 2, or 3
-
mode
int
One of STEREO, JOINTSTEREO, DUALCHANNEL, or MONO (0-3)
-
protected
bool
whether or not the file is “protected”
-
padding (`bool`) whether or not audio frames are padded
-
sketchy
bool
if true, the file may not be valid MPEG audio
-
class mutagen.mp3.BitrateMode
-
UNKNOWN = <BitrateMode.UNKNOWN: 0>
Probably a CBR file, but not sure
-
CBR = <BitrateMode.CBR: 1>
Constant Bitrate
-
VBR = <BitrateMode.VBR: 2>
Variable Bitrate
-
ABR = <BitrateMode.ABR: 3>
Average Bitrate (a variant of VBR)
-
class mutagen.mp3.EasyMP3(*args, **kwargs)
Bases: mutagen.mp3.MP3
EasyMP3(filething)
Like MP3, but uses EasyID3 for tags.
Parameters: | (filething) (filething) – |
-
info(`MPEGInfo`)
-
tags(`mutagen.easyid3.EasyID3`)