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