home | running | live music | software | pictures | about

shnwrap installation

quick 'n' dirty

download it, ungzip it, untar it, verify that it's executable, place it in a directory that's in your path, rehash, and call it.

slightly slower 'n' less dirty:

shnwrap relies on two pieces of software: shorten and perl. if you don't have those installed on your system, shnwrap won't do you much good. perl is usually installed by default on most modern desktop unixes, and shorten is a pretty easy install.

once you have those prerequisites, and have downloaded shnwrap, gunzip and untar it to your favorite directory. (on Mac OS X, you can run the following command sans the quotes: "tar -xvzf shnwrap.tar.gz")

you should now have a file called shnwrap. to verify that it is executable, run the command "ls -l shnwrap". this should produce an output like this:

 -rwxr-xr-x   1 josh  unknown  7536 Mar 25 09:50 shnwrap
those "x"s tell you that it is executable. if you don't see the "x"s, run this command: "chmod +x shnwrap".

next, you'll want to put the script in a place where you can access it just by typing "shnwrap" at the command line. the following command should show you all of the directories that your shell looks for programs: "echo $PATH". on Mac OS X, you'll notice that there is an entry for a "bin" directory in your home directory (for me, it's /Users/josh/bin). you'll also probably notice that there is no bin directory there by default. you can create one with the following command: "mkdir ~/bin". usually, you'll want to put the script either in there or in /usr/local/bin. to move it there, the following command will help: "mv shnwrap ~/bin".

the last step is to tell the shell that there is a new command to look for. running the "rehash" command will do this. now, just type "shnwrap", and you're ready to go.

(c)opyright 2008 arcticlounge software. all rights reserved.