Jukebox Install


Jukebox mode is only supported in 2 ways:
  • XMMS (or noxmms) on *NIX platforms
  • Winamp (with the httpQ plugin) on Windows platforms


    • Also, let's cover what this guide is NOT. This is not a guide to:
  • Installing Linux/Apache/PHP/Windows/IIS/etc
  • Getting Audio working on your server
  • Making really good coffee


    • It is assumed that your server can play media through its sound card succesfully BEFORE proceeding with this guide.

    NOTE: (for *NIX users) Remember when testing the mpg123 (or whatever you test with) needs to be able to run and play audio AS the webserver user, since that's how Jinzora will interact with your audio hardware.



    Setting up on *NIX
  • No-XMMS
    		•  There are 2 possible ways to run Jukebox mode, with either XMMS or noxmms. We STRONGLY recommend noxmms, as you will not need X running to use it (and therefore can kind of get it to run as a daemon - well sort of anyway). So first we have to get noxmms downloaded and installed.

  •  
    		•  Getting and Installing noxmms

    The first thing you'll need to do is get and install noxmms. Now you're perfectly welcome to use XMMS, but I figure if you're using that you know how and can skip this step. Even if you plan on using XMMS, you really should think about using noxmms instead, as it really is much easier since your box doesn't have to be up and running X. Ok, enough of that, now just download noxmms from:

    Download No-XMMS

    Once you've got it downloaded you'll need to extract and compile it. While this guide is not intended to be an end all be all of compiling by any means, generally you'll be doing:

  • tar -zxvf noxmms-1.2.7.tar.gz
  • cd noxmms-1.2.7
  • sh configure --prefix=/usr/local (this can be any directory you want)
  • make (may take a while, remember that coffee link???)
  • make install (remember to do this with an account with proper permissions - like root)


    • Once you've got it compiled and installed successfully as a quick test just type:
  • noxmms
    • And make sure you don't get any errors (it should just sit there and do nothing). After a few seconds just do a control-C to break out of it and proceed to the next step below.
    NOTE: You WILL NOT be able to install XMMS-Shell if you haven't completed this!





  • XMMS-Shell
    		•  Now that you've got XMMS (or hopefully noxmms) installed and working we need to get XMMS-Shell going so that Jinzora can control XMMS.

  •  
    		•  Getting and Installing XMMS-Shell

    First you'll need to download XMMS-Shell:

    Download XMMS-Shell
    (we test with and use xmms-shell-0.99.3)

    Once you've got it downloaded you'll need to extract and compile it:
  • tar -zxvf xmms-shell-0.99.3.tar.gz
  • cd xmms-shell-0.99.3
  • ln -s /usr/local/bin/noxmms-config /usr/bin/xmms-config (since we don't have XMMS installed)
  • Make sure and check permissions on that file to make sure it can be read
  • sh configure
  • make
  • make install (remember to do this with an account with proper permissions - like root)
    		•




  • Permissions
    		•  Ok, now that you've got that all complied (fun, huh?) you need to setup all the permissions so that the webserver will be able to control XMMS.

    Ok, so let's set some permissions!

  • chmod a+s /usr/local/bin/xmms-shell (or wherever you installed it)

    • Now we'll need to do a symlink to the pipe that XMMS and XMMS-Shell use so that XMMS-Shell can communicate to it as root (don't worry it's not really root, we have to trick it into that)

  • ln -s /tmp/xmms_XXXXX.0 /tmp/xmms_root.0 (where XXXXX is the user that your webserver is running as)
    		•




  • Setting noxmms to run at boot
    		•  Ok, next we need to get noxmms to run at boot time as the user that the webserver runs as. We've written a little init script that we use to start that for us. We use this script on Slackware 9.1 and are not sure it will work on all Linux distrubutions.

    Download Init Script

    Once you've got the script downloaded (or do it on your own) you'll need to get noxmms running (remember it MUST run as the webserver user). Once you've got it running you should be able to log into Jinzora (you MUST be a Jinzora admin to see the jukebox controls) and start playing music (ensuring that when you installed Jinzora you choose "Jukebox Mode" as the install type. Click play on something and you should be jammin'!!!








    Setting up on Windows



  • Winamp
    		•  This is pretty simple, you just need to get Winamp installed and working. Please note that right now we only support Winamp 2.x, as the httpQ plugin seems unstable on Winamp 5.x You can get the older version of Winamp from our website at www.jinzora.org. If we shouldn't be providing this download we are sorry, just let us know...

  • httpQ Plugin
    		•  Now that Winamp is installed you'll need to install the httpQ plugin for Winamp. This can also be downloaded from our servers at www.jinzora.org. Once you download the plugin just install it. Once installed you'll need to configure it:
  • Open Winamp
  • Type a "Ctrl - P" to bring up "Preferences"
  • Click on "Plug-ins" "General Purpose"
  • Highlight "Winamp httpQ Plugin Version 2.1" and click "Configure"
  • Set a password, IP Address (we recommend 0.0.0.0), and TCP Port (we recommend 4800)
  • Check "Start Service Automatically"
  • Click "Start"


    • Be sure to leave your server logged in and Winamp running so that Jinzora can control it :-)

  • Jinzora Settings
    		•  Now that Winamp is going (and httpQ is installed) all you'll need to do is make sure that Jinzora is setup properly to communicate with it. In settings.php verify that the following settings are correct:

    $jukebox = "winamp";
    $jukebox_pass = "jinzora"; (or the password that you configured httpQ with)
    $jukebox_port = "4800"; (or the port that you configured httpQ with)


    That should do it! Enjoy Jukebox support on Windows!!!