# $Revision: 1.11 $, last changes made $Date: 2001/05/25 05:44:00 $
// AutoNap 0.5.1

AutoNap serves as a napster/opennap client running on the console. So its domain 
is probably to run on a machine with a good bandwidth controlled via ssh.
When writing it, my idea was letting AutoNap run as a cronjob and every, say, 
hour or so connecting to a server, looking for some songs, downloading them and 
quitting. This, though, will come in the next major release. ;-p


Requirments:
------------
   + Perl 5.6 or higher
   + MP3::Info
   + MP3::Napster (either 2.02 or 2.04 but NOT (!!!) 2.03)
   + Term::Readkey and Term::ANSIColor 
   + Term::ReadLine when using AutoClient

Is any of these modules missing you will have to install these first.
The saftest way is to use the very perlish of using the CPAN-shell:

   perl -MCPAN -e shell

In case this is the first time you issue this command, the CPAN-shell
will ask you a couple of questions. The default values usually do.
After that, being inside this shell:
   
   install Term::Readkey  (or perhaps 'install Term'....'install Bundle::Term'?)
   install Term::ANSIColor
   install Term::ReadLine
   install MP3::Info
   install MP3::Napster

Perhaps even a 'install Bundle::MP3) works, no idea.


Installation:
-------------
There are now two ways of doing that.

1) The easy one

Use the supplied configure.PL with

   perl configure.PL

You can supply exactly two arguments, which will
then override the default executable path (/usr/local/bin)
and the according manpath (/usr/local/man). So, if you want to
promote to AutoNap to reside in an even more priviliged path 
(very recommended ;-) call:

   perl configure.PL /usr/bin /usr/man

Well, kidding. Don't do it. /usr/bin usually isn't for miscellaneous
programs such as AutoNap.pl is one. Just use the default, works fine
and goes along with the Linux conventions.

Then fire off

   install.sh install

or check it before installing just in case. You need to be 
root for that.

   install.sh remove

will wipe off AutoNap.pl again from your box. 


2) Doing it manually (with perhaps more control)

Don't do it! Use configure.PL with the approriate options.
For making a local installation in your home-dir, make:

   perl configure.PL ~/AutoNap ~/AutoNap/man ~/AutoNap

and then call 

   ./install.sh install

and no global directories should be touched and thus not
requiring you to be root.
Be aware, however, that doing it this way, AutoNap.pl wont
by default be in your path. If you want it to be there, add
   
   PATH=$PATH:/yourhomedir/AutoNap

to your .bashrc or whichever dotfile is responsible for your own
path-variable.
Furthermore, the man pages wont be accessible by typing just 
'man AutoNap.pl'. If you want that to work, you have to set your
manpath accordingly.

So, best way is always to be root at installation. AutoNap wont
affect any other programs anymore in 0.3.0.

Having troubles?
----------------

First be sure that AutoNap.pl resides in your path. Check this with

   echo $PATH

and examine whether this goes along with the location of AutoNap.

Secondly, AutoNap needs to have set the right permissions, something like:

   -rwxr-xr-x    1 root    root       7515 Mar 16 09:40 AutoNap.pl

If this is not the case, type
 
   chmod 775 /path/to/AutoNap.pl

But actually install.sh should have already cared for that.

In case you get errors from the Perl interpreter when running AutoNap, just 
send me an email with the output. Or just send me an email if you other 
problems to <Tassilo.Parseval@post.rwth-aachen.de>.
And send me money, lots of that! Ask for information on how to do that. ;-)

Please be sure to read README-running before starting AutoNap. This might make
your life a little easier.