1QUVI-DUMP(1) quvi Manual QUVI-DUMP(1)
2
6 quvi-dump - The dull-witted property printer
7
9 quvi dump [OPTIONS] [ARGS]
10
12 This command queries the properties for an URL and prints them to the
13 stdout.
14
16 The command will attempt to determine if any of the libquvi-scripts(7)
17 accept the input URL before exiting with an error. The script type
18 {playlist,media,...} determines how the command will handle the input
19 URL.
20 Playlist URLs
22 The playlist properties (media URLs) are printed in the "rfc2483"
23 format.
24 Media URLs
26 The media properties will be printed in the "enum" format.
27 Available {subtitles,streams}
29 Printed in the "rfc2483" format.
30 The --print-format may be used to change the default behaviour.
32
34 The support for the media hosts is determined by the current selection
35 of libquvi-scripts(7).
36
38 See quvirc(5) for more information about the groups and the variables
39 that quvi parses.
40
42 The command will read stdin by default. The input is expected to
43 contain URLs. The command arguments are expected to be either URLs or
44 file paths. If the input is read from either stdin or a file, the
45 contents are read as RFC2483. The input may contain file URIs.
46
48 Core
49 -o, --check-mode-offline
50 Do not resolve URL redirections before passing the URL to the
51 libquvi-scripts(7) to determine whether the URL is accepted by any
52 of the scripts.
53 config: core.check-mode-offline=<boolean>
55 -B, --print-subtitles
57 Query and print the available media subtitles. See also
58 --print-format.
59 -S, --print-streams
61 Query and print the available media streams. See also
62 --print-format.
63 -l, --subtitle-language PATTERN[,PATTERN,...]
65 Match a subtitle language using a regex PATTERN. The value may be a
66 comma-separated list of regex PATTERNs (left-to-right order) that
67 are matched against the available selection.
68 The value may also contain the reserved keyword croak which will
70 cause libquvi(3) to exit with an error when reached.
71 Note
73 The first available subtitle language will be chosen if nothing
74 matched the PATTERN
75 config: core.subtitle-language=<PATTERN[,PATTERN,...]>
77 -s, --stream PATTERN[,PATTERN,...]
79 Match a stream using a regex PATTERN. The value may be a
80 comma-separated list of regex PATTERNs (left-to-right order) that
81 are matched against the available selection.
82 The value may contain the following reserved keywords:
84 · croak - instructs libquvi(3) to exit with an error when
86 reached
87 · best - instructs libquvi(3) to choose the best quality stream
89 The best quality is determined by the libquvi-scripts(7) by
91 comparing the media quality properties, e.g. the video height
92 property, although the actual method may vary depending on the data
93 provided by the media hosting service.
94 Note
96 The first available stream is selected if nothing matched
97 config: core.stream=<PATTERN[,PATTERN,...]>
99 -p, --print-format FORMAT (default: varies)
101 Specify the format in which the properties should be printed. The
102 command uses a different default value for this, depending on the
103 input URL. FORMAT may be one of the following values:
104 · enum
106 · json - available only if quvi was built with JsonGLib
108 · rfc2483
110 · xml - available only if quvi was built with libxml
112 Note
114 The default value varies, see DEFAULT BEHAVIOUR.
115 config: core.print-format=<FORMAT>
117 -b, --verbosity LEVEL (default: verbose)
119 Specify the verbosity level of the command. LEVEL may be:
120 · debug - verbose + enable verbose output for libcurl
122 (CURLOPT_VERBOSE)
123 · verbose - default
125 · quiet - errors only
127 · mute - nothing at all
129 config: core.verbosity=<LEVEL>
131 Dump
133 -q, --query-metainfo
134 Instruct the command to query the HTTP metainfo properties, namely
135 Content-{Length,Type}. This will cause libquvi(3) to send an HTTP
136 HEAD request for each HTTP media stream URL and parse the returned
137 data. When used, the command will include these properties to the
138 printed media properties.
139 config: dump.query-metainfo=<boolean>
141 Exec
143 -A, --exec-dump-argv
144 Print the argument array used to execute the child program.
145 config: exec.dump-argv=<boolean>
147 -E, --exec-enable-stderr
149 Do not discard child program’s standard error.
150 config: exec.enable-stderr=<boolean>
152 -O, --exec-enable-stdout
154 Do not discard child program’s standard output.
155 config: exec.enable-stdout=<boolean>
157 -e, --exec COMMAND
159 Execute a child program asynchoronously after parsing the media
160 properties. COMMAND may contain any of the following property
161 sequences. Each occurence will be replaced by the command before
162 the COMMAND is executed:
163 %s Media property: start time (ms)
165 %T Media property: thumbnail URL
166 %d Media property: duration (ms)
167 %u Media stream property: URL
168 %I Media stream property: ID
169 %t Media property: title
170 %i Media property: ID
171 %e File extension[1]
172 %f Path to the saved media file[2]
173 [1]: The file extension is parsed from the HTTP content-type header.
175 quvi-get(1) replaces this sequence with HTTP media streams only.
176 quvi-dump(2) replaces it only when --query-metainfo is used with
177 HTTP media streams.
178 [2]: This sequence is unique to quvi-get(1)
180 This option may be specified multiple times. In the quvirc(5) file,
182 specify the commands in a comma-separated list.
183 config: exec.external=<COMMAND[,COMMAND,...]>
185 HTTP
187 -c, --enable-cookies
188 Have libcurl parse the received cookies and use them in the
189 subsequent HTTP requests.
190 config: http.enable-cookies=<boolean>
192 -u, --user-agent USERAGENT (default: Mozilla/5.0)
194 Identify as USERAGENT to the HTTP server.
195 Note
197 libquvi-scripts(7) may override this value
198 config: http.user-agent=<USERAGENT>
200
202 · Print media properties in XML:
203 $ quvi dump -p xml MEDIA_URL
205 · Execute a child program:
207 $ quvi dump -e "totem %u" MEDIA_URL
209 · Print playlist properties in JSON:
211 $ quvi dump -p json PLAYLIST_URL
213 · Print available subtitles in JSON:
215 $ quvi dump -p json -B MEDIA_URL
217 · Print available media streams:
219 $ quvi dump -S MEDIA_URL
221 · Query media properties for each playlist item:
223 $ quvi dump PLAYLIST_URL | quvi dump
225
227 See quvi(1)
228
230 Either EXIT_SUCCESS or EXIT_FAILURE. The actual value depends on the
231 platform, on POSIX systems they are 0 (success) and 1 (failure).
232
234 quvirc(5), libquvi(3)
235
237 Home
238 http://quvi.sourceforge.net/
240 Development code
242 git://repo.or.cz/quvi-tool.git
244 gitweb
246 http://repo.or.cz/w/quvi-tool.git
248
250 Toni Gundogdu <legatvs@gmail.com>
251 Author.
252
254 Report bugs to the quvi-devel mailing list
255 <quvi-devel@lists.sourceforge.net> where the development and the
256 maintenance is primarily done. You do not have to be subscribed to the
257 list to send a message there.
258
260 quvi is Free Software licensed under the GNU Affero GPLv3+
261
263 Part of the quvi(1) suite
264quvi 0.9.5 11/10/2013 QUVI-DUMP(1)