Free mp3 file software for linux

MP3::Tag::File is a Perl module for reading / writing files.

SYNOPSIS

my $mp3 = MP3::Tag->new($filename);

($title, $artist, $no, $album, $year) = $mp3->parse_filename();
see MP3::Tag

MP3::Tag::File is designed to be called from the MP3::Tag module.
It offers possibilities to read/write data from files via read(), write(), truncate(), seek(), tell(), open(), close(); one can find the filename via the filename() method.
parse_filename()

($title, $artist, $no, $album, $year) = $mp3->parse_filename($what, $filename);

parse_filename() tries to extract information about artist, title, track number, album and year from the filename. (For backward compatibility it may be also called by deprecated name read_filename().)

This is likely to fail for a lot of filenames, especially the album will be often wrongly guessed, as the name of the parent directory is taken as album name.

$what and $filename are optional. $what maybe title, track, artist, album or year. If $what is defined parse_filename() will return only this element.

If $filename is defined this filename will be used and not the real filename which was set by MP3::Tag with MP3::Tag-new($filename)>. Otherwise the actual filename is used (subject to configuration variable decode_encoding_filename).

Following formats will be hopefully recognized:

- album name/artist name - song name.mp3
- album_name/artist_name-song_name.mp3
- album.name/artist.name_song.name.mp3
- album name/(artist name) song name.mp3
- album name/01. artist name - song name.mp3
- album name/artist name - 01 - song.name.mp3

If artist or title end in (NUMBER) with 4-digit NUMBER, it is considered the year.
title()

$title = $mp3->title($filename);

Returns the title, guessed from the filename. See also parse_filename(). (For backward compatibility, can be called by deprecated name song().)

$filename is optional and will be used instead of the real filename if defined.

artist()

$artist = $mp3->artist($filename);

Returns the artist name, guessed from the filename. See also parse_filename()

$filename is optional and will be used instead of the real filename if defined.

track()

$track = $mp3->track($filename);

Returns the track number, guessed from the filename. See also parse_filename()

$filename is optional and will be used instead of the real filename if defined.

year()

$year = $mp3->year($filename);

Returns the year, guessed from the filename. See also parse_filename()

$filename is optional and will be used instead of the real filename if defined.

album()

$album = $mp3->album($filename);

Returns the album name, guessed from the filename. See also parse_filename() The album name is guessed from the parent directory, so it is very likely to fail.

$filename is optional and will be used instead of the real filename if defined.
comment()

$comment = $mp3->comment($filename); # Always undef

genre()

$genre = $mp3->genre($filename); # Always undef

MP3::Find is a Perl module to search and sort MP3 files based on their ID3 tags.

SYNOPSIS

# select with backend you want
use MP3::Find qw(Filesystem);

print "$_n" foreach find_mp3s(
dir => /home/peter/cds,
query => {
artist => ilyaimy,
title => deep in the am,
},
ignore_case => 1,
exact_match => 1,
sort => [qw(year album tracknum)],
printf => %2n. %a - %t (%b: %y),
);

This module allows you to search for MP3 files by their ID3 tags. You can ask for the results to be sorted by one or more of those tags, and return either the list of filenames (the deault), a printf-style formatted string for each file using its ID3 tags, or the actual Perl data structure representing the results.

There are currently two backends to this module: MP3::Find::Filesystem and MP3::Find::DB. You choose which one you want by passing its name as the argument to you use statement; MP3::Find will look for a MP3::Find::$BACKEND module. If no backend name is given, it will default to using MP3::Find::Filesystem.
Note: Im still working out some kinks in the DB backend, so it is currently not as stable as the Filesystem backend.

Note the second: This whole project is still in the alpha stage, so I can make no guarentees that there wont be significant interface changes in the next few versions or so. Also, comments about what about the API rocks (or sucks!) are appreciated.

MP3::Find::Base is a base class for MP3::Find backends.

SYNOPSIS

package MyFinder;
use base MP3::Find::Base;

sub search {
my $self = shift;
my ($query, $dirs, $sort, $options) = @_;

# do something to find and sort the mp3s...
my @results = do_something(...);

return @results;
}

package main;
my $finder = MyFinder->new;

# see MP3::Find for details about %options
print "$_n" foreach $finder->find_mp3s(%options);

This is the base class for the classes that actually do the searching and sorting for MP3::Find.

findmp3 is a program that searches through directory trees for mp3-files. This information is retrieved from the id3(v2) tags in an mp3-file. The syntax of the commandline is very similar to that of the find command.
Enhancements:
- added -x switch which lets findmp3 continue when errors are detected

MP3 as CD verifier 2 performs lookups on CDDB servers in an attempt to determine whether one or multiple directories of downloaded/ripped MP3 files has correct track lengths.
Please remember that mp3ascd uses the alphabetically sorted list of .mp3 files per directory Hence it is possible that if your filenames are somehow mismatched (case?), they may be sorted incorrectly. If youre getting a mismatch that you think is wrong, run mp3ascd with default options to make sure that the enumerated list of files it finds is sorted correctly.
To install, firstly make sure the script is executable.
I copy mine into a directory in my PATH, such as /usr/bin/. It should work on a multitude of platforms, but if it does not work on yours, please let me know.
Enhancements:
- Improved readability
- Summary reports (recursive), including non-matching directories
- ID3 tag presence info shown in full display mode

