vorbiscomment(1)

1VORBISCOMMENT(1)                 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:  one  element  per  line  in
29              'name=value' format.
30
31       -h, --help
32              Show command help.
33
34       -l, --list
35              List the comments in the ogg vorbis file.
36
37       -q, --quiet
38              Quiet mode.  No messages are displayed.
39
40       -t 'name=value', --tag 'name=value'
41              Specify a new tag on the command line. Each tag is  given  as  a
42              single  string.  The  part  before the '=' is treated as the tag
43              name and the part after as the value.
44
45       -w, --write
46              Replace comments with the new set given either  on  the  command
47              line with -t or from a file with -c.
48
49       -R, --raw
50              Read  and write comments in UTF-8, rather than converting to the
51              user's character set.
52
53       -V, --version
54              Display the version of vorbiscomment.
55
56

EXAMPLES

58       To just see what comment tags are in a file:
59
60           vorbiscomment -l file.ogg
61
62       To edit those comments:
63
64           vorbiscomment -l file.ogg > file.txt
65           [edit the comments in file.txt to your satisfaction]
66           vorbiscomment -w -c file.txt file.ogg newfile.ogg
67
68       To simply add a comment:
69
70           vorbiscomment -a -t 'ARTIST=No One You Know' file.ogg newfile.ogg
71
72

TAG FORMAT

74       See http://xiph.org/ogg/vorbis/doc/v-comment.html for documentation  on
75       the  Ogg Vorbis tag format, including a suggested list of canonical tag
76       names.
77
78

AUTHORS

80       Program Authors:
81              Michael Smith <msmith@xiph.org>
82              Ralph Giles <giles@xiph.org>
83
84
85       Manpage Author:
86              Christopher L Cheney <ccheney@debian.org>
87
88