|
cannam@125
|
1 .Dd November 2, 2014
|
|
cannam@125
|
2 .Dt SNDFILE-METADATA-GET 1
|
|
cannam@125
|
3 .Os
|
|
cannam@125
|
4 .Sh NAME
|
|
cannam@125
|
5 .Nm sndfile-metadata-get ,
|
|
cannam@125
|
6 .Nm sndfile-metadata-set
|
|
cannam@125
|
7 .Nd get or set metadata in a sound file
|
|
cannam@125
|
8 .Sh SYNOPSIS
|
|
cannam@125
|
9 .Nm sndfile-metadata-get
|
|
cannam@125
|
10 .Op Ar options
|
|
cannam@125
|
11 .Ar file
|
|
cannam@125
|
12 .Nm sndfile-metadata-set
|
|
cannam@125
|
13 .Op Ar options
|
|
cannam@125
|
14 .Ar file
|
|
cannam@125
|
15 .Nm sndfile-metadata-set
|
|
cannam@125
|
16 .Op Ar options
|
|
cannam@125
|
17 .Ar input
|
|
cannam@125
|
18 .Ar output
|
|
cannam@125
|
19 .Sh DESCRIPTION
|
|
cannam@125
|
20 .Nm sndfile-metadata-get
|
|
cannam@125
|
21 displays bext and string metadata stored in an audio file.
|
|
cannam@125
|
22 The following options specify what to print.
|
|
cannam@125
|
23 .Pp
|
|
cannam@125
|
24 .Bl -tag -width bext-descriptionXXXX -compact
|
|
cannam@125
|
25 .It Fl -all
|
|
cannam@125
|
26 all metadata
|
|
cannam@125
|
27 .It Fl -bext-description
|
|
cannam@125
|
28 description
|
|
cannam@125
|
29 .It Fl -bext-originator
|
|
cannam@125
|
30 originator info
|
|
cannam@125
|
31 .It Fl -bext-orig-ref
|
|
cannam@125
|
32 originator reference
|
|
cannam@125
|
33 .It Fl -bext-umid
|
|
cannam@125
|
34 Unique Material Identifier
|
|
cannam@125
|
35 .It Fl -bext-orig-date
|
|
cannam@125
|
36 origination date
|
|
cannam@125
|
37 .It Fl -bext-orig-time
|
|
cannam@125
|
38 origination time
|
|
cannam@125
|
39 .It Fl -bext-coding-hist
|
|
cannam@125
|
40 coding history
|
|
cannam@125
|
41 .It Fl -str-title
|
|
cannam@125
|
42 title
|
|
cannam@125
|
43 .It Fl -str-copyright
|
|
cannam@125
|
44 copyright
|
|
cannam@125
|
45 .It Fl -str-artist
|
|
cannam@125
|
46 artist
|
|
cannam@125
|
47 .It Fl -str-comment
|
|
cannam@125
|
48 comment
|
|
cannam@125
|
49 .It Fl -str-date
|
|
cannam@125
|
50 creation date
|
|
cannam@125
|
51 .It Fl -str-album
|
|
cannam@125
|
52 album
|
|
cannam@125
|
53 .It Fl -str-license
|
|
cannam@125
|
54 license
|
|
cannam@125
|
55 .El
|
|
cannam@125
|
56 .Pp
|
|
cannam@125
|
57 .Nm sndfile-metadata-set
|
|
cannam@125
|
58 sets bext and string metadata in an audio file if the format supports it.
|
|
cannam@125
|
59 If the file does not contain a BEXT chunk to be modified,
|
|
cannam@125
|
60 the second synopsis must be used, where another output file
|
|
cannam@125
|
61 capable of storing the metadata is created.
|
|
cannam@125
|
62 This file is overwritten if it already exists.
|
|
cannam@125
|
63 The following options take an argument specifying the metadata:
|
|
cannam@125
|
64 .Pp
|
|
cannam@125
|
65 .Bl -tag -width bext-coding-histXXXXXXX -compact
|
|
cannam@125
|
66 .It Fl -bext-description
|
|
cannam@125
|
67 description
|
|
cannam@125
|
68 .It Fl -bext-originator
|
|
cannam@125
|
69 originator
|
|
cannam@125
|
70 .It Fl -bext-orig-ref
|
|
cannam@125
|
71 originator reference
|
|
cannam@125
|
72 .It Fl -bext-umid
|
|
cannam@125
|
73 Unique Material Identifier
|
|
cannam@125
|
74 .It Fl -bext-orig-date
|
|
cannam@125
|
75 origination date
|
|
cannam@125
|
76 .It Fl -bext-orig-time
|
|
cannam@125
|
77 origination time
|
|
cannam@125
|
78 .It Fl -bext-coding-hist
|
|
cannam@125
|
79 coding history
|
|
cannam@125
|
80 .It Fl -bext-time-raf
|
|
cannam@125
|
81 time reference
|
|
cannam@125
|
82 .It Fl -str-comment
|
|
cannam@125
|
83 comment
|
|
cannam@125
|
84 .It Fl -str-title
|
|
cannam@125
|
85 title
|
|
cannam@125
|
86 .It Fl -str-copyright
|
|
cannam@125
|
87 copyright
|
|
cannam@125
|
88 .It Fl -str-artist
|
|
cannam@125
|
89 artist
|
|
cannam@125
|
90 .It Fl -str-date
|
|
cannam@125
|
91 date
|
|
cannam@125
|
92 .It Fl -str-album
|
|
cannam@125
|
93 album
|
|
cannam@125
|
94 .It Fl -str-license
|
|
cannam@125
|
95 license
|
|
cannam@125
|
96 .El
|
|
cannam@125
|
97 .Pp
|
|
cannam@125
|
98 The following options take no argument:
|
|
cannam@125
|
99 .Pp
|
|
cannam@125
|
100 .Bl -tag -width bext-coding-histXXXXXXX -compact
|
|
cannam@125
|
101 .It Fl -bext-auto-time-date
|
|
cannam@125
|
102 Set the BEXT time and date to current.
|
|
cannam@125
|
103 .It Fl -bext-auto-time
|
|
cannam@125
|
104 Set the BEXT time to current.
|
|
cannam@125
|
105 .It Fl -bext-auto-date
|
|
cannam@125
|
106 Set the BEXT date to current.
|
|
cannam@125
|
107 .It Fl -str-auto-date
|
|
cannam@125
|
108 Set the string date to current.
|
|
cannam@125
|
109 .El
|
|
cannam@125
|
110 .Sh EXIT STATUS
|
|
cannam@125
|
111 .Ex -std
|
|
cannam@125
|
112 .Sh SEE ALSO
|
|
cannam@125
|
113 .Lk http://www.mega-nerd.com/libsndfile/
|
|
cannam@125
|
114 .Lk http://tech.ebu.ch/docs/tech/tech3285.pdf
|
|
cannam@125
|
115 .Sh AUTHORS
|
|
cannam@125
|
116 .An Erik de Castro Lopo Aq Mt erikd@mega-nerd.com
|
