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) –

info

MPEGInfo

tags

mutagen.id3.ID3

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

sample_rate

int

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

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) –

info

MPEGInfo

tags

mutagen.easyid3.EasyID3