Read and write FLAC Vorbis comments and stream information.
Read more about FLAC at http://flac.sourceforge.net.
FLAC supports arbitrary metadata blocks. The two most interesting ones are the FLAC stream information block, and the Vorbis comment block; these are also the only ones Mutagen can currently read.
This module does not handle Ogg FLAC files.
Based off documentation available at http://flac.sourceforge.net/format.html
Bases: mutagen.FileType
FLAC(filething)
A FLAC audio file.
Parameters: | (filething) (filething) – |
---|
Add a Vorbis comment block to the file.
Remove Vorbis comments from a file.
If no filename is given, the one most recently loaded is used.
Add a new picture to the file.
Parameters: | (Picture) (picture) – |
---|
Delete all pictures from the file.
Returns: | List[Picture]: List of embedded pictures |
---|
Save metadata blocks to a file.
Parameters: |
|
---|
If no filename is given, the one most recently loaded is used.
StreamInfo()
FLAC stream information.
This contains information about the audio data in the FLAC file. Unlike most stream information objects in Mutagen, changes to this one will rewritten to the file when it is saved. Unless you are actually changing the audio stream itself, don’t change any attributes of this block.
int
minimum audio block size
int
maximum audio block size
int
audio sample rate in Hz
int
audio channels (1 for mono, 2 for stereo)
int
bits per sample
int
total samples in file
float
audio length in seconds
int
bitrate in bits per second, as an int
Bases : | mutagen.StreamInfo |
---|
x.__hash__() <==> hash(x)
Picture()
Read and write FLAC embed pictures.
picture type (same as types for ID3 APIC frames)
int
width in pixels
int
height in pixels
int
color depth in bits-per-pixel
int
number of colors for indexed palettes (like GIF), 0 for non-indexed
To create a picture from file (in order to add to a FLAC file), instantiate this object without passing anything to the constructor and then set the properties manually:
p = Picture()
with open("Folder.jpg", "rb") as f:
pic.data = f.read()
pic.type = id3.PictureType.COVER_FRONT
pic.mime = u"image/jpeg"
pic.width = 500
pic.height = 500
pic.depth = 16 # color depth
x.__hash__() <==> hash(x)
CueSheet()
Read and write FLAC embedded cue sheets.
Number of tracks should be from 1 to 100. There should always be exactly one lead-out track and that track must be the last track in the cue sheet.
int
number of lead-in samples
bool
true if the cuesheet corresponds to a compact disc
List[mutagen.flac.CueSheetTrack]
list of CueSheetTrack objects
mutagen.flac.CueSheetTrack or None
lead-out as CueSheetTrack or None if lead-out was not found
x.__hash__() <==> hash(x)
CueSheetTrack()
A track in a cuesheet.
For CD-DA, track_numbers must be 1-99, or 170 for the lead-out. Track_numbers must be unique within a cue sheet. There must be atleast one index in every track except the lead-out track which must have none.
int
track number
int
track offset in samples from start of FLAC stream
int
0 for audio, 1 for digital data
bool
true if the track is recorded with pre-emphasis
List[mutagen.flac.CueSheetTrackIndex]
list of CueSheetTrackIndex objects
x.__hash__() <==> hash(x)
CueSheetTrackIndex(index_number, index_offset)
Index for a track in a cuesheet.
For CD-DA, an index_number of 0 corresponds to the track pre-gap. The first index in a track must have a number of 0 or 1, and subsequently, index_numbers must increase by 1. Index_numbers must be unique within a track. And index_offset must be evenly divisible by 588 samples.
int
index point number
int
offset in samples from track start