doc/man1/quvi-dump.1.txt

   1 quvi-dump(1)
   2 ============
   3
   4 NAME
   5 ----
   6 quvi-dump - The dull-witted property printer
   7
   8 SYNOPSIS
   9 --------
  10 [verse]
  11 'quvi dump' [OPTIONS] [ARGS]
  12
  13 DESCRIPTION
  14 -----------
  15 This command queries the properties for an URL and prints them to
  16 the stdout.
  17
  18 DEFAULT BEHAVIOUR
  19 -----------------
  20 The command will attempt to determine if any of the
  21 linkman:libquvi-scripts[7] accept the input URL before exiting with an
  22 error. The script type {playlist,media,...} determines how the command
  23 will handle the input URL.
  24
  25 Playlist URLs::
  26   The playlist properties (media URLs) are printed in the "rfc2483"
  27   format.
  28
  29 Media URLs::
  30   The media properties will be printed in the "enum" format.
  31
  32 Available {subtitles,streams}::
  33   Printed in the "rfc2483" format.
  34
  35 The '--print-format' may be used to change the default behaviour.
  36
  37 include::common.txt[]
  38 include::input.txt[]
  39
  40 OPTIONS
  41 -------
  42
  43 include::opts-core.txt[]
  44 include::opts-core-print-format.txt[]
  45 include::opts-core-verbosity.txt[]
  46
  47 Dump
  48 ~~~~
  49
  50 -q, --query-metainfo::
  51   Instruct the command to query the HTTP metainfo properties, namely
  52   Content-{Length,Type}. This will cause linkman:libquvi[3] to send an
  53   HTTP HEAD request for each HTTP media stream URL and parse the
  54   returned data.  When used, the command will include these properties
  55   to the printed media properties.
  56   +
  57   config: dump.query-metainfo=<boolean>
  58
  59 include::opts-exec.txt[]
  60 include::opts-http.txt[]
  61
  62 EXAMPLES
  63 --------
  64 * Print media properties in XML:
  65 +
  66 ----
  67 $ quvi dump -p xml MEDIA_URL
  68 ----
  69
  70 * Execute a child program:
  71 +
  72 ----
  73 $ quvi dump -e "totem %u" MEDIA_URL
  74 ----
  75
  76 * Print playlist properties in JSON:
  77 +
  78 ----
  79 $ quvi dump -p json PLAYLIST_URL
  80 ----
  81
  82 * Print available subtitles in JSON:
  83 +
  84 ----
  85 $ quvi dump -p json -B MEDIA_URL
  86 ----
  87
  88 * Print available media streams:
  89 +
  90 ----
  91 $ quvi dump -S MEDIA_URL
  92 ----
  93
  94 * Query media properties for each playlist item:
  95 +
  96 ----
  97 $ quvi dump PLAYLIST_URL | quvi dump
  98 ----
  99
 100 include::footer.txt[]