GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  ID3REN (1)

NAME

id3ren - Reads and writes ID3 tags from mp3 files.

CONTENTS

Synopsis
Copyright
Description
     Options
Files
Bogus

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

-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 informations 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), xmms(1), mpg123(1), mp3blaster(1)

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/
Search for    or go to Top of page |  Section 1 |  Main Index


--> ID3REN (1) 14 july 2001

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.