clivescan1

Usage

Overview

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).

Option syntax

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

Options

-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 "http://video.google.com/videosearch?q=inurl%3Abreak"

Does not return any break.com videos even though the page lists them. This happens because clivescan assumes that the domain break.com can be found in the URL. To override this restrictive default behaviour:
% clivescan -n "http://video.google.com/videosearch?q=inurl%3Abreak"

-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).

Examples

Typical use:

% clivescan youtube.com video.google.com

Multiple scan URLs:

% cat >> url.lst
http://video.google.com
http://youtube.com/communitychannel
http://sevenload.com
http://break.com

% 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 http://youtube.com

Note that users without X can also use this.

Files

clivescan searches the ~/.config/clive-utils directory for the config file. You can override this by setting the CLIVESCAN_HOME environment variable.

~/.config/clive-utils/config

Configuration file.

~/.config/clive-utils/scan.prefs

GUI preferences (e.g. fonts, window position, sash coords, ...).

~/.config/clive-utils/scan.recall

Last input.

~/.config/clive-utils/scan.sel

Last video selection.

Other

Project page:
<http://googlecode.com/p/clive-utils/>

Development repository can be cloned with:
% git clone git://repo.or.cz/clive-utils.git

For release announcements, subscribe to the project at:
<http://freshmeat.net/projects/clive-utils/>