SqueezeIR‎ > ‎

Installation

 
If you are uprading from SqueezeIR v0.7 or later you can skip all of the one-off setup and start here.
If you are installing SqueezeIR onto your Controller for the first time, or upgrading from v0.61 or earlier, there are a few things that need to be done first:
  1. If you are upgrading from SqueezeIR v0.61 or earlier then you will need to remove it from all of your Controllers.  My experience is that the Applet Installer gets confused if you try to install an applet from a repository that has previously been installed manually.  Just SCP into the Controller and delete the SqueezeIR folder, then restart it.
    NB: Remember to take a backup of the data folder containing your precious configuration files first!
  2. On your Squeezebox Server computer, find the Squeezebox Server skins folder.
    TIP:  On a default Windows installation this is C:\Program Files\Squeezebox\server\HTML\, on Linux it is /usr/share/squeezeboxserver/HTML/.
  3. Within the skins folder create a new folder called SqueezeIR (case sensitive).
    NB: Ensure the file permissions on the newly created folder match those of the existing skins folders.
  4. Within the SqueezeIR folder create a folder called html (case sensitive).
  5. Within html create a folder for each of the Controllers that you wish to use SqueezeIR with.  These folders must have the same name as the MAC address of the Controller but without any punctuation and must be in lower case.
    TIP:  The Controller's MAC address can be found by going to Settings>Advanced>Diagnostics.
    TIP:  If you have more than one Controller you can create a text file here to record which folder belongs to which controller.
  6. Each of the folders created in step (5) must have a SqueezeIR.xml configuration file in it.  If you are using LIRC files then they also need to be placed in this folder and must have a .txt file extension (I use .lirc.txt for clarity but that's just me).
    NB:  I don't know if these files will persist after a server upgrade so keep a backup copy of them elsewhere on your system.
    TIP:  New users can download a sample file to get started with from here.
    TIP:  Existing users can use their current files but check the change log and configuration page for any important changes.
     
    If you have more than one Squeezebox server on your network you will need to repeat steps (2) - (6) on each server as SqueezeIR will download its configuration files from a randomly selected server.
    If you've done it correctly then you should have something that looks like this (possibly without any LIRC files though):
The next step is to configure Squeezebox Server to use my repository:
  1. Go to the Plugins tab in the Settings screen and enter http://www.woodbine.me.uk/squeezebox/repo.xml into the next free Additional Repositories box and click Apply.  You will not see SqueezeIR appear on the list of Available Plugins but that is normal as the Plugins screen does not show applets:
That's all the one-off setup completed so all that remains is to install the SqueezeIR applet onto the Controller:
  1. On the Controller, go to Settings>Advanced>Applet Installer.
  2. You should see Squeeze IR on the list (if not then check the repository is setup correctly).
  3. Select Squeeze IR and then select Install (or Update).  The Controller should download the applet from my repository and then restart.
  4. After the Controller has restarted, go to Settings and check that there is a Squeeze IR option at the bottom.  If SqueezeIR failed to install then try repeating step (3).  Alternatively, you can install SqueezeIR manually by downloading the applet and following the instructions on the Squeezebox Wiki.

SqueezeIR is installed and you can now look at how to configure it.