dr_cdrip(1) [debian man page]

DR_CDRIP(1)							       Draai							       DR_CDRIP(1)

NAME

       dr_cdrip - rip audio cd's to ogg

SYNOPSIS

       dr_cdrip [args] < id3-tag-file

DESCIPTION

       dr_cdrip sets up a cdparanoia(1) - oggenc(1) pipe for each track on your audio cd, so that the audio on your cd will be stored as .ogg
       files on your harddisk. args will get passed to each songs' oggenc(1) invocation.

       id3-tag-file could look like this:

	Jaffa - Star 67
	Think of one - Den Antwaarpse Shabi
	Klute - Angry Woman
	Electrotwist - The Smurfer

       Evil characters are discarded from the file, we don't want them to appear in filenames. If a line lacks a ' - ', the line is assumed to be
       a title.

       Defauls setting of oggenc(1)'s --quality level is 7, override by setting the CDRIP_QUALITY environment variable.

       Note: mp3's id3 tags seem to be called "comments" in the .ogg world.

EXAMPLE

	dj@gelfand ~$ export CDRIP_QUALITY=9
	dj@gelfand /h.../The_New_York_Contemporary_Five$ dr_cdrip 
	 -l "The New York Contemporary Five" -a "Archie Shepp" 
	 -c "description=Don Cherry: crnt, Archie Shepp: ts, Don 
	 Moore: b, JC Moses:d" -c "genre=Jazz" -c "date=1963" 
	 -c "location=Copenhagen" 
	 -c "copyright=1991 Storyville Records" -c "license=All Rights Reserved" 
	 -c "organization=Storyville" 
	 -c "contact=http://www.storyville-records.com/" 
	 -c "diskid=bd10c70d" < /tmp/songlist

       See DISCID HOWTO on http://freedb.org/modules.php?name=Sections&sop=viewarticle&artid=6 for info on disk id.  Beware!  A diskid comment is
       _not_ mentioned in the xiph.org suggestions!

       (oggenc's -t will be used by dr_cdrip. -a might be.)

       supported extra comments are (see ogg123.c)

	VERSION=, TRACKNUMBER=, ISRC=

       ARTIST is -a, ALBUM is -l TITLE is -t.

       VERSION is e.g. 'Biosphere Foo Mix'.  Multipe ARTIST tags can occur; this use is encouraged if applicable.  -c foo will be displayed by
       ogg123 as 'Comment: foo'.

       Run something like:

	cdcd tracks | sed 's/^.*] *//' | sed 's/ $//'

       to extract a songlist from a cddb database.

BUGS

       The format of the songinfo input file is non-standard.  Support for cddb is lacking.

SEE ALSO

       http://xiph.org/ogg/vorbis/doc/v-comment.html

       abcde - A Better CD Encoder at http://www.hispalinux.es/~data/abcde.php

VERSION, SOURCE
       This file is maintained at http://git.mdcc.cx/draai

HISTORY

       First version written 2001-01-09.  Last maintenance, as of 2007-08-22, done at 2005-12-14.

COPYRIGHT

       Copyright: AX 2001-2005 Joost van Baal

       This program is in the public domain.

AUTHOR

       Joost van Baal <spamhere@mdcc.cx>

draai 20100511							    2009-12-16							       DR_CDRIP(1)

VORBISCOMMENT(1)						 Ogg Vorbis Tools						  VORBISCOMMENT(1)

NAME

       vorbiscomment - List or edit comments in Ogg Vorbis files

SYNOPSIS

       vorbiscomment [-l] [-R] [-e] file.ogg
       vorbiscomment -a [ -c commentfile | -t "name=value" ] [-q] [-R] [-e] in.ogg [out.ogg]
       vorbiscomment -w [ -c commentfile | -t "name=value" ] [-q] [-R] [-e] in.ogg [out.ogg]

DESCRIPTION

       vorbiscomment Reads, modifies, and appends Ogg Vorbis audio file metadata tags.

OPTIONS

       -a, --append
	      Append comments.

       -c file, --commentfile file
	      Take  comments from a file. The file is the same format as is output by the the -l option or given to the -t option: one element per
	      line in 'tag=value' format. If the file is /dev/null and -w was passed, the existing comments will be removed.

       -h, --help
	      Show command help.

       -l, --list
	      List the comments in the Ogg Vorbis file.

       -q, --quiet
	      Quiet mode.  No messages are displayed.

       -t 'name=value', --tag 'name=value'
	      Specify a new tag on the command line. Each tag is given as a single string. The part before the '=' is treated as the tag name  and
	      the part after as the value.

       -w, --write
	      Replace  comments  with  the new set given either on the command line with -t or from a file with -c. If neither -c nor -t is given,
	      the new set will be read from the standard input.

       -R, --raw
	      Read and write comments in UTF-8, rather than converting to the user's character set.

       -e, --escapes
	      Quote/unquote newlines and backslashes in the comments. This ensures every comment is exactly one line in  the  output  (or  input),
	      allowing	to  filter and round-trip them. Without it, you can only write multi-line comments by using -t and you can't reliably dis-
	      tinguish them from multiple one-line comments.

	      Supported escapes are c-style "
", "
", "\" and "". A backslash followed by anything else is an error.

	      Note: currently, anything after the first "" is thrown away while writing.  This is a bug -- the Vorbis format	can  safely  store
	      null characters, but most other tools wouldn't handle them anyway.

       -V, --version
	      Display the version of vorbiscomment.

EXAMPLES

       To just see what comment tags are in a file:

	   vorbiscomment -l file.ogg

       To edit those comments:

	   vorbiscomment -l file.ogg > file.txt
	   [edit the comments in file.txt to your satisfaction]
	   vorbiscomment -w -c file.txt file.ogg newfile.ogg

       To simply add a comment:

	   vorbiscomment -a -t 'ARTIST=No One You Know' file.ogg newfile.ogg

       To add a set of comments from the standard input:

	   vorbiscomment -a file.ogg
	   ARTIST=No One You Know
	   ALBUM=The Famous Album
	   <ctrl-d>

TAG FORMAT

       See  http://xiph.org/ogg/vorbis/doc/v-comment.html  for documentation on the Ogg Vorbis tag format, including a suggested list of canonical
       tag names.

AUTHORS

       Program Authors:
	      Michael Smith <msmith@xiph.org>
	      Ralph Giles <giles@xiph.org>

       Manpage Author:
	      Christopher L Cheney <ccheney@debian.org>

SEE ALSO

       oggenc(1), oggdec(1), ogg123(1), ogginfo(1)

Xiph.Org Foundation						 December 30, 2008						  VORBISCOMMENT(1)