1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272
|
.\" Automatically generated by Pod::Man 2.16 (Pod::Simple 3.05)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sh \" Subsection heading
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings. \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote. \*(C+ will
.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
. ds -- \(*W-
. ds PI pi
. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
. ds L" ""
. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
. ds -- \|\(em\|
. ds PI \(*p
. ds L" ``
. ds R" ''
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
.\" entries marked with X<> in POD. Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.ie \nF \{\
. de IX
. tm Index:\\$1\t\\n%\t"\\$2"
..
. nr % 0
. rr F
.\}
.el \{\
. de IX
..
.\}
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear. Run. Save yourself. No user-serviceable parts.
. \" fudge factors for nroff and troff
.if n \{\
. ds #H 0
. ds #V .8m
. ds #F .3m
. ds #[ \f1
. ds #] \fP
.\}
.if t \{\
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
. ds #V .6m
. ds #F 0
. ds #[ \&
. ds #] \&
.\}
. \" simple accents for nroff and troff
.if n \{\
. ds ' \&
. ds ` \&
. ds ^ \&
. ds , \&
. ds ~ ~
. ds /
.\}
.if t \{\
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
. \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
. \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
. \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
. ds : e
. ds 8 ss
. ds o a
. ds d- d\h'-1'\(ga
. ds D- D\h'-1'\(hy
. ds th \o'bp'
. ds Th \o'LP'
. ds ae ae
. ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "clivescan 1"
.TH clivescan 1 "2009-05-15" "2.1.6" "clivescan manual"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
clivescan \- the video link scanning utility for clive
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
clivescan [option]... [\s-1URL\s0]...
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
clivescan is an utility that scans video pages for video links and
uses \fIclive\fR\|(1) (or <\fIcclive\fR\|(1)> to extract them. It scans for both video
page and embedded video links.
.PP
Historically, the video link scanning feature was written in Python/Newt and
was part of \fIclive\fR\|(1). This feature was originally removed in clive 2.0
and later rewritten in Perl/Tk as part of the \fBclive-utils\fR project which
is a set of additional utilities for \fIclive\fR\|(1).
.SH "OPTION SYNTAX"
.IX Header "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 \s-1URL\s0 \-a
.PP
You may also put several options together that do not require arguments.
For example:
% clivescan \-aXc /usr/local/bin/clive \s-1URL\s0
.PP
Which is equivalent to:
% clivescan \-a \-X \-c /usr/local/bin/clive \s-1URL\s0
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\-h, \-\-help\fR" 4
.IX Item "-h, --help"
Show help and exit.
.IP "\fB\-v, \-\-version\fR" 4
.IX Item "-v, --version"
Show version and exit.
.IP "\fB\-c, \-\-clive=\fR\fIpath\fR" 4
.IX Item "-c, --clive=path"
\&\fIpath\fR to \fIclive\fR\|(1) command. If unspecified, clivescan will attempt to
locate it in the \f(CW$PATH\fR. Additionally, the \fB\s-1CLIVE_PATH\s0\fR environment variable
can be used.
.IP "\fB\-o, \-\-opts=\fR\fIopts\fR" 4
.IX Item "-o, --opts=opts"
\&\fIopts\fR to append to clive call. See \fIclive\fR\|(1) for more on the available
options.
.IP "\fB\-a, \-\-all\fR" 4
.IX Item "-a, --all"
Grab all videos without prompting the \s-1GUI\s0. Note that users without X can use
this option to workaround the X requirement.
.IP "\fB\-r, \-\-recall\fR" 4
.IX Item "-r, --recall"
Recall the last input.
.IP "\fB\-s, \-\-selected\fR" 4
.IX Item "-s, --selected"
Re-extract the last video selection.
.IP "\fB\-n, \-\-no\-strict\fR" 4
.IX Item "-n, --no-strict"
This option provides a workaround for some search pattern issues that
are known to occur. For example:
% clivescan \*(L"http://video.google.com/videosearch?q=inurl%3Abreak\*(R"
.Sp
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 \s-1URL\s0. To override this restrictive default behaviour:
% clivescan \-n \*(L"http://video.google.com/videosearch?q=inurl%3Abreak\*(R"
.IP "\fB\-p, \-\-paste\fR" 4
.IX Item "-p, --paste"
Paste \s-1URL\s0 input data from clipboard.
.PP
\&\fB\s-1HTTP\s0 Options\fR
.IP "\fB\-U, \-\-agent=\fR\fIstring\fR" 4
.IX Item "-U, --agent=string"
Identify as \fIstring\fR to the \s-1HTTP\s0 server. Defaults to \*(L"Mozilla/5.0\*(R".
.IP "\fB\-y, \-\-proxy=\fR\fIaddress\fR" 4
.IX Item "-y, --proxy=address"
Use \fIaddress\fR for \s-1HTTP\s0 proxy, e.g. http://foo:1234. If http_proxy
environment variable is defined, it will be used.
.IP "\fB\-X, \-\-no\-proxy\fR" 4
.IX Item "-X, --no-proxy"
Do not use the defined \s-1HTTP\s0 proxy (\fB\-\-proxy\fR, config or http_proxy).
.SH "EXAMPLES"
.IX Header "EXAMPLES"
.IP "Typical use:" 4
.IX Item "Typical use:"
% clivescan youtube.com video.google.com
.IP "Multiple scan URLs:" 4
.IX Item "Multiple scan URLs:"
% cat >> url.lst
http://video.google.com
http://youtube.com/communitychannel
http://sevenload.com
http://break.com
.Sp
% cat url.lst | clivescan
.IP "Set path to \fIclive\fR\|(1) with video extraction options:" 4
.IX Item "Set path to clive with video extraction options:"
% clivescan \-\-clive=/usr/local/bin/clive \-\-opts=\*(L"\-f mp4\*(R" \s-1URL\s0
.IP "Grab all found videos without prompting:" 4
.IX Item "Grab all found videos without prompting:"
% clivescan \-\-all http://youtube.com
.Sp
Note that users without X can also use this.
.SH "FILES"
.IX Header "FILES"
clivescan searches the ~/.config/clive\-utils directory for the config file.
You can override this by setting the \fB\s-1CLIVESCAN_HOME\s0\fR environment variable.
.IP "~/.config/clive\-utils/config" 4
.IX Item "~/.config/clive-utils/config"
Configuration file.
.IP "~/.config/clive\-utils/scan.prefs" 4
.IX Item "~/.config/clive-utils/scan.prefs"
\&\s-1GUI\s0 preferences (e.g. fonts, window position, sash coords, ...).
.IP "~/.config/clive\-utils/scan.recall" 4
.IX Item "~/.config/clive-utils/scan.recall"
Last input.
.IP "~/.config/clive\-utils/scan.sel" 4
.IX Item "~/.config/clive-utils/scan.sel"
Last video selection.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fIclive\fR\|(1) \fIcclive\fR\|(1) \fIclivefeed\fR\|(1) \fIclivepass\fR\|(1)
.SH "OTHER"
.IX Header "OTHER"
Project page:
<http://googlecode.com/p/clive\-utils/>
.PP
Development repository can be cloned with:
% git clone git://repo.or.cz/clive\-utils.git
.PP
For release announcements, subscribe to the project at:
<http://freshmeat.net/projects/clive\-utils/>
.SH "AUTHOR"
.IX Header "AUTHOR"
Written by Toni Gundogdu <legatvs@gmail.com>
|