General Information
---------------------------------------------------------------------------

clive is a video extraction tool for user-uploaded video hosts such as
Youtube, Google Video, Dailymotion, Guba and Metacafe. It can be chained
with 3rd party tools for subsequent video re-encoding and playing and
playing.


Bundled packages
---------------------------------------------------------------------------

* urlgrabber module [LGPL]
* feedparser module [MIT]
* newt library (snack module) [LGPL]

The source code to these can be found in the src/clive/$PACKAGE directory.
Documentation, tests and examples etc. were excluded to save some space.

All of these packages are installed to the clive namespace and will not
interfere with their equivalent packages that may co-exist in the same system.
The python newt module is linked statically with the newt library to avoid
the need to install the library to the system.


Installation
---------------------------------------------------------------------------

Please see the 'INSTALL' file.


Source code documentation
---------------------------------------------------------------------------

To create the doxygen generated documentation, type:
    % make dox

The documentation is created into the dox/ directory. Note that if
configure script failed to locate the doxygen program, the above
command will fail.


Bug reports
---------------------------------------------------------------------------

Please visit the bug tracking system at:
    https://gna.org/bugs/?func=additem&group=clive

In the bug report, please include:

    * Information about your system
        - Operating system
        - Python version
        - Anything else relevant
    * How to reproduce the bug
    * If the bug was a crash, the exact text that was printed
    * Further information such as the back trace if possible 

Please submit feature requests, comments and questions to the
support tracker at:
    https://gna.org/support/?func=additem&group=clive

The patch tracking system is available at:
    https://gna.org/patch/?group=clive


License
---------------------------------------------------------------------------

clive comes with NO WARRANTY, to the extent permitted by law.
You may redistribute copies of clive under the terms of the
GNU General Public License. For more information about these
matters, see the files named COPYING.


