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 distinguish them from multiple one-line comments.

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

          Note:  currently,  anything  after the first "\0" 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://www.xiph.org/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)


More Linux Commands

manpages/glib-compile-schemas.1.html
glib-compile-schemas(1) - GSettings schema compiler.........
glib-compile-schemas compiles all the GSettings XML schema files in DIRECTORY into a binary file with the name gschemas.compiled that can be used by GSettings.

manpages/FcConfigSetCurrent.3.html
FcConfigSetCurrent(3) - Set configuration as default........
Sets the current default configuration to config. Implicitly calls FcConfigBuildFonts if necessary, returning FcFalse if that call fails. VERSION Fontconfig ver

manpages/readv.2.html
readv(2) - read or write data into multiple buffers.........
The readv() system call reads iovcnt buffers from the file associated with the file descriptor fd into the buffers described by iov (scatter input). The writev(

manpages/gst-inspect-0.10.1.html
gst-inspect-0.10(1) - print info about a GStreamer plugin or
gst-inspect is a tool that prints out information on available GStreamer plugins, information about a particular plugin, or information about a particular eleme

manpages/Opcode.3pm.html
Opcode(3pm) - Disable named opcodes when compiling perl code
Perl code is always compiled into an internal format before execution. Evaluating perl code (e.g. via eval or do file) causes the code to be compiled into an in

manpages/gnutls_record_recv.3.html
gnutls_record_recv(3) - API function - Linux manual page....
This function has the similar semantics with recv(). The only difference is that it accepts a GnuTLS session, and uses different error codes. In the special cas

manpages/ripoffline_sp.3ncurses.html
ripoffline_sp(3ncurses) - curses screen-pointer extension...
This implementation can be configured to provide a set of functions which improve the ability to manage multiple screens. This feature can be added to any of th

manpages/fabsl.3.html
fabsl(3) - absolute value of floating-point number (ManPage)
These functions return the absolute value of the floating-point number x. RETURN VALUE These functions return the absolute value of x. If x is a NaN, a NaN is r

manpages/XcmsCIELuvQueryMaxLC.3.html
XcmsCIELuvQueryMaxLC(3) - obtain the CIE L*u*v* coordinates
The XcmsCIELuvQueryMaxC function, given a hue angle and lightness, finds the point of maximum chroma displayable by the screen. It returns this point in CIE L*u

manpages/XkbSetDetectableAutoRepeat.3.html
XkbSetDetectableAutoRepeat(3) - Sets DetectableAutoRepeat...
XkbSetDetectableAutoRepeat.3 - Auto-repeat is the generation of multiple key events by a keyboard when the user presses a key and holds it down. Keyboard hardwa

manpages/__realloc_hook.3.html
__realloc_hook(3) malloc debugging variables (Man Page).....
The GNU C library lets you modify the behavior of malloc(3), realloc(3), and free(3) by specifying appropriate hook functions. You can use these hooks to help y

manpages/gnutls_db_set_remove_function.3.html
gnutls_db_set_remove_function(3) - API function (Man Page)
Sets the function that will be used to remove data from the resumed sessions database. This function must return 0 on success. The first argument to rem_func wi





We can't live, work or learn in freedom unless the software we use is free.