vorbiscomment(1)

1VORBISCOMMENT(1)               Ogg Vorbis Tools               VORBISCOMMENT(1)
2
3
4

NAME

6       vorbiscomment - List or edit comments in Ogg Vorbis files
7
8

SYNOPSIS

10       vorbiscomment [-l] file.ogg
11       vorbiscomment  -a  [  -c  commentfile  |  -t “name=value” ] [-q] in.ogg
12       [out.ogg]
13       vorbiscomment -w [ -c commentfile  |  -t  “name=value”  ]  [-q]  in.ogg
14       [out.ogg]
15
16

DESCRIPTION

18       vorbiscomment  Reads, modifies, and appends Ogg Vorbis audio file meta‐
19       data tags.
20
21

OPTIONS

23       -a, --append
24              Append comments.
25
26       -c file, --commentfile file
27              Take comments from a file. The file is the  same  format  as  is
28              output  by the the -l option or given to the -t option: one ele‐
29              ment per line in 'tag=value' format. If the  file  is  /dev/null
30              and -w was passed, the existing comments will be removed.
31
32       -h, --help
33              Show command help.
34
35       -l, --list
36              List the comments in the Ogg Vorbis file.
37
38       -q, --quiet
39              Quiet mode.  No messages are displayed.
40
41       -t 'name=value', --tag 'name=value'
42              Specify  a  new  tag on the command line. Each tag is given as a
43              single string. The part before the '=' is  treated  as  the  tag
44              name and the part after as the value.
45
46       -w, --write
47              Replace  comments  with  the new set given either on the command
48              line with -t or from a file with -c. If neither  -c  nor  -t  is
49              given, the new set will be read from the standard input.
50
51       -R, --raw
52              Read  and write comments in UTF-8, rather than converting to the
53              user's character set.
54
55       -V, --version
56              Display the version of vorbiscomment.
57
58

EXAMPLES

60       To just see what comment tags are in a file:
61
62           vorbiscomment -l file.ogg
63
64       To edit those comments:
65
66           vorbiscomment -l file.ogg > file.txt
67           [edit the comments in file.txt to your satisfaction]
68           vorbiscomment -w -c file.txt file.ogg newfile.ogg
69
70       To simply add a comment:
71
72           vorbiscomment -a -t 'ARTIST=No One You Know' file.ogg newfile.ogg
73
74       To add a set of comments from the standard input:
75
76           vorbiscomment -a file.ogg
77           ARTIST=No One You Know
78           ALBUM=The Famous Album
79           <ctrl-d>
80
81

TAG FORMAT

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

AUTHORS

89       Program Authors:
90              Michael Smith <msmith@xiph.org>
91              Ralph Giles <giles@xiph.org>
92
93
94       Manpage Author:
95              Christopher L Cheney <ccheney@debian.org>
96
97