quvi (1) - Linux Manuals

quvi: query video tool

NAME

quvi - query video tool

SYNOPSIS

quvi [options] [url...]

DESCRIPTION

quvi is a command line tool for parsing video download links. It supports Youtube and other similar video websites.

OPTIONS

-h, --help
Print help and exit.
-v, --version
Print program version and exit.
--hosts
Print supported hosts and exit.
-q, --quiet
Turn off all output.
--debug
Turn on libcurl verbose mode.
-n, --no-verify
Do not verify video link. Note that quvi will not report video file length, content-type or file suffix if this option is used.
--page-title=string
Match parsed video page title to string.
--video-id=string
Match parsed video ID to string.
--file-length=length
Match parsed video file length to length.
--file-suffix=string
Match parsed video file suffix to string.
-a, --test-all
Run all built-in tests. quvi will test all built-in video page links.
-t, --test=pattern
Match pattern to a built-in test page link and test it.
-d, --dump
Dump video details when running tests. To be used with --test-all.
--agent=string
Identify quvi as string to servers. Default is ``Mozilla/5.0''.
--proxy=host[:port]
Use the specified HTTP proxy. Note that quvi will use http_proxy environment setting if it is set.
--connect-timeout=seconds
Maximum seconds allowed connection to server take. Default is 30.
-f, --format[=]format_id
Query video format, format_id depends on the host, see --hosts output.

EXAMPLES

quvi URL
Test URL.
quvi -a
Run all built-in host tests.
quvi -t youtube
Match 'youtube' string to built-in video page links and test it.
quvi URL -f best
Query 'best' of the video from the URL.

BUGS

Sure to be some. Please report them.

  <http://quvi.googlecode.com/>

DEBUGGING

quvi --debug URL
Spew out libcurl verbose mode messages.
$prefix/share/quvi/lua/README
$prefix/share/quvi/lua/website/README
Contain details about working with the quvi Lua scripts (e.g. website rules). If video link parsing breaks, have a look at these files.
$prefix/share/doc/quvi
Various HOWTOs can be found in this directory.

FILES

$HOME/.quvirc
You can define most of the command line options in the config file. For example:

 agent = some_agent/1.0     # --agent
 proxy = http://foo:1234    # --proxy
 no-verify                  # --no-verify
 debug                      # --debug

Note that you can also define QUVI_HOME and use it instead.

EXIT STATUS

quvi exits with 0 on success and >0 if an error occurred.

  QUVI_OK               = 0x00
  QUVI_MEM              = 0x01, Memory allocation failed
  QUVI_BADHANDLE        = 0x02, Bad session handle
  QUVI_INVARG           = 0x03, Invalid function argument
  QUVI_CURLINIT         = 0x04, libcurl initialization failed
  QUVI_LAST             = 0x05, Indicates end of list iteration
  QUVI_ABORTEDBYCALLBACK= 0x06, Aborted by callback function
  QUVI_LUAINIT          = 0x07, Lua initialization failure
  QUVI_NOLUAWEBSITE     = 0x08, Failed to find lua website scripts
  --
  QUVI_PCRE             = 0x40, libpcre error occurred
  QUVI_NOSUPPORT        = 0x41, libquvi does not support the video host
  QUVI_CURL             = 0x42, libcurl error occurred
  QUVI_ICONV            = 0x43, libiconv error occurred
  QUVI_LUA              = 0x44, lua error occurred

OTHER

Project page:
<http://quvi.googlecode.com/>
FAQ:
<http://code.google.com/p/quvi/wiki/FAQ>
Development code:
% git clone git://repo.or.cz/quvi.git

AUTHOR

Toni Gundogdu.