• Install
  • Usage

    Install

    You'll need to have the Java environment version 1.3 or better installed to use JAG. If you don't, head over     here to get a copy. (You'll probably just want the JRE if you only want to run JAG. If you're interested in development get the SDK or Forte).
    Now download the zip/tar file to somewhere on your computer (I'll assume it's in /tmp for the rest of this document).
  • Untar/unzip the file
  • change directories to the jag dir. (cd jag or doubleclick the folder you extracted).
  • Run JAG. This can be done a number of ways.

    *nix

    The nixJAG.sh script should get you running jag without a problem, assuming you have java somewhere in your path. Simply type 'sh nixJAG.sh' in the jag directory (/tmp/jag in this example).

    Windows

    If you are running windows you should be able to simply doubleclick the winJAG.bat file and as long as java is somewhere in your path things should be fine. (Installing java should put it in your path).

    Everything else

    So, I'd love it if I could write scripts for every os under the sun but sadly I don't have access to them all. If you're running on something not listed above you should be able to run jag manually by issuing the following command: 
    java jag.JAG
    You could potentially have classpath issues. If java complains about not being able to find a particular class, try and figure out where that class is supposed to be coming from. If it's a jag class (You would get an error like:
    Exception in thread "main" java.lang.NoClassDefFoundError: JAG
    in this case) make sure you're in the directory that was created when you unzipped jag. (An ls/dir should show README, COPYING, and directory called jag). You could try adding . (that's the current direcetory) to your classpath. (This can be done in bash by issuing 'export CLASSPATH=$CLASSPATH:.' or in csh with 'setenv CLASSPATH $CLASSPATH:.')
    If you're still having problems, drop me a line and I'll try my best to help.

    Usage

    When you first start JAG you should see the following screen:



    Follow it's advice. If you don't have an audiogalaxy account yet head to     http://www.audiogalaxy.com/account/newAccount.php to get one.

    After clicking okay you should see the following screen:

    You must enter a username and password (hopefully working ones) and at least one share directory. All songs you download will be saved in the first directory that is listed. If you want to change this later you can select Preferences under the Edit menu, add a new directory, select it in the list, and click Set D/L Dir.

    After filling in all this information you should get JAG up and running. On my machine it looks like this:

    If you ran it from a console a whole lot of debuggin stuff will fly by. You can ignore it unless you're interested in what JAG is actually doing. Now go to audiogalaxy.com, tell it you want to download some songs, and away you go:

    TADA!