id3ren1
Reads and writes id3 tags from mp3 files.
Usage
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}]
Overview
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.
Files
*.mp3 All your mp3 files
Bogus
If you have questions, comments, or bug reports, please contact [email protected] To get the latest version, please visit http://cbothamy.free.fr/projects/id3ren/
Releases
12 releases since Debian 3.0 (Woody); the text changed 1 time.