LottaNZB - Automated Usenet Client
==================================

LottaNZB aims to simplify and automate the download of binary news from the
Usenet, a world-wide internet discussion system. Users can tell LottaNZB what
to download using so-called NZB files, which are created by many Usenet search
engines. LottaNZB integrates nicely with GNOME desktops, but is not limited to
them and uses the mature HellaNZB software as its foundation.

LottaNZB is Free Software and licensed under the terms of the General Public
License 3.

Homepage: http://www.lottanzb.org

We are always grateful to receive feedback in the form of bug reports and
feature requests.


1. Installation instructions
----------------------------

1.1 Dependencies
    First, make sure you have the proper dependencies installed. Those
    dependencies are:
    
    - hellanzb >= 0.13
    - python >= 2.4
    - python-gtk2
    - python-glade2
    - python-kiwi >= 1.9.9
    - unrar
    
    For SSL encryption support:
    
    - python-openssl
    
    On Ubuntu, the installation also depends on:
    
    - python-setuptools
    
    The package names may vary depending on your distribution.

1.2 Build LottaNZB
    $ python setup.py build

1.3 Install/Upgrade LottaNZB
    Run as root or by using sudo on Ubuntu systems:
    
    $ python setup.py install

1.4	Launch LottaNZB
    In a terminal:
       $ lottanzb
    
    Via the GNOME menu:
       Applications -> Internet -> LottaNZB Automated Usenet Client

1.5 Have fun with LottaNZB!


2. Uninstallation instructions
------------------------------

When installing LottaNZB according to the steps described above, a file called
INSTALLED_FILES is created in the source directory. This file is required to
run the following command with root privileges:

$ python setup.py uninstall

