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/)

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

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

The following bundled packages are installed by default:
    * urlgrabber
    * feedparser
    * newt

These packages are not part of clive but completely separate projects
that are bundled with clive. Depending on your configuration and
preferences, you may want to install clive without these packages and
instead rely on the ones that your system provides already. You can
do this by using the --with-installed-PACKAGE option with configure
script.


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

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

See the notes about the --with-installed-PACKAGE configure option above.
You can use this option with the bundled packages (listed above).
For example:
    % ./configure --with-installed-newt
This would install clive WITHOUT the bundled newt module and tell clive to
use the one installed to the system already (e.g. via apt).

Note that if clive is installed with the bundled 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.
