Ubuntu Manpage: id3ren - Reads and writes ID3 tags from mp3 files.

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" subdirectories.
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

BOGUS