Junkie, v0.3.1
===================

Junkie is an open-source GTK2 FTP client, with many great features, such as queues, site manager, edit/view on the fly. (see a more detailed list in 2.0 Features).  Junkie is released under the BSD license, see the LICENSE file for more details.



1.0	Installing Junkie
------------------------------
Prerequisites:
~~~~~~~~~~~~~~
You will need GTK2 (gtk2.0.3 or newer) and glib2.
	
If you wish to get sound support installed you will need to have ESD (Esound) installed, and if you want to be able to  Ogg-Vorbis files (with .ogg extension) you will need the libvorbis/vorbisfile libraries.  Support for MP3 is also included (libjamp) which is included in the source code of this package.  Libjamp is the AMP player (by tomislav uzelac) converted into a library by the Junkie development team.  Additionaly, users can enable support for old-school modules created in trackers, files with the xm, mod, s3m, it extensions, for this users need libmikmod installed on the system.

The configure script will detect which modules and which formats will be supported and the whole sound support is very optional so people are not required to have any of those libraries.

Simple Install:
~~~~~~~~~~~~~~~~
Start by running the configure script, to setup the Makefiles.
	./configure

Then type 'make' to build the sources.

Then finally do a 'make install' to install junkie on the system.


2.0	Features
-------------------------------


junkie's features include:
~~~~~~~~~~~~~~~~~~~~~~~~~~
preferences / config file support.,
event-driven ftp support.,
support for both ipv4 and ipv6 (ipv6 needs --enable-ipv6),
multi-site feature, lets u maintain connections to few sites simultaneously,
queue,
transfer speed limiting
preferences where you can fit junkie to your needs,
sound support & player bar with a playlist,
themable icon styles,
site manager,
caching of sites,
full dir upload/download
edit/view files on the fly,
drag and drop (downloads & uploads, also works with the queue, also works to move files/directories to directories),
yomomma jokes "amusement" feature,
"cute" things amusement feature.
	
	

3.0	Obtaining help
------------------------------
Since there is not much documentation available for junkie yet, please let us know about any bugs/errors you might encounter whilst running junkie.  It will be of benefit to both the users as well as ourselves.  We will try to compose a FAQ as we move along.  

If you have a bug, then you can post it on:

	http://www.sourceforge.net/projects/junkie


another way of meeting us would be to join #junkie on IRCnet (www.ircnet.com)


4.0	Feature Requests
------------------------------
Junkie is a relatively young project and we are very open to any feature suggestions.  If you would like to see some particular feature in Junkie then DO NOT HESITATE to post it.

If you have a feature suggestion, then you can post it through:

	http://www.sourceforge.net/projects/junkie


5.0	DEVELOPERS!!
------------------------------
We know you are out there... somewhere in this pythonic world of ours.  Anyway, to cut the crap.  If you are interested on working on junkie, you could start by posting patches, posting feature suggestions and just becoming active.

As you might know, you can post bugs, feature requests, etc. on:

	http://www.sourceforge.net/projects/junkie 

our homepage is,

	http://junkie.doomed.org




Copyright (c) 2002-2003, Gunnsteinn Hall, Joel Thomas, Martin Faxer, ya