Audio::TagLib::AudioProperties - A simple, abstract interface to common audio properties


The values here are common to most audio formats. For more specific, codec dependant values, please see see the subclasses APIs. This is meant to compliment the Audio::TagLib::File and Audio::TagLib::Tag APIs in providing a simple interface that is sufficient for most applications.


Reading audio properties from a file can sometimes be very time consuming and for the most accurate results can often involve reading the entire file. Because in many situations speed is critical or the accuracy of the values is not particularly important this allows the level of desired accuracy to be set.

keys %Audio::TagLib::AudioProperties::_ReadStyle lists all available values used in Perl code.

see FLAC::Properties MPC::Properties MPEG::Properties Vorbis::Properties


Destroys this AudioProperties instance.

length() [pure virtual]

Returns the lenght of the file in seconds.

bitrate() [pure virtual]

Returns the most appropriate bit rate for the file in kb/s. For constant bitrate formats this is simply the bitrate of the file. For variable bitrate formats this is either the average or nominal bitrate.

sampleRate() [pure virtual]

Returns the sample rate in Hz.

channels() [pure virtual]

Returns the number of audio channels.


None by default.




Dongxu Ma, <>


Copyright (C) 2005 by Dongxu Ma

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.7 or, at your option, any later version of Perl 5 you may have available.