INSTALL

   1
   2             clive installation
   3
   4  Normally you can do "make" and then "make install". That will first check for
   5  the required Perl modules and then install the clive in your own ~/bin/
   6  directory. If you want to do a global install, you can do (as root):
   7     # make prefix=/usr install
   8
   9  The manual page is installed by default, if you do not need it:
  10     # make WITH_MAN=no install
  11
  12  When you uninstall, be sure to use the same prefix. For example:
  13     # make prefix=/usr uninstall
  14
  15  Developers may also find the following make target useful:
  16     man # generate clive.1 from clive (req. pod2man)
  17
  18
  19             clive prerequisites
  20
  21  * Perl >= 5.8
  22
  23  Perl modules:
  24  * Config::Tiny (2.12+)
  25  * WWW::Curl (4.05+)
  26  * HTML::TokeParser (2.37+)
  27  * URI::Escape (3.29+)
  28  * Digest::SHA (5.47+)
  29
  30  Optional Perl modules:
  31  * BerkeleyDB (0.34+) # Cache features, e.g. --show, --grep
  32  * Clipboard (0.09+)  # --paste from X clipboard
  33  * IO::Pager (0.05+)  # --show; same as running "clive --show | less"
  34  * Expect (1.21+)     # --clivepass
  35  * Term::ReadKey      # SIGWINCH: resize progressbar to match terminal width
  36
  37  clive runs without the optional modules but the specified program features
  38  will be disabled if the required module is not found.
  39
  40  Most Unix/Linux distros have made the above Perl modules available as
  41  packages but you can also install them from CPAN, e.g.:
  42    # cpan install $modulename
  43
  44
  45             Getting started
  46
  47  Typical use:
  48     % clive "http://youtube.com/watch?v=3HD220e0bx4"
  49
  50  Be sure to read the manual page which contains also the EXAMPLES
  51  section. For a configuration file example, see examples/config.