openbsd-ports/audio/mp3cddb/pkg/DESCR
espie 39c49b2f64 Various minor clean-ups:
- use new CONFIGURE_STYLE
- use PLIST/DESCR substitution to add HOMEPAGE and various fragments
- add systematic @comment $OpenBSD$ to PLIST
- remove FAKE=Yes
2000-06-10 17:39:11 +00:00

96 lines
4.2 KiB
Plaintext

mp3cddb
-------
About
-----
Mp3cddb is a small perl script that helps you recognizing your unknown
music albums. If you have a complete music album in MPEG layer III
(.mp3) compressed audio format, but you don't know its artist/title/the
names of the songs/etc, you only know that it's a complete album and the
files are in a correct order (e.g. track01.mp3, etc), mp3cddb analyzes
these files and tries to identify the album using the compact disc
database at www.cddb.com. If this database contains information about
the album you're looking for, mp3cddb saves all information in a file
called "cddbinfo.txt". This information usually consists of the performer,
the title of the album and the titles of the tracks. You can then edit
this plain textfile, if necessary, insert any additional information
(comment, year, genre) or modify the existing. Then mp3cddbtag, a small
shell script (also included) processes this file, tags (adds these
information to the .mp3 file using the ID3v1 format) and renames your
.mp3 files.
Requirements
------------
This system has been written and tested on a Linux system and it
requires the GNU Bourne Again Shell (bash). This is included in the
most of Linux distributions, but is also downloadable at
ftp://prep.ai.mit.edu/pub/gnu/bash/.
Additional software required:
* a Perl interpreter (http://www.perl.com)
* the CDDB module for Perl
(http://www.perl.com/CPAN/authors/id/R/RC/RCAPUTO/CDDB-1.02.tar.gz)
* the MPEG::MP3Info module for Perl
(http://www.perl.com/CPAN/authors/id/CNANDOR/MPEG-MP3Info-0.71.tar.gz)
* the mp3info program (ftp://bimbo.hive.no/pub/mp3info/)
The Perl interpreter and mp3info are likely available in pre-made
packages for your distribution. If you use Debian GNU/Linux, you need
the following packages: perl, mp3info. For more information, visit the
website of your distribution.
Usage
-----
First, try to identify your files using mp3cddb. Please note, that the
order of the files does matter, since CDDB stores the information
about albums using an identification number, which is calculated using
the order and the lenght of the tracks. The names of the files are not
important, as long they are in the correct order (alphabetically). If
you've got the information in cddbinfo.txt, modify it according to
your needs, then run mp3cddbtag to tag & rename your files.
Example:
[bali 00:16 ~/jamiroquai]$ ls -la
total 26873
drwxr-xr-x 2 bali users 1024 Nov 25 00:16 .
drwxr-xr-x 57 bali users 6144 Nov 25 00:15 ..
-rw-r--r-- 1 bali users 5874284 May 12 1999 1.mp3
-rw-r--r-- 1 bali users 7159436 May 12 1999 2.mp3
-rw-r--r-- 1 bali users 6209954 May 12 1999 3.mp3
-rw-r--r-- 1 bali users 8151582 May 12 1999 4.mp3
[bali 00:16 ~/jamiroquai]$ mp3cddb *
searching for discid: 1d047304, total tracks: 4, total time: 1139 ...
trying us.cddb.com:8880...
match: rock 31047b04 Jamiroquai/Virtual Insanity
saving information to cddbinfo.txt...
[bali 00:17 ~/jamiroquai]$ mp3cddbtag cddbinfo.txt
processing cddbinfo.txt (Jamiroquai / Virtual Insanity)...
tagging 4 tracks...
1. Jamiroquai / Virtual Insanity (Virtual Insanity) [Other]
2. Jamiroquai / Do You Know Where You're Comin (Virtual Insanity) [Other]
3. Jamiroquai / Bullet (Virtual Insanity) [Other]
4. Jamiroquai / Virtual Insanity(Album Version (Virtual Insanity) [Other]
done.
[bali 00:17 ~/jamiroquai]$
Author
------
The mp3cddb script is based on the mp3tocddb script of Meng Weng Wong.
Minor modifications, this page and the mp3cddb script were made by
Andras Bali. The original mp3tocddb script by Meng Weng Wong is
included in the MPEG::MP3Info module for Perl (see Requirements).
Contacting me
-------------
Please feel free to contact me if you have ideas, suggestions,
problems, found some bugs, or just want to tell me what you think of
it.
* E-mail: drewie@bigfoot.com
* IRC: [drewie] on iRCnet, usually channels #linux.hu and #mp3.hu
* ICQ: 13555242 (please use it only when it's absolutely neccessary, because it sucks
* WWW: ${HOMEPAGE}