1. Installing the tuxsetup package

Download the latest tuxsetup package from the download page. Currently a debian and tar.gz file are available.

On most machines installing the debian tuxsetup package should be quite easy. Double click tuxsetup and a graphical package manager should pop up and take care of everything.

If not, you can install tuxsetup manually from a terminal window:

• For the debian package, type from a terminal as root:
  
  For Ubuntu users:
  

  sudo dpkg -i /your/download/path/tuxsetup_1.2-37_i386.deb
  

  For Debian users:

  su -c "dpkg -i /your/download/path/tuxsetup_1.2-37_i386.deb"
  

  And you will get the follwing output:
  

  (Reading database ... 101344 files and directories currently installed.)
  Preparing to replace tuxsetup 1.2-37 (using tuxsetup_1.2-37_i386.deb) ...
  Unpacking replacement tuxsetup ...
  Setting up tuxsetup (1.2-37) ...
  tuxsetup: using the included binary of dfu-programmer.
  

• To compile the tar.gz file, open a terminal and go to the path of the downloaded file. Next type:
  

  tar -zxvf tuxsetup-1.2.0037-final.tar.gz 
  cd tuxsetup-1.2.0037-final/
  su
  make install
  

  If all goes well you get this:

  -------------------------------------------------------------------------------
  tuxsetup-1.2.0037-final
  -------------------------------------------------------------------------------
  Python API       v 0.2.3
  USB daemon       v 0.3.2
  TTS daemon       v 0.3.1
  Tux framework    v 0.1.2
  -------------------------------------------------------------------------------
  tuxsetup: dfu-programmer has been found on this system:
  dfu-programmer 0.4.1
  -------------------------------------------------------------------------------
  

  Done and done!

2. Installing Text To Speech Voice files.

This step is not mandatory but will give your Tux Droid the Text To Speech capability. It's free, it really works great and it's used in the existing applications already so it's a highly recommended installation. Note: if you want to use the Tux Gadget Manager, the installation of the voice files is required.

• Download the Acapela TTS voices you want to use from the download page.  You can choose between the debian package and the tar.gz version.
• To install the debian package just double click the file or use the same terminal command as displayed above for installing the tuxsetup package.
  
• Install the tar.gz package by extracting it and run the included wizard script from a terminal window.
  
• If your dongle is connected, unplug it, wait a couple of seconds and plug it back in. The new TTS voice will now be enabled.

Note: Only two different languages can be used at the same time! You can install more, but the TTS daemon will only handle two different voices at the same time. When you want to switch to a third installed language you need to replug the dongle.

3. Test the installation with tuxgi

IMPORTANT: If you have installed tuxsetup1.3-rc1 this step has become obsolete. The tuxgi was removed and replaced by the Controller Tool in the Gadget manager. Please continue here.

Now you are ready to go!

In case your dongle is not connected, or your Tux is switched off, do it now. Both the dongle and Tux will have the LED's lit, indicating the radio connection is established.

From a terminal, launch:

tuxgi

This will open the Tux Droid Graphical Interface. Check if the status of the daemons are ok. Both daemons are launched automatically when plugging in the dongle. Furthermore you see if the radio link between the dongle and Tux Droid is working.

Now you can start testing everything by clicking the buttons. Have fun!