ASF

Read and write ASF (Window Media Audio) files.

class mutagen.asf.ASF(filething)

Bases: mutagen.FileType

An ASF file, probably containing WMA or WMV.

Parameters:filething (filething) –
info
Type:ASFInfo
tags
Type:ASFTags
load(filething)
Parameters:filething (filething) –
Raises:mutagen.MutagenError
save(filething=None, padding=None)

Save tag changes back to the loaded file.

Parameters:
Raises:

mutagen.MutagenError

add_tags()

Adds new tags to the file.

Raises:mutagen.MutagenError – if tags already exist or adding is not possible.
delete(filething=None)
Parameters:filething (filething) –
Raises:mutagen.MutagenError
static score(filename, fileobj, header)

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.asf.ASFInfo

Bases: mutagen.StreamInfo

ASF stream information.

length

“Length in seconds

Type:float
sample_rate

Sample rate in Hz

Type:int
bitrate

Bitrate in bps

Type:int
channels

Number of channels

Type:int
codec_type

Name of the codec type of the first audio stream or an empty string if unknown. Example: Windows Media Audio 9 Standard

Type:mutagen.text
codec_name

Name and maybe version of the codec used. Example: Windows Media Audio 9.1

Type:mutagen.text
codec_description

Further information on the codec used. Example: 64 kbps, 48 kHz, stereo 2-pass CBR

Type:mutagen.text
pprint()

Returns: text: a stream information text summary

class mutagen.asf.ASFTags

Bases: list, mutagen._util.DictMixin, mutagen.Tags

Dictionary containing ASF attributes.

keys()

Return a sequence of all keys in the comment.

as_dict()

Return a copy of the comment data in a real dict.

pprint()

Returns a string containing all key, value pairs.

Return type:text
class mutagen.asf.ASFBaseAttribute

Generic attribute.

language = None

Language

stream = None

Stream

value = None

The Python value of this attribute (type depends on the class)

class mutagen.asf.ASFBoolAttribute(value)

Bool attribute.

ASFBoolAttribute(True)
Bases:ASFBaseAttribute
class mutagen.asf.ASFGUIDAttribute(value)

GUID attribute.

Bases:ASFBaseAttribute
class mutagen.asf.ASFWordAttribute(value)

WORD attribute.

ASFWordAttribute(42)
Bases:ASFBaseAttribute
class mutagen.asf.ASFDWordAttribute(value)

DWORD attribute.

ASFDWordAttribute(42)
Bases:ASFBaseAttribute
class mutagen.asf.ASFQWordAttribute(value)

QWORD attribute.

ASFQWordAttribute(42)
Bases:ASFBaseAttribute
class mutagen.asf.ASFBoolAttribute(value)

Bool attribute.

ASFBoolAttribute(True)
Bases:ASFBaseAttribute
class mutagen.asf.ASFByteArrayAttribute(value)

Byte array attribute.

ASFByteArrayAttribute(b'1234')
Bases:ASFBaseAttribute
class mutagen.asf.ASFUnicodeAttribute(value)

Unicode string attribute.

ASFUnicodeAttribute(u'some text')
Bases:ASFBaseAttribute
class mutagen.asf.ASFUnicodeAttribute(value)

Unicode string attribute.

ASFUnicodeAttribute(u'some text')
Bases:ASFBaseAttribute