---
name: "clivescan"
section: "1"
platform: "linux"
package: "clive-utils"
version: "2.1.6-1"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/clivescan"
---

# clivescan(1)

the video link scanning utility for clive

## NAME

clivescan - the video link scanning utility for clive

## SYNOPSIS

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

## DESCRIPTION

clivescan is an utility that scans video pages for video links and uses [*clive*(1)](/clive/1.md) (or \<[*cclive*(1)](/cclive/1.md)\> 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)](/clive/1.md). 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)](/clive/1.md).

## 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)](/clive/1.md) 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)](/clive/1.md) 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)](/clive/1.md) 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.

## SEE ALSO

[*clive*(1)](/clive/1.md) [*cclive*(1)](/cclive/1.md) [*clivefeed*(1)](/clivefeed/1.md) [*clivepass*(1)](/clivepass/1.md)

## 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/\>

## AUTHOR

Written by Toni Gundogdu \<legatvs@gmail.com\>