Free audio files to mp3 converter software for linux

Audio::File::AudioProperties is a Perl module that can abstract an audio files audio properties.

Audio::File::AudioProperties is the base class for other file format independant audio property classes like Audio::File::Flac::AudioProperties or Audio::File::Ogg::AudioProperties. You should not use this class yourself exept youre writing an own file format dependant subclass.

METHODS

new

Constructor. Creates new Audio::File::AudioProperties object. You shoud not use this method yourself. Its called by the filetype-dependant subclasses of Audio::File::Type automatically.

init

Initializes the object. Its called by the constructor and empty by default. Its ought to be overwritten by subclasses.

length

Returns the length of the audio file in seconds.

bitrate

Returns the bitrate of the file.

sample_rate

Returns the sample rate of the audio file.

channels

Returns the number of channels the audio file has.

all

Get all audio properties.

Audio::File::Type represents an audio filetype.

An instance of an object inherited from Audio::File::Type is returned by the constructor of Audio::File. This object currently provides access to the audio files information like its audio properties (bitrate, sample rate, number of channels, ...) and the data stored in the files tag, but also providing access to the raw audio data and other information should be easy to be implemented.

METHODS

new

Constructor. In fact you dont need to use it. Please use Audio::File which will call the appropriate constructor corresponding to the files type.

init

This method will be called by the constructor. Its empty by default and should be overwritten by inheriting subclasses to initialize themselfes.

name

Returns the name of the audio file.

is_readable

Checks whether the file is readable or not. At the moment its only used by the constructor, but it will be more usefull with later versions of Audio::File.

is_writeable

Checks whether the file is writeable or not. At the moment youll probably dont need to call this method, but itll be more usefull as soon as changing the audio file is implemented.

tag

Returns a reference to the files tag object. See the documentation of Audio::File::Tag to learn about what the tag object does.

audio_properties

Returns a reference to the files audio properties object. See the documentation of Audio::File::AudioProperties to get information about what the audio properties object does.

save

Saves the audio file. This is not yet implemented but it should remember me to do it at some time..

type

Returns the files type.

AudioFile::Info::MP3::Info is a Perl extension to get info from MP3 files.

This is a plugin for AudioFile::Info which uses MP3::ID3Lib to get data about MP files.

See AudioFile::Info for more details.

METHODS

new

Creates a new object of class AudioFile::Info::MP3::Info. Usually called by AudioFile::Info::new.

Audio::File is a audio file abstraction library.

SYNOPSIS

use Audio::File;
my $file = Audio::File->new( "foo.bar" );

print "The ". $file->type() ."-file ". $file->name
." is ". int $file->length() ." seconds long.n";

print "Its interpreted by ". $file->tag->artist()
." and called ". $file->tag->title() ".n";

Audio::File abstracts a single audio file, independant of its format. Using this module you can access a files meta-info like title, album, etc. as well as the files audio-properties like its length and bitrate.

Currently only the formats flac, ogg vorbis and mp3 are supported, but support for other formats may be easily added.

AudioFile::Info is a Perl extension to get info from audio files.

SYNOPSIS

use AudioFile::Info;

my $song = AudioFile::Info->new($some_mp3_or_ogg_vorbis_file);

print Title: , $song->title, "n",
Artist: , $song->artist, "n".
Album: , $song->album, "n",
Track: , $song->track, "n";
Year: , $song->year, "n",
Genre: , $song->genre, "n";

$song->title(something else); # Changes the title

ABSTRACT

AudioFile::Info is a simple way to get track information out of an audio file. It gives a unified interface for extracting information from both MP3 and Ogg Vorbis files.
Some AudioFile::Info plugins also have the ability to write data back to the file.

FAPG is a tool to generate list of audio files (WAV, MP3, Ogg, etc.) in various formats (M3U, PLS, HTML, etc). It is very useful for quickly creating a playlist of a large number of audio files.

It is coded in C to be as fast as possible, and does not use any specific audio library (like ID3Lib).
This allow you to deploy it faster and easier, and to have better performances since the less informations are loaded.
In the other hand, this tool is not (yet) compatible with all the known formats.

Here are some examples for usage :

Generate a PLS playlist for an album :
fapg --format=pls --output=~/path/to/album/list.pls ~/path/to/album

You have a file server using Samba which shares a large amount of audio files for Windows powered computers using Winamp.
The directory on the server containing the files is "/samba/mp3" and is visible on the Windows network as "serveurmp3" :
fapg --backslash --output=/samba/mp3/list.m3u --prefix=servermp3 --recursive --windows /samba/mp3

An HTML playlist for an album :
fapg --output=fapg.html ~/path/to/album
Here is the result : fapg.html

Audio::TagLib::MPEG::Properties is an implementation of audio property reading for MP3.

SYNOPSIS

use Audio::TagLib::MPEG::Properties;

my $f = Audio::TagLib::MPEG::File->new("sample file.mp3");
my $i = $f->audioProperties();
print $i->layer(), "n"; # got 3

This reads the data from an MPEG Layer III stream found in the AudioProperties API.
new(PV $file, PV $style = "Average")

Create an instance of MPEG::Properties with the data read from the MPEG::File $file.

DESTROY()

Destroys this MPEG Properties instance.

IV length()

IV bitrate()

IV sampleRate()

IV channels()

see AudioProperties

PV version()

Returns the MPEG Version of the file.

see Audio::TagLib::MPEG::Header

IV layer()

Returns the layer version. This will be between the values 1-3.

BOOL protectionEnabled()

Returns true if the MPEG protection bit is enabled.

PV channelMode()

Returns the channel mode for this frame.

see Audio::TagLib::MPEG::Header

BOOL isCopyrighted()

Returns true if the copyrighted bit is set.

BOOL isOriginal()

Returns true if the "original" bit is set.