MP3WRAP(1) General Commands Manual MP3WRAP(1)NAME
mp3wrap -- Utility for mp3 wrapping
SYNOPSIS
mp3wrap [options] OUTPUTFILE f1.mp3 f2.mp3 [f3.mp3]...
DESCRIPTION
Mp3Wrap is a free command-line utility, which wraps two or more mp3 files in one large playable file, without losing filename and ID3
informations. It's useful to make large files easy to download on internet and then easy to split again in few seconds. You can split orig-
inal files using mp3splt: http://mp3splt.sourceforge.net
Mp3Wrap will create a file named: OUTPUTFILE_MP3WRAP.mp3. It's important you don't remove the MP3WRAP string, because this will tell the
split program Mp3Splt that the file is wrapped and can be splitted just with -w option. There is also the possibility to specify a custom
extension to created file (such as "OUTPUTFILE - MP3WRAP - wrapped by me.mp3"). This can be done using config file (see below), just adding
the line "EXT=my ext.mp3" into it. Note that your custom extension must contain MP3WRAP string anywhere, otherwise program will add it by
itself.
Mp3Wrap will also add to the file a ID3v2 containing informations on how to split the file; you can change Title and Album tags but PLEASE
DO NOT REMOVE THE COMMENT.
OPTIONS -a Add specified files to an existing Mp3Wrap file. Files are appended and the index is updated.
-l List all files wrapped into a Mp3Wrap file. Doesn't extract anything
-v Verbose mode. Mp3Wrap will display additional informations on process and, when using list option (-l) it will show many extra
infos on wrapped files.
CONFIGURATION FILE
For Linux version valid configuration files are:
~/.mp3wrap (in home directory)
.mp3wrap (in the dir you are in that moment).
For WIN32 version:
PROG_DIR/mp3wrap.ini (dir where mp3wrap.exe is)
mp3wrap.ini (in the dir you are in that moment).
FILE FORMAT
The file consists of key-value pairs in the form
KEY=value
where key contains no whitespace and no equal signs. value will be all of the text after the equal sign until (but not including) the end-
ing newline. Beware of extra spaces at the end of the line! They will probably be interpreted as part of the option value.
Valid option keys are:
EXT The extension mp3wrap will append to created files.
Here is an example:
EXT=_MP3WRAP_wrapped by me.mp3
EXAMPLES
mp3wrap album.mp3 file1.mp3 file2.mp3 file3.mp3 file4.mp3
mp3wrap -v album.mp3 file*.mp3
mp3wrap -a album.mp3 file5.mp3 file6.mp3
mp3wrap -l album.mp3
mp3wrap -lv album.mp3
BUGS
Report any bugs you find to Author (see below). Advices and info requests are welcome.
SEE ALSO mp3splt(1)AUTHOR
Matteo Trotta <mtrotta@users.sourceforge.net>.
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License. This can be found
as COPYING in mp3wrap directory.
MP3WRAP(1)
Check Out this Related Man Page
MP3::Tag::File(3pm) User Contributed Perl Documentation MP3::Tag::File(3pm)NAME
MP3::Tag::File - Module for reading / writing files
SYNOPSIS
my $mp3 = MP3::Tag->new($filename);
($title, $artist, $no, $album, $year) = $mp3->parse_filename();
see MP3::Tag
DESCRIPTION
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
perl v5.14.2 2009-11-28 MP3::Tag::File(3pm)