** THE COMMANDS IN THE CLIENT ARE NOT ALL LISTED HERE (try /help) **

**************************
Linux Napster Client v1.4
**************************

Written by Kevin Sullivan. See COPYRIGHT.

Modified by Peter Selinger and others. See ChangeLog.


INSTALLATION:

To compile nap from sources, first do a "./configure", followed by a
"make". This will create the file "nap". If you downloaded a binary
distribution for your platform, you do not need to compile anything.

Create a config file .napconf in your home directory. As a template, you
can use the nap.conf.dist file that comes with the tarball. One new
addition is the ability to have the program prompt you for a password when
you run it if you feel unsafe leaving it in your .napconf. To use this,
just set your pass entry to "?"  ("pass=?") in the .napconf. Everything
else is pretty much straightforward except the connection entry. For this,
use this table:

Connection | Number
-------------------
Unknown    |  0
14.4       |  1
28.8       |  2
33.6       |  3
56.7       |  4
64K ISDN   |  5
128K ISDN  |  6
Cable      |  7
DSL        |  8
T1         |  9
T3 or >    | 10

For example, if you have a cable modem, you would set your connection
entry to 7 ("connection=7").  You may now use multiple upload
directories in nap. Just delimit each entry with a
semi-colon. Ex. "upload=/usr/local/mp3s;/mnt/c/mp3s"

RUNNING:

The first time you run this version of napster, you will want it to build a
file with all your current mp3s, so execute napster with this command:
"nap -b"
Everytime you download a new mp3, you will have to use this command when you
start the program.
If you get an error relating to the ncurses library, you will either have
to upgrade your current version or install it.

*Command Line Options*

-h, --help         - print this help message
-v, --version      - print version info and exit
-b, --build        - build library of your current mp3s to send to server
-B, --build-only   - build library and exit
-m, --create       - create new account from the information in config file
-r, --reconnect    - keep reconnecting until server connection established
-a, --autorestart  - automatically reconnect when connection to server lost
-q, --daemon       - run without user interface; file sharing only
-t, --notitle      - do not display the title bar (fixes messed-up displays)
-l, --nxterm       - try using a terminal which is compatible with most
                     systems (fixes messed-up displays)
-f fn, --config fn - specifies the config file to use (default $HOME/.napconf)
-x fn, --log fn    - log all transfers to a specific filename
-g fn, --logall fn - log everything to a specific filename
-s sv, --server sv - select a specific server (multiple -s opts possible)
-d n, --debug n    - set debug level
-u str, --user str     - specify Napster username
-p str, --pass str     - specify user's password
-e str, --email str    - specify user's email address
-U dir, --upload dir   - specify upload directory (multiple -U opts possible)
-D dir, --download dir - specify download directory
-P n-m, --dataport n-m - specify port(s) to use for incoming upload requests
-C n, --connection n   - specify connection speed number (see README)
-M n, --maxuploads n   - specify maximum number of simultaneous uploads


IN CLIENT:

Assuming you are familiar with ircii or BitchX or another UNIX IRC client,
you should have no trouble figuring out this client. Here is a command list:

*Regular Commands*

/help <command> - Returns help on the specified command.
/join <chan> - Joins channel "chan".
/part [chan] - Parts channel/query "chan", or if the 2nd argument is
               omitted, the current channel/query.
/quit - Exits the client.
/tquit - Leaves the client running and exits it when all transfers have
         finished.
/disconnect - Disconnects you from the server.
/reconnect - Reconnects you to the server.
/tell <user> <message> - Sends a private message.
/msg <user> <message> - An alias for /tell.
/me <msg> - Performs an action with the message specified.
/whois <user> - Returns information on the user you specify.
/finger <user> - An alias for /whois.
/g <numbers> - Attempt to get the file numbers which are returned with
               /search. (ex. /g 60-63,31,75)
/search <opts> <string> - Performs a search for a file matching "string".
*Note* For ping times to be returned with /search, root privileges are
       required.
/browse <user> - Browses a user's files.
/pup - Prints out a list of your current uploads.
/dup <number> - Deletes the upload number "number" retrieved from /pup (Only
                works if transfer hasn't started.)
/pdown - Prints out a list of your current downloads.
/ddown <number> - Deletes the download number "number" retrieved from
                  /pdown.
/dns <host/IP> - Attempts to resolve a hostname or IP.
/clear - Clears your screen buffer.
/ping <user> - Pings another user.
/clist - Returns a listing of the current channels, the number of users and
         the current topic.
/clist2 - The same as /clist except that it returns user created channels as
          well.
/names [channel] - Returns the current userlist of your current channel or
                   the channel you specify (you must be on the channel).
/window - Allows you to open every channel/query in a seperate window, which
          can be cycled through with Ctrl-X.
/query <user> - Starts a private message conversation between you and
                "user". Queries act like channels.
/about - Returns some information about the client and "thank you"s.
/ignore <user> - Attempts to ignore a user.
/unignore <user> - Attempts to unignore a user.

*Aliases*

/alias <name> <alias> - Attempts to create an alias with the name specified.
Special Alias Variables:
$1 - Replaces all occurences of $1 in "alias" with the first argument given.
$2 - Replaces all occurences of $2 in "alias" with the second argument given.
...
$1- - Replaces all occurences of $1- in "alias" with the first argument as
      well as all following arguments.
$2- - Replaces all occurences of $2- in "alias" with the second argument as
      well as all following arguments.
...
/unalias <name> - Attempts to unalias the alias "name".
/aliaslist - Returns a list of all created aliases.
/loadalias <filename> - Attempts to load aliases from "filename".
*Note* A file with the name "alias" is automatically loaded everytime the
       client is started.
/savealias <filename> - Attempts to save aliases to "filename".

*Navigation*

Page Up/Ctrl-E - Scrolls the screen up 10 lines.
Page Down/Ctrl-D - Scrolls the screen down 10 lines.
End - Returns to the bottom of the screen.
Ctrl-X - Switches between current channels.
Ctrl-L - Refresh the screen.
Ctrl-B - Toggles bold (only compatible with this client as far as I know).
Ctrl-T - Scrolls the topic.
Tab - Attempts to autocomplete a command or username.

COMMENTS:

If you discover a bug, or have a question, comment or suggestion, please
report them to me. (Sorry I haven't responded to a lot of emails, I've been
really busy with schoolwork, although I do read them all.)

Kevin Sullivan
Ignitor
http://www.gis.net/~nite/
nite@gis.net
