clivescan(1) the video link scanning utility for clive


clivescan [option]... [URL]...


clivescan is an utility that scans video pages for video links and uses clive(1) (or <cclive(1)> to extract them. It scans for both video page and embedded video links.

Historically, the video link scanning feature was written in Python/Newt and was part of clive(1). This feature was originally removed in clive 2.0 and later rewritten in Perl/Tk as part of the clive-utils project which is a set of additional utilities for clive(1).


You may freely mix different option styles, or specify options after the command-line arguments. For example:
  % clivescan -c /usr/local/bin/clive --opts=mp4 URL -a

You may also put several options together that do not require arguments. For example:
  % clivescan -aXc /usr/local/bin/clive URL

Which is equivalent to:
  % clivescan -a -X -c /usr/local/bin/clive URL


-h, --help
Show help and exit.
-v, --version
Show version and exit.
-c, --clive=path
path to clive(1) command. If unspecified, clivescan will attempt to locate it in the $PATH. Additionally, the CLIVE_PATH environment variable can be used.
-o, --opts=opts
opts to append to clive call. See clive(1) for more on the available options.
-a, --all
Grab all videos without prompting the GUI. Note that users without X can use this option to workaround the X requirement.
-r, --recall
Recall the last input.
-s, --selected
Re-extract the last video selection.
-n, --no-strict
This option provides a workaround for some search pattern issues that are known to occur. For example:
 % clivescan ``''

Does not return any videos even though the page lists them. This happens because clivescan assumes that the domain can be found in the URL. To override this restrictive default behaviour:
 % clivescan -n ``''

-p, --paste
Paste URL input data from clipboard.

HTTP Options

-U, --agent=string
Identify as string to the HTTP server. Defaults to ``Mozilla/5.0''.
-y, --proxy=address
Use address for HTTP proxy, e.g. http://foo:1234. If http_proxy environment variable is defined, it will be used.
-X, --no-proxy
Do not use the defined HTTP proxy (--proxy, config or http_proxy).


Typical use:
% clivescan
Multiple scan URLs:
% cat >> url.lst

% cat url.lst | clivescan

Set path to clive(1) with video extraction options:
% clivescan --clive=/usr/local/bin/clive --opts=``-f mp4'' URL
Grab all found videos without prompting:
% clivescan --all

Note that users without X can also use this.


clivescan searches the ~/.config/clive-utils directory for the config file. You can override this by setting the CLIVESCAN_HOME environment variable.
Configuration file.
GUI preferences (e.g. fonts, window position, sash coords, ...).
Last input.
Last video selection.


Project page:

Development repository can be cloned with:
  % git clone git://

For release announcements, subscribe to the project at:


Written by Toni Gundogdu <[email protected]>