README
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