GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
VORBISCOMMENT(1) Ogg Vorbis Tools VORBISCOMMENT(1)

vorbiscomment - List or edit comments in Ogg Vorbis files

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]

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

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

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>

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.

Program Authors:
 
Michael Smith <msmith@xiph.org>
 
Ralph Giles <giles@xiph.org>
 
Manpage Author:
 
Christopher L Cheney <ccheney@debian.org>

oggenc(1), oggdec(1), ogg123(1), ogginfo(1)
December 30, 2008 Xiph.Org Foundation

Search for    or go to Top of page |  Section 1 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.