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