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

LottaNZB aims to simplify and automate the download of binary news from the
Usenet, a world-wide internet discussion system. You can tell LottaNZB what
to download using 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.


Installation instructions
=========================

Dependencies
------------

First, make sure you have the proper dependencies installed.
Those dependencies are:

- hellanzb >= 0.13
- gtk >= 2.16
- python >= 2.4
- python-gtk2 >= 2.14
- python-kiwi >= 1.9.9
- unrar

For building LottaNZB (not running it):

- intltool

For SSL encryption support:

- python-openssl

The package names may vary depending on your distribution.

Build LottaNZB
--------------

    ``python setup.py build``

Install/Upgrade LottaNZB
------------------------

Run as root or by using sudo on Ubuntu systems:

    ``python setup.py install``

Launch LottaNZB
---------------

In a terminal:
   ``lottanzb``

Via the GNOME menu:
   Applications -> Internet -> LottaNZB Automated Usenet Client

Have fun with LottaNZB!


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``

