MP3

MPEG audio stream information and tags.

class mutagen.mp3.MP3(filething)

Bases: ID3FileType

An MPEG audio (usually MPEG-1 Layer 3) file.

Parameters:: filething (filething)

info

Type:: MPEGInfo

tags

Type:: mutagen.id3.ID3

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:

filename (fspath) – a file path
fileobj (fileobj) – a file object open in rb mode. Position is undefined
header (bytes) – data of undefined length, starts with the start of the file.

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: 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 is BitrateMode.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.