Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ID3REN(1)		    General Commands Manual		     ID3REN(1)

NAME
       id3ren -	Reads and writes ID3 tags from mp3 files.

SYNOPSIS
       id3ren	[-help]	 [-song=SONG_NAME]  [-artist=ARTIST_NAME]  [-album=AL-
       BUM_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] [-noal-
       bum] [-nocomment] [-noyear] [-nogenre] [-notrack] [-tag]	[-edit]	 [-no-
       tagprompt  |  -showtag |	-striptag | -tagonly] [-nocfg] [-log] [-quiet]
       [-verbose]   [-defcase	|   -lower    |	   -upper]    [-remchar=CHARS]
       [-repchar=CHARS]	[-space=STRING]	[-tagfromfilename | -tagffn] [-tagtem-
       plate=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	-copy-
	      tagfrom

       -copyall
	      Copies all the fields from the source file  tag  set  by	-copy-
	      tagfrom

       -copyartist
	      Copies  the  artist field	from the source	file tag set by	-copy-
	      tagfrom

       -copycomment
	      Copies the comment field from the	source file tag	set by	-copy-
	      tagfrom

       -copygenre
	      Copies  the  genre  field	from the source	file tag set by	-copy-
	      tagfrom

       -copysong
	      Copies the song field from the source file  tag  set  by	-copy-
	      tagfrom

       -copytagfrom=FILE
	      Sets the filename	to copy	tag field from.

       -copytrack
	      Copies  the  track  field	from the source	file tag set by	-copy-
	      tagfrom

       -copyyear
	      Copies the year field from the source file  tag  set  by	-copy-
	      tagfrom

       -defcase
	      Use  the default case of characters from the ID3 tag when	renam-
	      ing 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" subdirec-
	      tories.
	       Defaults	to "unknown".

       -edit  If a file	already	has a tag and you want to change just one spe-
	      cific 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 -al-
	      bum="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 al-
	      lowable 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  per-
	      formed.

       -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 tagtem-
	      plate.
	       * 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 tem-
	      plate 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 tem-
	      plate 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	cboth-
       amy@free.fr  To	get  the  latest  version,  please visit http://cboth-
       amy.free.fr/projects/id3ren/

				 14 july 2001			     ID3REN(1)

NAME | SYNOPSIS | COPYRIGHT | DESCRIPTION | FILES | SEE ALSO | BOGUS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=id3ren&sektion=1&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help