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

FreeBSD Manual Pages

  
 
  

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

NAME
       rebot3 -	rename MP3 files using their corresponding CDDB	entries

SYNOPSIS
       rebot3 [OPTIONS]

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

OPTIONS
       -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
	      inserted 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
	      cddb.cddb.com:8880.

       -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
	      using  the -g option. In this case rebot3	will not try to	calcu-
	      late 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
	      rename)  is  listed  under at the	CDDB (or FreeDB). This is most
	      useful 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
	      symbols:
		- %%, 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)
	      installed.  All  you  have to do to restore the old filenames is
	      typing "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.

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

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

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

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

EXAMPLES
       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 de.freedb.org at port 8880 to
       get the disc information.

	      rebot3 -r	-cs de.freedb.org:8880 -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

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

AUTHOR
       Thomas Weiss _panos@bigfoot.de_

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

								  REBOT3.PL(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | ENVIRONMENT | DIAGNOSTICS | EXAMPLES | BUGS | AUTHOR | SEE ALSO

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

home | help