How to install on Linux
From Tuxisalive
This article describe the differents way to install the Tux Droid software suite on Linux.
Contents |
Installing Tux with the Debian packages
If you're using a debian based distribution, the easiest way is to use the debian packages.
This installation is done in three steps :
- The base installation, to install the server, driver, and the API.
- Installation of the gadgets, control center and the tools.
- Installation of a TTS voice.
The base installation
Before installing package on Debian Lenny, you need to add debian-multimedia repository, since it provides lame library: echo "deb http://www.debian-multimedia.org lenny main" >> /etc/apt/sources.list apt-get update
1. If a previous installation of tuxsetup is present on your computer, it's recommended to uninstall it before installing this package.
2. Download and save the latest debian package :
Notes :
- If you're using Ubuntu7.10, you have to download 'tuxsetup-2.x.x-ubuntu7.10.deb' (only available for 32 bits). For all newer versions of Ubuntu, download 'tuxsetup-2.x.x.deb'
- If you're using a 64 bits OS, the TTS will not work. This is a known limitation, and we're currently searching a way to make the TTS works on 64 bits OS.
3. Right-click on the package, and select "Open with 'GDebi Package Installer'", or open a new terminal :
cd ~/Desktop dpkg -i tuxsetup-VERSION-ARCH.deb
4. apt-get -f install
How to update the Control Center and the gadgets
At the end of the debian package installation, the Control Center, gadgets and tools are automatically updated. You can always update the Control Center, the gadgets and the tools by using the tux_updater script.
$ tux_updater #Update only the user directory $ sudo tux_updater # Update the file on the system (included the Control Center)
Before running this script, it's strongly recommended to close the Control Center.
How to install TTS voices
For Text To Speech function, additional installation of voice files is required (download here).
Download the language of choice on your desktop. To install the voice package, follow the instructions described at 1.3.3.
Installing Tux with the tar.gz packages
This section describes how to install the Tux Droid software suite with the tar.gz packages.
This installation is done in three steps :
- The base installation, to install the server, driver, and the API.
- Installation of the gadgets, control center and the tools.
- Installation of a TTS voice.
The base installation
1. If a previous installation of tuxsetup is present on your computer, it's recommended to uninstall it before installing this package.
TODO: provide information where you can find rpm packages for pre-requisite packages for common distributions (OpenSUSE, Fedora, Centos)
2. Be sure dependencies are satisfied :
- java jre 1.6 or higher /or openJDK runtime environment 1.6 or higher (java -version to get the version of your java installation) from sun java or openjdk
- python-setuptools
- python-dev (devel)
- python-xml (pyxml)
- python-ctypes
- libstdc++5 (libstdc++)
- portaudio2
3. Download the latest package :
Notes :
- If you're using a 64 bits OS, the TTS will not work. This is a known limitation, and we're currently searching a way to make the TTS works on 64 bits OS.
4. To install the package, run 'make install' as root.
5. Start the server
$ python /usr/share/tuxdroid/tuxhttpserver/tuxhttpserver.py # as root.
To get automatic server launch at startup, you have to install an init script
6. Test your installation : Open a new python terminal :
>>> from tuxisalive.api.sh import * >>> tux.eyes.on(2) # The eyes should blink one time. >>> exit()
or use tuxsh :
tux.eyes.on(2) quit()
How to update the Control Center and the gadgets
You can always update the Control Center, the gadgets and the tools by using the tux_updater script.
$ tux_updater #Update only the user directory $ sudo tux_updater # Update the file on the system (included the Control Center)
Before running this script, it's strongly recommended to close the Control Center.
How to install TTS voices
For Text To Speech function, additional installation of voice files is required (download here). Download the language of choice, unpack and run the included wizard. To test your language installation, restart the server and open a new python terminal :
>>> from tuxisalive.api.sh import *
>>> TuxAPI is connected.
>>> tux.tts.speak("test") # Tux should say "test"
>>> exit()
or use tuxsh :
tux.tts.speak("test")
quit()
Other packages
Creating packages for different distributions is a big job. This takes time and a requires a good knowledge of the distribution.
If you want to create packages for your distribution, your contribution is welcome.
For more information, please post a message on the developers forum
