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

Previous topic

Monkey’s Audio

Next topic

MP4

This Page