ID3REN(1)

✨ ID3REN(1) ✨

okay bestie, pull up a chair, we're doing id3ren from the General Commands Manual today and honestly? it's giving "1998 called and it's still useful" 💖

---

🌸 NAME 🌸

id3ren — reads and writes ID3 tags from mp3 files. that's the whole vibe. 🎀

---

🦋 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]

look at all those brackets. she contains multitudes. ✨

---

👑 COPYRIGHT 👑

this one's a family heirloom, bestie, so we're keeping every single name:

id3 Renamer
   (C) Copyright 1998 by Robert Alto (badcrc@tscnet.com)
   (C) Copyright 2001 Christophe Bothamy (cbothamy@free.fr)

---

💅 DESCRIPTION 💅

okay so <pink>id3ren</pink> is the girl who renames batches of mp3 files. the way she does it? she reads the ID3 tag sitting at the end of the file, which holds the song name, artist, album, year, and a comment. she takes that info and goes to town on your filenames. 🔥

her secondary function — and honestly, main character energy — is being a tagger: she can create, modify, or remove ID3 tags. periodt. 💖

---

🌈 OPTIONS 🌈

• -album ALBUM_NAME — sets the album name to use when tagging files. every file gets tagged with this album name, and she will not prompt you. no questions asked, bestie. 💅
• -album=ALBUM_NAME — same thing, with the equals sign this time. sets the album name to use when tagging files. all files get tagged with this album name, zero prompting. yes she lists it twice, it's a vibe. 🎀
• -artist=ARTIST_NAME — sets the artist name to use when tagging files. all files get tagged with this artist name without prompting. 👑
• -comment=COMMENT — sets the comment to use when tagging files. all files get tagged with this comment, no prompting. 🍓
• -copyalbum — copies the album field from the source file tag you set with -copytagfrom. 🦋
• -copyall — copies all the fields from the source file tag set by -copytagfrom. the whole entire girl. 💖
• -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 fields from. your source-of-truth file, iykyk. 📂
• -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 the default, so if you do nothing, you already have it. slay. 🌸
• -default=DEFAULT — sets the default field used only when renaming, and only if a field is blank. lowkey iconic for 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 it, use this with -tag plus the option for the field you wanna 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 get tagged with this genre without prompting. to see the list of allowable genres, use -showgen. -genre accepts either the number of the genre as displayed with -showgen, or the name of the genre. 🎶
• -help — displays the help screen. we love a helpful queen. 💜
• -log — logs most output to id3ren.log.
  • 🎚️ this option is a toggle.
• -lower — converts 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. she's on a strict no-config diet.
  • 🎚️ 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 get 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. boom, done, in and out. ⚡
• -quiet — run quietly, displaying only errors or prompts.
  • 🎚️ this option is a toggle.
• -remchar=CHARS — CHARS is a string of characters that will be removed from the filename if found. ✂️
• -repchar=CHARS — CHARS is a string of characters, EACH followed by the character to replace it with. for example, to replace all plus '+' signs with a hyphen '-', you'd use -repchar +-. and to do that and also replace all '&' with '_', you'd 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. the full menu, bestie. 📜
• -showtag — displays the tags for the specified files. no renaming is performed. she's just looking, not touching. 👀
• -song=SONG_NAME — sets the song name to use when tagging files. all files get tagged with this song name without prompting. 🎧
• -space=PSTRING — changes all spaces in the renamed file to STRING. to remove all spaces, use -space= or -space="". the default space character is ' '. 🫧
• -striptag — removes the tags for the specified files. bye-bye tag. 💀
  • 🎚️ this option is a toggle.
• -tag — always asks for a tag, even if the file already has one. no assumptions here.
  • 🎚️ 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 info on files that don't already have a tag. to have it ask for a tag on all files, use it with -tag.
  • 🎚️ this option is a toggle.
• -tagtemplate=TEMPLATE — uses TEMPLATE as the basis for tagging files. the default template used is '[%a]-[%s].mp3'. identifiers you can use 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. like, seriously, do not skip the separators, i am begging you. 😭
• -template=TEMPLATE — uses TEMPLATE as the basis for renaming files. the default template used is '[%a]-[%s].mp3'. identifiers you can use 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 get tagged with this track number without prompting. TRACK must be an integer between 1 and 99. 🔢
• -upper — converts file names to uppercase characters. 🔠
• -verbose — displays more messages than usual. she's a talker.
  • 🎚️ this option is a toggle.
• -year=YEAR — sets the year to use when tagging files. all files get tagged with this year without prompting. 🗓️

and of course the program accepts wildcards for filenames. obviously. ✨

---

📁 FILES 📁

• *.mp3 — all your mp3 files. yes, all of them. every last one. 🎧💖

---

🔗 SEE ALSO 🔗

lame(1), xmms(1), mpg123(1), mp3blaster(1) — the whole friend group, go say hi. 🫶

---

🐛 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/. she wants to hear from you, fr fr. 💌

---

okay that's the whole page bestie, we ate and left no crumbs 💅✨

this was ID3REN(1), dated 14 july 2001 — yes, a vintage queen, and she still works. no cap. 🎀🦋