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