1============== 2id3ren Options 3============== 4 5Please note that the syntax of the option can use the "=" sign or the next 6argument, with or without quotes. So -option ARGUMENT, -option "ARGUMENT", 7-option=ARGUMENT, -option="ARGUMENT" have all the same meaning. 8 9-album=ALBUM_NAME 10 Sets the album name to use when tagging files. All files will be tagged 11 with this album name without prompting. 12 13-artist=ARTIST_NAME 14 Sets the artist name to use when tagging files. All files will be tagged 15 with this artist name without prompting. 16 17-comment=COMMENT 18 Sets the comment to use when tagging files. All files will be tagged 19 with this comment without prompting. 20 21-copyalbum 22 Copies the album field from the source file tag set by -copytagfrom 23 24-copyall 25 Copies all the fields from the source file tag set by -copytagfrom 26 27-copyartist 28 Copies the artist field from the source file tag set by -copytagfrom 29 30-copycomment 31 Copies the comment field from the source file tag set by -copytagfrom 32 33-copygenre 34 Copies the genre field from the source file tag set by -copytagfrom 35 36-copysong 37 Copies the song field from the source file tag set by -copytagfrom 38 39-copytagfrom=FILE 40 Sets the filename to copy tag field from. 41 42-copytrack 43 Copies the track field from the source file tag set by -copytagfrom 44 45-copyyear 46 Copies the year field from the source file tag set by -copytagfrom 47 48-defcase 49 Use the default case of characters from the ID3 tag when renaming files. 50 This is default. 51 52-default=DEFAULT 53 Sets the default field to be used only when renaming if a field is blank. 54 Useful when renaming and creating "unknown" subdirectories. 55 Defaults to "unknown". 56 57-edit 58 If a file already has a tag and you want to change just one specific field 59 of the tag, use this option in conjunction with -tag and the option for 60 the field you want to change. For example to change just the album name 61 of a file: 62 id3ren -tag -edit -album="New Album Name" sample.mp3 63 * This option is a toggle. 64 65-genre=[# | GENRE_NAME] 66 Sets the genre to use when tagging files. All files will be tagged 67 with this genre without prompting. To see a list of allowable genres 68 use the -showgen argument. -genre accepts either the number of the genre 69 as displayed with -showgen, or the name of the genre. 70 71-help 72 Displays the help screen. 73 74-log 75 Log most output to id3ren.log. 76 * This option is a toggle. 77 78-lower 79 Convert file names to lowercase characters. 80 81-noalbum 82 Don't prompt for the album when adding a tag. 83 * This option is a toggle. 84 85-nocfg 86 Don't try reading any config files, even if they exist. 87 * This option is a toggle. 88 89-nocomment 90 Don't prompt for a comment when adding a tag. 91 * This option is a toggle. 92 93-nogenre 94 Don't prompt for a genre when adding a tag. 95 * This option is a toggle. 96 97-notagprompt 98 Never prompt for tag information. Files without tags are skipped. 99 * This option is a toggle. 100 101-notrack 102 Don't prompt for the track number when adding a tag. 103 * This option is a toggle. 104 105-noyear 106 Don't prompt for the year when adding a tag. 107 * This option is a toggle. 108 109-quick 110 Automatically sets -noalbum, -nocomment, and -noyear. 111 112-quiet 113 Run quietly, displaying only errors or prompts. 114 * This option is a toggle. 115 116-remchar=CHARS 117 CHARS indicates a string of characters that will be removed from the 118 filename if found. 119 120-repchar=CHARS 121 CHARS indicates a string of characters, EACH followed by the character to 122 replace it with. For example, to replace all plus '+' signs with a hyphen 123 '-', you would use '-repchar +-'. To do the previous, and also replace 124 all '&' with '_', you would use '-repchar +-&_'. 125 126-searchgen=# | GENRE 127 Searches the list of genres and displays either the genre name 128 corresponding to #, or shows all substring matches of GENRE. 129 130-showgen 131 Displays all the music genres currently in the program. 132 133-showtag 134 Display the tags for the specified files. No renaming is performed. 135 136-song=SONG_NAME 137 Sets the song name to use when tagging files. All files will be tagged 138 with this song name without prompting. 139 140-space=STRING 141 Change all spaces in the renamed file to STRING. To remove all spaces, use 142 '-space=' or '-space=""'. The default space character is ' '. 143 144-striptag 145 Remove the tags for the specified files. 146 * This option is a toggle. 147 148-tag 149 Always ask for a tag, even if the file already has one. 150 * This option is a toggle. 151 152-tagfromfilename, -tagffn 153 Use informations from the filename when tagging. See tagtemplate. 154 * This option is a toggle. 155 156-tagonly 157 Don't rename any files, just ask for tag information. Note that -tagonly 158 only asks for tag information on files that don't have a tag already. 159 To have it ask for a tag on all files, use with -tag. 160 * This option is a toggle. 161 162-tagtemplate=TEMPLATE 163 Use TEMPLATE as the basis for tagging files. The default template used 164 is '[%a]-[%s].mp3'. Identifiers that can be used in the template are: 165 166 %a - Artist name 167 %c - Comment 168 %s - Song name 169 %t - Album title 170 %n - Track Number 171 %y - Year 172 %g - Genre 173 %d - Dummy 174 175 It is a VERY good idea to have fixed separators between fields. 176 177-template=TEMPLATE 178 Use TEMPLATE as the basis for renaming files. The default template used 179 is '[%a]-[%s].mp3'. Identifiers that can be used in the template are: 180 181 %a - Artist name 182 %c - Comment 183 %s - Song name 184 %t - Album title 185 %n - Track Number 186 %y - Year 187 %g - Genre 188 189-track=TRACK 190 Sets the track number to use when tagging files. All files will be 191 tagged with this track number without prompting. 192 TRACK must be an integer between 1 and 99. 193 194-upper 195 Convert file names to uppercase characters. 196 197-verbose 198 Display more messages than usual. 199 * This option is a toggle. 200 201-year=YEAR 202 Sets the year to use when tagging files. All files will be tagged 203 with this year without prompting. 204 205And of course the program accepts wildcards for filenames. 206