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-albumALBUM_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 '-', you would use '-repchar +-'. To do the
previous, and also replace 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 '-space=' or
'-space=""'. The default space character is ' '.
-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 information 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.
Install Now
PNG Icons
