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) –
- tags
- Type:
- property mime
A list of mime types (
mutagen.text
)
- static score(filename, fileobj, header_data)
Returns a score for how likely the file can be parsed by this type.
- Parameters:
- Returns:
- negative if definitely not a matching type, otherwise a score,
the bigger the more certain that the file can be loaded.
- Return type:
int
- 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
audio length, in seconds
- Type:
float
- channels
number of audio channels
- Type:
int
- bitrate
audio bitrate, in bits per second. In case
bitrate_mode
isBitrateMode.UNKNOWN
the bitrate is guessed based on the first frame.- Type:
int
- sample_rate
audio sample rate, in Hz
- Type:
int
- encoder_info
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.- Type:
- encoder_settings
a string containing a guess about the settings used for encoding. The format is undefined and depends on the encoder.
- Type:
- bitrate_mode
-
- Type:
- track_gain
replaygain track gain (89db) or None
- Type:
float
orNone
- track_peak
replaygain track peak or None
- Type:
float
orNone
- album_gain
replaygain album gain (89db) or None
- Type:
float
orNone
Useless attributes:
- version
MPEG version (1, 2, 2.5)
- Type:
float
- layer
1, 2, or 3
- Type:
int
- mode
One of STEREO, JOINTSTEREO, DUALCHANNEL, or MONO (0-3)
- Type:
int
- protected
whether or not the file is “protected”
- Type:
bool
- sketchy
if true, the file may not be valid MPEG audio
- Type:
bool
- 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) –
- tags
- Type: