Prerequisites
---------------------------------------------------------------------------

* Python >= 2.4 (http://python.org)
* urlgrabber >= 3.1.0 (http://linux.duke.edu/projects/urlgrabber/)
* feedparser >= 4.1 (http://www.feedparser.org/)
* newt >= 0.51 (https://fedorahosted.org/newt/)

The clive distribution contains:
    * urlgrabber
    * feedparser
    * newt

These modules are installed by default. The default behaviour can be
overridden with --with-PACKAGE[=yes|no]. See details further below.

If clive is installed with the bundled newt:
    * libslang >= 2.0 (http://www.s-lang.org/) is also required

Optional:
    * ffmpeg for re-encoding videos (http://ffmpeg.mplayerhq.hu)
    * player for video playback (e.g. http://www.videolan.org/vlc)


Installation: All POSIX (Linux/BSD/UNIX-like OSes)
---------------------------------------------------------------------------

    % tar xvjf clive-${release}.tar.bz2
    % cd clive-${release}
    % ./configure
As root:    
    % make install

Note that any of the bundled packages may be excluded from the installation
by using the --with-PACKAGE[=yes|no] with configure. All of the bundled
modules are installed by default, but by using either --with-PACKAGE=no
or --without-PACKAGE, you can tell clive not to use the bundled modules.

For example:
    % ./configure --without-newt

Would install the bundled urlgrabber and feedparser modules but not the
newt module. By doing so, clive expects the newt module to be found in
the system.

Note that If clive is installed with the newt module, you may
need to customize the the environment settings CFLAGS and LDFLAGS.

For example (in csh terms):
    % setenv CFLAGS "-I/usr/local/include"
    % setenv LDFLAGS "-L/usr/local/lib"
    % ./configure


Troubleshooting: ImportError: No module named clive.main
---------------------------------------------------------------------------

If clive returns this error after installation, make sure the environment
variable PYTHONPATH points to the proper site-packages directory,
for example:
    /usr/local/lib/python2.5/site-packages

Note that this may also be an indication of improper use of the --prefix
and/or invalid Python installation.
