MP3¶
MPEG audio stream information and tags.
-
class
mutagen.mp3.
MP3
(filething)¶ Bases:
mutagen.id3.ID3FileType
An MPEG audio (usually MPEG-1 Layer 3) file.
Parameters: filething (filething) –
-
class
mutagen.mp3.
MPEGInfo
¶ Bases:
mutagen.StreamInfo
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. In casebitrate_mode
isBitrateMode.UNKNOWN
the bitrate is guessed based on the first frame.
-
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
¶
-
track_gain
¶ float
orNone
– replaygain track gain (89db) or None
-
track_peak
¶ float
orNone
– replaygain track peak or None
-
album_gain
¶ float
orNone
– 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”
-
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
(filething)¶ Bases:
mutagen.mp3.MP3
Like MP3, but uses EasyID3 for tags.
Parameters: filething (filething) –