1id3ren (C) Copyright 1998 by Robert Alto (badcrc@tscnet.com) 2 (C) Copyright 2001 Christophe Bothamy (cbothamy@free.fr) 3 4======= 5License 6======= 7 8 This program is free software; you can redistribute it and/or modify 9 it under the terms of the GNU General Public License as published by 10 the Free Software Foundation; either version 2 of the License, or 11 (at your option) any later version. 12 13 This program is distributed in the hope that it will be useful, 14 but WITHOUT ANY WARRANTY; without even the implied warranty of 15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 16 GNU General Public License for more details. 17 18 You should have received a copy of the GNU General Public License 19 along with this program; if not, write to the Free Software 20 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. 21 22 23============ 24Introduction 25============ 26id3ren is used to rename batches of mp3 files by reading the ID3 tag 27at the end of the file which contains the song name, artist, album, year, 28and a comment. 29 30The secondary function of id3ren is a tagger, which can create, modify, 31or remove ID3 tags. The id3 fields can be set on the command line, 32entered interactively, or "guessed" from the path and the filename. 33 34If you have questions, comments, or bug reports, contact cbothamy@free.fr 35To get the latest version please visit http://cbothamy.free.fr/projects/id3ren/ 36 37Please refer to the USAGE file for the meaning of the different options. 38Please refer to the FEATURES file to learn more on new features of id3ren. 39 40===== 41Notes 42===== 43- id3ren is developed and tested on linux, but it should work as is 44 on any unix system. 45 46- Windows support is discontinued. It may still work, but it has not been tested 47 id3ren is known to compile fine with cygwin. 48 49- Config files should only contain the exact same options as specified on 50 the command line. You can use # at the beginning of a line for a comment. 51 Spaces at the beginning of a line are ignored. NOTE: There is no more 52 syntax difference between a config file option and a command line option. 53 54- id3ren first reads all command line options. If it doesn't find the 55 "-nocfg" command line option, it looks for config files in this order: 56 1) Reads environment variable ID3REN which should contain the complete 57 path to a config file. If variable doesn't exist or file not found 58 then... 59 2) Reads environment variable HOME and look for $HOME/.id3renrc. 60 If variable doesn't exist or file not found then... 61 3) It looks for /etc/id3renrc. 62 63 64===== 65Ports 66===== 67- a BEOS port has been made by Shayne. 68 See http://curvedspave.org/html/id3ren.html 69- another BEOS port has been made by Scot Hacker. 70 See at http://bebits.com/app/552 71- a FreeBSD port has been made by Joao Carlos Mendes Luis. 72 See http://www.geocrawler.com/archives/3/167/1999/2/0/540206/ 73