--- Introduction ---

RN|Launcher is a small and simple server browser for Rainbow Network's 
OpenArena servers. It was written in Python by Joakim Soderlund and uses a 
slightly modified version of Gerald Kaszuba's PyQuake3 for retrieving server 
information.



	--- Installation ---

To run RN|Launcher you will need the following libraries and applications:

	* Python
	* GTK
	* PyGObject
	* PyCairo
	* PyGTK
	* ConfigObj

Most of these are included in many Linux distributions and are pretty easy to
install in Windows as well.



	--- Installation --- Debian based Linux Distributions ---

If you use a debian based distribution you should make sure that the following
packages installed:

	* python-gtk2
	* python-configobj



	--- Installation --- Microsoft Windows ---

Installing all these dependencies under Microsoft Windows requires some work
from the user. You will need to run a few installers but after that you will be
able to run any many Python and GTK applications.

First of all you should download and install Python 2 from http://python.org.
Installing Python is easy and straight-forward. Feel free to install Python
in any directory as the registery will keep track on where to find it.

When you're done with installing Python it's time to download GTK from
http://www.pygtk.org/downloads.html. You will have to download four installers:
	
	* GTK
	* PyCairo
	* PyGObject
	* PyGTK

This might seem like a lot but the Python libs are very small.

Start with installing GTK anywhere in your system, this is also easy and
straight-forward.

After that you've installed GTK you will have to run the installer for
PyCairo, PyGObject and PyGTK. The installer should automatically find your
Python directory and install the Python libs there. Do not change the
installation directory if it has been detected automatically.

Ok! You have finnished setting up Python and GTK. It's time to install the last
lib called ConfigObj which helps the application to keep track of your settings.

You can install ConfigObj in several ways. The first way is to download the
configobj.py file from http://www.voidspace.org.uk/python/configobj.html#files
and save it to the Lib directory in your Python installation. 

If you don't like the sound of that you can download the configobj.zip file
from the same page and run the included setup.py file with the parameter 
install. In other words "setup.py install".

If you had the patience to do all this then you're ready to use RN|Launcher!



	--- Usage ---

To start RN|Launcher all you need to do is run rnlauncher.pyw.

When RN|Launcher is running you should tell it where to find OpenArena by
clicking on the Settings button and specifying the path to your OpenArena
binaries. You could also check the Refresh Servers on startup if you want
RN|Launcher to update the server list directly when it has been started.

When you've set up the path to your binaries all you need to do is to click the
refresh button and double click on a server!



	--- Special thanks ---

I would like to thank Gerald Kaszuba for writing the excellent PyQuake3 module
which made it easy to query OpenArena servers.

I would also like to thank Karmazilla and Jack Thompson for helping me with 
writing PyQuake3Master.



	--- Contact information ---

f you would like to contact me I'm usually online as "JockeTF" at
irc.freenode.net. Feel free to drop me a message or, if I am offline, a memo.

You can also reach me on XMPP (also called Jabber and GTalk). Just add
JockeTF@jabber.org to your contact list.