README
1 MP3-ARCHIVE-TOOLS
2 -----------------
3
4mp3-archive-tools is a set of tools to ease organising a collection of
5mp3 (and other audio types) files.
6
7Tools included:
8
9mp3id - View/change id3 metadata. Supports ID3v2 and extended
10 frames (pictures, etc).
11filenametoid3 - Update id3 metadata from filenames.
12id3tofilename - Rename files based on id3 metadata.
13freedbtofilename - Rename files based on data from freedb
14 webpages (www.freedb.org).
15cddbtofilename - Rename files based on data from cddb
16 webpages (www.gracenote.com).
17movemusic - Move music files to their correct place in
18 your archive.
19pmv - Rename files using arbitrary perl code.
20update-music-symlinks - Maintain a central link farm pointing to music
21 in various places.
22
23There is also a file called pmv-examples.sh, which contain useful
24bourne shell functions. This file is in the examples/ directory of the
25source distribution, and is probably installed under
26/usr/share/doc/mp3-archive-tools/.
27
28Included functions:
29
30pmv-stdswap - Swaps round fields in filenames delimited by " - ".
31pmv-space2_ - converts all spaces in filename to underscores.
32pmv-_2space - Converts all underscores in filename to spaces.
33pmv-fixcaps - Crude attempt at capitalising filenames.
34pmv-fixcase - Much better attempt at capitalising filenames.
35 Needs the Text::Autoformat module from CPAN.
36pmv-number - Numbers filenames sequentially.
37pmv-deepen - converts dirs from "artist - album" to "artist/album"
38pmv-flatten - converts dirs from "artist/album" to "artist - album"
39
40To use these commands, just use: pmv-command filenames
41eg pmv-fixcase *.mp3
42
43DOWNLOADING
44
45The latest version is at
46
47http://nessie.mcc.ac.uk/~ianb/projects/mp3-archive-tools/
48
49You will first need to install libmp3-archive-perl, available from the
50same place, which provides the perl module MP3::Archive, and the
51MP3::Tag module, either from CPAN (www.cpan.org) or your OS
52distribution (debian users install libmp3-tag-perl, redhat/fedora
53users install perl-MP3-Tag)
54
55INSTALLING
56
57To install, you use the standard perl installation method of:
58
59$ tar xzvvf mp3-archive-tools-VERSION.tar.gz
60$ cd mp3-archive-tools-VERSION
61$ perl Makefile.PL
62$ make
63
64then, as root:
65
66# make install
67
68VERSION is the current version, eg 0.9
69
70PORTABILITY
71
72all the tools in mp3-archive-tools should run on any modern unix
73system. I haven't yet tried them under windows. If anyone tries, I would
74appreciate feedback.
75
76I've tried to avoid the latest features of perl, but you may run into
77problems if you have an old version of ExtUtils::MakeMaker (perl's
78installer). Version 6.16 definately works.
79
80TODO
81
82Tools to index music, both on and offline (eg cdroms of mp3s)
83Windows support
84
85
86FEEDBACK
87
88Bug reports, fixes, compliments or (constructive) criticisms would be
89appreciated, to ianb@nessie.mcc.ac.uk.
90
91COPYRIGHT
92
93Copyright 2003 Ian Beckwith <ianb@nessie.mcc.ac.uk>
94
95This program is free software; you can redistribute it and/or modify
96it under the terms of the GNU General Public License as published by
97the Free Software Foundation; either version 2 of the License, or (at
98your option) any later version.
99
100This program is distributed in the hope that it will be useful, but
101WITHOUT ANY WARRANTY; without even the implied warranty of
102MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
103General Public License for more details.
104
105You should have received a copy of the GNU General Public License
106along with this program; if not, write to the Free Software
107Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
108
109
110
111