Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   26626 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

VORBISCOMMENT(1)	       Ogg Vorbis Tools		      VORBISCOMMENT(1)

NAME
       vorbiscomment - List or edit comments in Ogg Vorbis files

SYNOPSIS
       vorbiscomment [-l] file.ogg
       vorbiscomment  -a  [  -c	 commentfile  |	 -t “name=value” ] [-q] in.ogg
       [out.ogg]
       vorbiscomment -w [ -c commentfile  |  -t	 “name=value”  ]  [-q]	in.ogg
       [out.ogg]

DESCRIPTION
       vorbiscomment  Reads, modifies, and appends Ogg Vorbis audio file meta‐
       data 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 ele‐
	      ment 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.

       -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	       November 19, 2007	      VORBISCOMMENT(1)

Vote for polarhome