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

FreeBSD Manual Pages


home | help
REBOT3.PL(1)		    General Commands Manual		  REBOT3.PL(1)

       rebot3 -	rename MP3 files using their corresponding CDDB	entries

       rebot3 [OPTIONS]

       rebot3  is  a utiliy intended for renaming MP3 files using their	corre-
       sponding	CDDB entries. It works best in combination  with  cdda2wav(1),
       but  it	is also	usefull	in combination with other rippers like cdpara-
       noia(1).	 If run	without	any option specified on	the  command  line  it
       looks in	the current directory for the file audio.cddb which is written
       by cdda2wav(1).	Out of this file rebot3	tries to extract the  disc  id
       which  used  to identify	the corresponding CDDB entry. It looks also in
       the current directory for MP3 files containg a one or two digit	number
       in  the	filename (not in the extension ;-). Then it simply renames all
       found MP3 files using a default pattern.	Optionally an ID3 tag  can  be
       attached	 to  the  MP3 files.  rebot3 can retrieve the disc information
       from a remote CDDB over the internet or a local	CDDB,  created	by  cd
       (and other) players like	xmcd(1), kscd, gcd or xmms.

       -r, --remote-cddb
	      retrieve	the  disc  information	from  a	remote CDDB server. If
	      omitted it will use a local CDDB.	The correct CD has to  be  in-
	      serted into your cdrom drive.

       -cs SERVER[:PORT], --cddb-server	SERVER[:PORT]
	      use  SERVER  as CDDB server. Optionally you can specify the port
	      used   to	  connect   to	 the   server.	  The	 default    is

       -cd DEVICE, --cdrom-device DEVICE
	      use DEVICE as cdrom device. Defaults to /dev/cdrom.

       -id ID, --disc-id ID
	      use  ID as disc id, do not look for audio.cddb.  If used in com-
	      bination with remote cddb	mode you have to specify the genre us-
	      ing the -g option. In this case rebot3 will not try to calculate
	      the disc id from the CD in your cdrom drive.

       -if FILE, --id-file FILE
	      look in FILE for the disc	id.

       -g GENRE
	      use GENRE	as the genre the album (the set	of MP3	files  to  re-
	      name) is listed under at the CDDB	(or FreeDB). This is most use-
	      ful in combination with -id in remote CDDB mode,	which  enables
	      you  to use the CDDB even	if you don't have the cd the MP3 files
	      where ripped from	(inserted in your CD drive). You could use the
	      web  interfaces  to CDDB or FreeDB to obtain the disc id and the
	      genre assigned to	the album.

       -G     print the	list of	CDDB genres known  by  the  CDDB  server.   On
	      first use	it should be used in combination with remote CDDB mode
	      to let rebot3 download the list from a CDDB server. It will then
	      save  the	 obtained information in a file	called .cddb-genres in
	      your home	directory.  Next time when used	in local CDDB mode  it
	      will use this file to retrieve the list of known genres.

       -c, --use-cdda2wav
	      use  cdda2wav(1) to determine the	disc id. The correct CD	has to
	      be inserted into your cdrom drive.

       -C, --use-cd
	      calculate	the disc id using the CD in your cdrom drive.

       -db PATH, --cddb-path PATH
	      look in PATH  for	 CDDB  files.  Defaults	 to  ~/.cddb,  ~/cddb,
	      /usr/X11R6/lib/X11/xmcd/cddb and /opt/kde/share/apps/kscd/cddb.

       -x FILE,	--xmms-cdinfo-file FILE
	      use FILE as xmms cdinfo file. Defaults to	~/.xmms/cdinfo.

       -xo, --xmms-cdinfo-only
	      search in	the xmms cdinfo	file only for a	matching CDDB entry.

       -f FILES, --file[s] FILES
	      rename  FILES instead of all the MP3 files in the	current	direc-
	      tory.  This option must be specified as the  last	 one,  because
	      all  options  specified after -f will be treated as normal file-
	      names. If	a filename does	not contain any	track number you  have
	      to specify the correct one with -l.

       -l LIST,	--track-list LIST
	      use LIST instead of the numbers in the filenames.	Multiple track
	      numbers must be seperated	by comma or colon.  This  option  also
	      invokes -S.

       -S, --dont-sort
	      don't sort file list.

       -n NUMBER, --use-number NUMBER
	      use  the	n'th  number (not digit) in the	mp3's filenames	as the
	      track number, where n is specified by NUMBER. Default is to  use
	      the first	number.

       -p PATTERN, --pattern PATTERN
	      rename  files  using PATTERN.  PATTERN may contain the following
		- %%, means a single %
		- %a or	%{artist}, mean	the artist's name
		- %b or	%{album}, mean the album name
		- %n or	%{number}, mean	the track number
		- %t or	%{title}, mean the track title.
	      PATTERN defaults to "%b -	%n - %t".

       -t, --add-id3-tag[s]
	      append ID3 tag to	each file. The comment section of the tag will
	      be used for storing the track number.

       -to, --id3tag[s]-only
	      append ID3 tags only, do not rename files.

       -T, --remove-tag[s]
	      remove ID3 tag from each file.

       -u [UNDOFILE], --undo [UNDOFILE]
	      create  an  undo	file wich enables you to restore the old file-
	      names in case the	result of renaming is not what	you  expected.
	      This defaults to undo but	you can	specify	another	name with UND-
	      OFILE.  To be able to use	this file you  must  have  mmv(1)  in-
	      stalled. All you have to do to restore the old filenames is typ-
	      ing "cat UNDOFILE	| mmv".

       -uo [UNDOFILE], --undo-only [UNDOFILE]
	      same as above with the difference	that only  the	undo  file  is
	      created and no file is renamed.

       -s, --silent
	      supress any output (except error messages	and warnings).

       -q, --quiet
	      same as above.

       -d, --debug
	      do not rename files, just	print the resulting names to STDOUT.

       -h, --help
	      print a short summary of all available commands.

	      may  contain a list of paths (seperated by colons) where to look
	      for CDDB files.  Overridden by -db option.

	      may contain a default pattern. Overridden	by -p option.

	      may contain the a	default	CDDB server,  where  server  and  port
	      have to be seperated by a	colon. Overridden by -cs option.

       If all oprations	complete successfully rebot3 exits with	status 0, oth-
       erwise it returns a non-zero status.

       The following example is	usefull	when run in combination	 with  cdpara-
       noia(1).	 It  uses  the CD in the cdrom drive to	calculate the disc id,
       uses a local CDDB, renames all mp3 files	in the current directory  that
       have  a	one  or	 two digit number in the filename, appends ID3 tags to
       these files and creates an undo file.

	      rebot3 -C	-t -u

       The next	example	uses the cdrom drive at	/dev/hdc to get	the CD's table
       of  contents  and  the remote CDDB server at port 8880 to
       get the disc information.

	      rebot3 -r	-cs -cd /dev/hdc

       This example will use a local CDDB to get the information about a  disc
       with  the  id  3b115617	and  then  rename  foo.mp3  to	03 - The Black
       Rider.mp3 and bar.mp3 to	19 - Jesus Gonna Be Here.mp3.

	      rebot3 -id 3b115617 -p '%n - %t' -l 4,20 -f foo.mp3 bar.mp3

       The last	example	uses the disc id  06118912  in	combination  with  the
       genre  misc  to	fetch  the correct disc	information from a remote cddb
       server, renames the files found in the current working directory	 using
       this  information and creates an	undo file. This	way don't need to have
       the correct CD in your cdrom drive.

	      rebot3 -r	-id 06118912 -g	misc -u

       Not known but maybe there are a few. Drop me a mail if you find one.

       Thomas Weiss _panos@bigfoot.de_

       cdda2wav(1), cdparanoia(1), mmv(1), xmcd(1)



Want to link to this manual page? Use this URL:

home | help