--- name: "id3ren" section: "1" platform: "linux" package: "id3ren" version: "1.1b0-8" release: "Debian 13 (Trixie)" platforms: ["linux"] url: "https://new.carta.tech/id3ren" --- # id3ren(1) 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* *'-', 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 ## SEE ALSO [lame(1)](/lame/1.md), [xmms(1)](/xmms/1.md), [mpg123(1)](/mpg123/1.md), [mp3blaster(1)](/mp3blaster/1.md) ## BOGUS If you have questions, comments, or bug reports, please contact cbothamy@free.fr To get the latest version, please visit http://cbothamy.free.fr/projects/id3ren/