README

   1
   2 clive is a command line media extraction tool for Youtube and similar
   3 websites that require Adobe Flash.
   4
   5 WWW: <http://clive.sourceforge.net/>
   6 GIT: <git://repo.or.cz/clive.git>
   7
   8
   9 PREREQUISITES
  10
  11 See the Makefile.PL file for Perl module prerequisites, under "PREREQ_PM".
  12 Additionally, you will need:
  13   * quvi [1], 0.2.17+
  14   * Download command, e.g. curl [2] or wget [2], etc.
  15
  16 [1] <http://quvi.sourceforge.net/>
  17 [2] <http://curl.haxx.se/>
  18 [3] <http://www.gnu.org/software/wget/>
  19
  20
  21 INSTALLATION
  22
  23 You could skip this step, if you like, and instead just run "bin/clive".
  24 This should work as long as the prerequisites are found.
  25
  26 perl Makefile.PL
  27 make
  28 make install
  29
  30 You can specify the install prefix with INSTALL_BASE
  31 e.g. "perl Makefile.PL INSTALL_BASE=/usr/local"
  32
  33 More: <http://search.cpan.org/perldoc?ExtUtils::MakeMaker>
  34  FAQ: <http://perldoc.perl.org/ExtUtils/MakeMaker/FAQ.html>
  35
  36
  37 GETTING STARTED
  38
  39 Read "man clive" (or "perldoc man1/clive.1.pod"). You should consider
  40 setting --quvi and --get-with in your config file for seamless use.
  41 For example:
  42
  43 % cat > ~/.cliverc
  44 --quvi "/usr/bin/quvi %u"
  45 --get-with "/usr/bin/curl -L -C - -o %f %u"
  46
  47 If you need to set HTTP proxy, etc., please refer to the documentation
  48 of those commands.
  49
  50
  51 NOTES FOR PACKAGERS
  52
  53 Consider packaging a system-wide default configuration file along with
  54 your clive package. The config file should define at least --quvi and
  55 --get-with (see "GETTING STARTED" above) so that clive will work
  56 "out-of-the-box" when your package is installed.
  57
  58 You could use wget(1) instead of curl(1), although I am yet to find
  59 the correct combo of options that allows resuming file transfers
  60 without overwriting the existing file (e.g. "wget -c -O %f" does not
  61 yield the hoped results).
  62
  63 Whatever values you choose to set in the default system-wide config
  64 file, please be sure to make your clive package depend on those
  65 commands/packages.
  66
  67 For additional notes about the configuration file (e.g. paths), please
  68 read the "FILES" section in the manual page.
  69     % perldoc man1/clive.1.pod
  70
  71 For an example config file, please see also examples/cliverc.