--------------------------------------
 gnome-napster 0.4.1
--------------------------------------
 Copyright (C) 1999 Evan Martin 
 eeyem@u.washington.edu
 http://students.washington.edu/eeyem
 Andrew Parker
 zaphod42@u.washington.edu
--------------------------------------

Introduction
------------
I won't explain Napster here; visit http://www.napster.com for information
about what Napster is.
gnome-napster is a GNOME client for Napster.  

While many features are still unimplemented, development is proceeding quickly.
Please see the file TODO to see what my current development plans are.
Currently, you can download files, and that's about it.  I have tried to
disable everything that isn't implemented, so if you see a widget grayed out,
it isn't a bug!  It just means I haven't the time to finish that aspect yet.


What's new
----------
See the ChangeLog for detailed information.
gnome-napster 0.4.1 fixes some bugs found in 0.4.0.

Andrew Parker, that is I, is the new developer.  Development will definitely be
slower than under Evan(I don't think I can go through 6(?) releases in one
month).  It is in a semi working state now, enough to download files.  I hope
to get the Hotlist support up in v0.5.0, then probably work on the download
code(it really needs help;).


Installation
------------
Read README.install.
READ THE _BUGS_ FILE!!!!!!!

Logging in
----------
To log in to Napster, you need a login account.
Check the "Create User" box in the login dialog to have gnome-napster create an
account.  It seems that Napster will allow you to login as anyone, though,
so this may not be necessary. (FIXME: Why is it like this?)

If you wish to manually choose a server (trying to find a friend online?), use
the "Manually specify server" option.  Otherwise, gnome-napster will find a
server, using the redirector specified in the Preferences.


UI Notes
--------
In the search results, the colored balls to the left of the song names are
a visual indicator of how fast their connection is.
Red - Modem or less
Yellow - ISDN 128k or less
Green - Everything faster. :)

The arrows by the Song Name "shift" the path of the highlighted files.
The best way to understand this feature is to highlight a file, and click
the arrows a few times.
Set the "default path depth" configuration option to "0" to effectively 
disable this.

There's a separate box listing hosts on the "Host" tab, because a future
version may track who's online.


Firewalls
---------
gnome-napster only connects outward.  Incoming connections (such as transfer
requests) aren't implemented yet.  As I understand firewalling, this means 
that there should be no problems with firewalls yet.
Please correct me if I'm wrong!


Bugs, bug reports and feature requests
--------------------------------------
Read BUGS.


Thanks
------
 - Napster <http://www.napster.com>
   If you, Mr. Napster, read this:  please send me protocol information, so I
   don't cause problems. :)
   I'd like to implement advertisements, but I don't want to invest time in
   figuring out how to do them, when I could be adding important features.
   This is a perfect time to supply me with some insider information.

 - Ryan Dahl, the "gnap" auther. <http://gnap.sourceforge.net>
   I plan to be stealing a bit of his source code. :)

 - Kevin Sullivan, the "Linux Napster Client" author. <http://www.gis.net/~nite>
   While he didn't "give" me any information, his program provided an
   inspiriation.  His client is console and binary only, but it is much more
   complete than gnome-napster. 

 - The Midnight Commander team <http://www.gnome.org/mc>   
   gtkflist.*, the list widget.  
   Why is the default GTK list widget so broken?  *sigh*

Code notes
----------
I would love any patches! Please follow the following guidelines:
 - I use four space tabs.  Sorry.  It looks better.

Patch Thanks
------------
 - Rasmus Bonnedal <d99rambo@dtek.chalmers.se>: endian fixes
 - Marek Mandre <marek@pld.ttu.ee>: solaris fix
 - Dave O'Neill <dave@nexus.carleton.ca>: sorting in search results 
 - Craig Newell <craign@cheque.uq.edu.au>: sorting, host browsing
 - Tom Sightler <ttsig@mindspring.com>: endian fixes

License
-------
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.


