ID3REN(1)						      General Commands Manual							 ID3REN(1)

NAME

       id3ren - Reads and writes ID3 tags from mp3 files.

SYNOPSIS

       id3ren	[-help]   [-song=SONG_NAME]   [-artist=ARTIST_NAME]  [-album=ALBUM_NAME]  [-year=YEAR]	[-genre={#  |  GENRE}]	[-comment=COMMENT]
       [-track=TRACK] [-showgen] [-searchgen={# | GENRE}] [-default=DEFAULT] [-copytagfrom=FILE [-copysong] [-copyartist] [-copyalbum] [-copyyear]
       [-copygenre]  [-copycomment]  [-copytrack]  [-copyall]  ]  [-quick]  [-noalbum] [-nocomment] [-noyear] [-nogenre] [-notrack] [-tag] [-edit]
       [-notagprompt | -showtag | -striptag | -tagonly] [-nocfg]  [-log]  [-quiet]  [-verbose]	[-defcase  |  -lower  |  -upper]  [-remchar=CHARS]
       [-repchar=CHARS] [-space=STRING] [-tagfromfilename | -tagffn] [-tagtemplate=TAGTEMPLATE] [-template=TEMPLATE] [FILE1 FILE2.. | WILDCARDS]

COPYRIGHT

       id3 Renamer
	  (C) Copyright 1998 by Robert Alto (badcrc@tscnet.com)
	  (C) Copyright 2001 Christophe Bothamy (cbothamy@free.fr)

DESCRIPTION

       id3ren  is  used  to rename batches of mp3 files by reading the ID3 tag at the end of the file which contains the song name, artist, album,
       year, and a comment.  The secondary function of id3ren is a tagger, which can create, modify, or remove ID3 tags.

   OPTIONS
       -album ALBUM_NAME
	      Sets the album name to use when tagging files. All files will be tagged with this album name without prompting.

       -album=ALBUM_NAME
	      Sets the album name to use when tagging files. All files will be tagged with this album name without prompting.

       -artist=ARTIST_NAME
	      Sets the artist name to use when tagging files. All files will be tagged with this artist name without prompting.

       -comment=COMMENT
	      Sets the comment to use when tagging files. All files will be tagged with this comment without prompting.

       -copyalbum
	      Copies the album field from the source file tag set by -copytagfrom

       -copyall
	      Copies all the fields from the source file tag set by -copytagfrom

       -copyartist
	      Copies the artist field from the source file tag set by -copytagfrom

       -copycomment
	      Copies the comment field from the source file tag set by -copytagfrom

       -copygenre
	      Copies the genre field from the source file tag set by -copytagfrom

       -copysong
	      Copies the song field from the source file tag set by -copytagfrom

       -copytagfrom=FILE
	      Sets the filename to copy tag field from.

       -copytrack
	      Copies the track field from the source file tag set by -copytagfrom

       -copyyear
	      Copies the year field from the source file tag set by -copytagfrom

       -defcase
	      Use the default case of characters from the ID3 tag when renaming files.	This is default.

       -default=DEFAULT
	      Sets the default field to be used only when renaming if a field is blank.  Useful when renaming and creating  "unknown"  subdirecto-
	      ries.
	       Defaults to "unknown".

       -edit  If  a file already has a tag and you want to change just one specific field of the tag, use this option in conjunction with -tag and
	      the option for the field you want to change.  For example to change just the album name of a file:  id3ren  -tag	-edit  -album="New
	      Album Name" sample.mp3
	       * This option is a toggle.

       -genre=# | GENRE_NAME
	      Sets  the  genre	to use when tagging files. All files will be tagged with this genre without prompting.	To see a list of allowable
	      genres use the -showgen argument.  -genre accepts either the number of the genre as displayed with -showgen,  or	the  name  of  the
	      genre.

       -help  Displays the help screen.

       -log   Log most output to id3ren.log.
	       * This option is a toggle.

       -lower Convert file names to lowercase characters.

       -noalbum
	      Don't prompt for the album when adding a tag.
	       * This option is a toggle.

       -nocfg Don't try reading any config files, even if they exist.
	       * This option is a toggle.

       -nocomment
	      Don't prompt for a comment when adding a tag.
	       * This option is a toggle.

       -nogenre
	      Don't prompt for a genre when adding a tag.
	       * This option is a toggle.

       -notagprompt
	      Never prompt for tag information.  Files without tags are skipped.
	       * This option is a toggle.

       -notrack
	      Don't prompt for the track number when adding a tag.
	       * This option is a toggle.

       -noyear
	      Don't prompt for the year when adding a tag.
	       * This option is a toggle.

       -quick Automatically sets -noalbum, -nocomment, and -noyear.

       -quiet Run quietly, displaying only errors or prompts.
	       * This option is a toggle.

       -remchar=CHARS
	      CHARS indicates a string of characters that will be removed from the filename if found.

       -repchar=CHARS
	      CHARS  indicates	a  string  of characters, EACH followed by the character to replace it with.  For example, to replace all plus '+'
	      signs with a hyphen all '&' with '_', you would use '-repchar +-&_'.

       -searchgen=# | GENRE
	      Searches the list of genres and displays either the genre name corresponding to #, or shows all substring matches of GENRE.

       -showgen
	      Displays all the music genres currently in the program.

       -showtag
	      Display the tags for the specified files.  No renaming is performed.

       -song=SONG_NAME
	      Sets the song name to use when tagging files. All files will be tagged with this song name without prompting.

       -space=PSTRING
	      Change all spaces in the renamed file to STRING. To remove all spaces, use

       -striptag
	      Remove the tags for the specified files.
	       * This option is a toggle.

       -tag   Always ask for a tag, even if the file already has one.
	       * This option is a toggle.

       -tagfromfilename, -tagffn
	      Use informations from the filename when tagging. See tagtemplate.
	       * This option is a toggle.

       -tagonly
	      Don't rename any files, just ask for tag information.  Note that -tagonly only asks for tag information on files that don't  have  a
	      tag already.  To have it ask for a tag on all files, use with -tag.
	       * This option is a toggle.

       -tagtemplate=TEMPLATE
	      Use  TEMPLATE  as  the  basis for tagging files.	The default template used is '[%a]-[%s].mp3'.  Identifiers that can be used in the
	      template are:
		%a  - Artist name
		%c  - Comment
		%s  - Song name
		%t  - Album title
		%n  - Track Number
		%y  - Year
		%g  - Genre
		%d  - Dummy
	       It is a VERY good idea to have fixed separators between fields.

       -template=TEMPLATE
	      Use TEMPLATE as the basis for renaming files.  The default template used is '[%a]-[%s].mp3'.  Identifiers that can be  used  in  the
	      template are:
		%a  - Artist name
		%c  - Comment
		%s  - Song name
		%t  - Album title
		%n  - Track Number
		%y  - Year
		%g  - Genre

       -track=TRACK
	      Sets  the  track number to use when tagging files. All files will be tagged with this track number without prompting.  TRACK must be
	      an integer between 1 and 99.

       -upper Convert file names to uppercase characters.

       -verbose
	      Display more messages than usual.
	       * This option is a toggle.

       -year=YEAR
	      Sets the year to use when tagging files. All files will be tagged with this year without prompting.

       And of course the program accepts wildcards for filenames.

FILES

       *.mp3 All your mp3 files

SEE ALSO

       lame(1), xmms(1), mpg123(1), mp3blaster(1)

BOGUS

       If you have questions, comments, or bug reports, please contact cbothamy@free.fr To get the  latest  version,  please  visit  http://cboth-
       amy.free.fr/projects/id3ren/

								   14 july 2001 							 ID3REN(1)