====== Installing wooble on your OSD ======
This page details installing the wooble web interface on your Neuros OSD. Commands in the boxes should be typed into a [[http://wiki.neurostechnology.com/index.php/OSD_Telnet|telnet session]] to the OSD.
===== Upgrading from wooble 1.0 =====
If you previously installed the first version of wooble using [[:projects:Lpkg]] then follow these steps.

Firstly you need to grab a new version of Lpkg, which fixes a bug regarding upgrades:

  cd /path/to/your/osdroot
  . ./setup.sh        # (that is, two dots at the start, separated by a space)
  lpkg update
  lpkg install wget
  wget http://matthewwild.co.uk/projects/Neuros/lpkg/lpkg1.1.lpkg
  tar xf lpkg1.1.lpkg

To upgrade to the latest wooble, simply:
  lpkg upgrade

===== Installing wooble (for new users) =====

The easiest way of installing wooble is by using [[:projects:Lpkg]], a program that will help you install and manage various programs (packages) on your OSD.

Create a directory on your OSD, this directory will be used to store all programs that you choose to install. I refer to it from now on as osdroot.

Download Lpkg from http://matthewwild.co.uk/projects/Neuros/lpkg/lpkg1.1.lpkg and put it in your osdroot.

  cd /path/to/your/osdroot
  tar xf lpkg1.1.lpkg
  . ./setup.sh   # (that is 2 dots at the start, separated by a space. You need to do this every time you want to use Lpkg, when you are in osdroot)
  lpkg addfeed http://matthewwild.co.uk/projects/Neuros/packages.lpf
  lpkg refresh
  lpkg install wooble



===== Starting wooble =====

To start wooble:

  lpkg control luaetta start

Visit http://<IP address of your OSD>/ in your browser's address bar to see it in action!

:!: Don't forget to set a username and password on the configuration page, as well as some phrase to be used to protect your media files.

===== Staying up to date =====

To make sure you have the latest version of wooble:

  cd /path/to/your/osdroot
  . ./setup.sh
  lpkg refresh
  lpkg upgrade

===== iPhone support =====

If you have an iPhone or iPod Touch then you can install wooble_iphone, which adds an interface specially for those devices:

  lpkg install wooble_iphone

===== Feedback =====

Please report problems, and bugs, to the [[http://bugs.matthewwild.co.uk/index.php?project=4&do=index|wooble bug tracker]].

If you want live help with something, you can find me in #neuros on Freenode IRC. Alternatively there are other ways to [[:contact|contact me]].