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