MP3::Tag::CDDB_File is a Perl module for parsing CDDB files.

SYNOPSIS

my $db = MP3::Tag::CDDB_File->new($filename, $track); # Name of MP3 file
my $db = MP3::Tag::CDDB_File->new_from($record, $track); # Contents of CDDB

($title, $artist, $album, $year, $comment, $track) = $db->parse();
see MP3::Tag

MP3::Tag::Inf is designed to be called from the MP3::Tag module.

It parses the content of CDDB file.

The file is found in the same directory as MP3 file; the list of possible file names is taken from the field cddb_files if set by MP3::Tag config() method.
parse()

($title, $artist, $album, $year, $comment, $track) =
$db->parse($what);

parse_filename() extracts information about artist, title, track number, album and year from the CDDB record. $what is optional; it maybe title, track, artist, album, year, genre or comment. If $what is defined parse() will return only this element.

Additionally, $what can take values artist_collection (returns the value of artist in the disk-info field DTITLE, but only if author is specified in the track-info field TTITLE), title_track (returns the title specifically from track-info field - the track may fall back to the info from disk-info field), comment_collection (processed EXTD comment), comment_track (processed EXTT comment).

The returned year and genre is taken from DYEAR, DGENRE, EXTT, EXTD fields; recognized prefixes in the two last fields are YEAR, ID3Y, ID3G. The declarations of this form are stripped from the returned comment.

An alternative syntax "Recorded"/"Recorded on"/"Recorded in"/ is also supported; the format of the date recognized by ID3v2::year(), or just a date field without a prefix.

title()

$title = $db->title();

Returns the title, obtained from the Tracktitle entry of the file.

artist()

$artist = $db->artist();

Returns the artist name, obtained from the Performer or Albumperformer entries (the first which is present) of the file.

track()

$track = $db->track();

Returns the track number, stored during object creation.

year()

$year = $db->year();

Returns the year, obtained from the Year entry of the file. (Often not present.)

album()

$album = $db->album();

Returns the album name, obtained from the Albumtitle entry of the file.

comment()

$comment = $db->comment();

Returns the Trackcomment entry of the file. (Often not present.)

genre()

$genre = $db->genre($filename);

MP3::Icecast is a Perl module to generate Icecast streams, as well as M3U and PLSv2 playlists.

SYNOPSIS

use MP3::Icecast;
use MP3::Info;
use IO::Socket;


my $listen_socket = IO::Socket::INET->new(
LocalPort => 8000, #standard Icecast port
Listen => 20,
Proto => tcp,
Reuse => 1,
Timeout => 3600);

#create an instance to find all files below /usr/local/mp3
my $finder = MP3::Icecast->new();
$finder->recursive(1);
$finder->add_directory(/usr/local/mp3);
my @files = $finder->files;

#accept TCP 8000 connections
while(1){
next unless my $connection = $listen_socket->accept;

defined(my $child = fork()) or die "Cant fork: $!";
if($child == 0){
$listen_socket->close;

my $icy = MP3::Icecast->new;

#stream files that have an ID3 genre tag of "jazz"
while(@files){
my $file = shift @files;
my $info = new MP3::Info $file;
next unless $info;
next unless $info->genre =~ /jazz/i;
$icy->stream($file,0,$connection);
}
exit 0;
}

#a contrived example to demonstrate that MP3::Icecast
#can generate M3U and PLSv2 media playlists.
print STDERR $icy->m3u, "n";
print STDERR $icy->pls, "n";

$connection->close;
}

ABSTRACT

MP3::Icecast supports streaming Icecast protocol over socket or other filehandle (including STDIN). This is useful for writing a streaming media server.
MP3::Icecast also includes support for generating M3U and PLSv2 playlist files. These are common formats supported by most modern media players, including XMMS, Windows Media Player 9, and Winamp.

Sort MP3 is a script was made to help in organizing MP3s. If you have one directory with allot of mp3s and the names are not very readable you can run this script against them. It will read the id tag of a mp3 and rename the file to the title of the song but with _ instead of spaces. It can also create a directory structure from the id tag if the -c option is used. The structure will be put in the same directory the mp3s are in. It will be something like: "/BANDNAME/CDTITLE/SONG.mp3"

Usage: sort_mp3.pl [options]
Options should be separated by a space and my be
in any order.

-c Create a directory structure from the mp3 tag.
It is made inside the directory holding the un-named mp3s.
If not set the files will just be renamed.
Example: "/BANDNAME/CDTITLE/SONG.mp3"

-d= Path to the directory where mp3s can be found.
There should be no / at the end and no spaces.
Example: "-d=/unsorted_mp3s"