Installing on ArchLinux

From Tuxisalive

Jump to: navigation, search

This articles applies to : Software Suite v3

This How-to is intended for : ArchLinux users


English  • Français


Contents

Base installation

Satisfying the dependencies

You have to install these ebuilds: 

openjdk6
setuptools
pyxml
portaudio
lame
sox
libstdc++5
unzip
mplayer

Notes : 64 bits users must install the ia32 compatibility libraries. These libraries are usually available in your distribution repositories.

You can install all these dependancies with the following command : 

pacman -Sy openjdk6 setuptools pyxml portaudio lame sox libstdc++5 mplayer

Downloading the main package

The first step is downloading the software package.

The download server is organized as following : 

Root folder for the installers
 `- Version of the installers
     `- Language of the installers
         `- Installation packages

You will find several packages :

  • tuxbox-language-version-amd64
  • tuxbox-language-version-i386
  • tuxbox-language-TTS-version-amd64
  • tuxbox-language-TTS-version-i386

The packages with TTS are bigger, because they contain the voice engines. It's strongly recommended to use these packages, even when you want to update your current installation.

Please be careful to select the right architecture for your system. Packages containing i386 have been made for 32 bits OS. Packages containing amd64 are for 64 bits OS.

To be sure to download the latest package, you can use the direct links :


Installing the main package

The tarball method

Unpack the package, and go to ./tuxbox-LANGUAGE-(TTS)-ARCH

To install all the software, simply type : 

./install # As root

The script will copy the files onto your system. You'll find all the applications in /usr/share/tuxdroid. The APIs sources are installed in /usr/lib/tuxdroid and the python API is installed in /usr/lib/python2.x/site-packages/tuxisalive


Init script

A node of the software layer is a HTTP server. If this server is not running, you won't be able to communicate with your Tux Droid. This server also loads the driver, and the TTS library.

The best way to never forget to start the server is by installing it in the runlevels. This will start the server at boot time. To do this, you have to install a special script. 

#!/bin/bash
 
PATH=/usr/sbin:/usr/bin:/sbin:/bin
DESC="HTTP server for Tuxdroid"
NAME=tuxhttpserver
DAEMON=/usr/bin/tuxhttpserver
DAEMON_ARGS=""
PIDFILE=/var/run/$NAME.pid
 
. /etc/rc.conf
. /etc/rc.d/functions
 
case "$1" in
    start)
	stat_busy "Starting tuxhttpserver"
	if [ -a $PIDFILE ]; then
	    stat_fail
	else
	    $DAEMON
	    if [ $? -gt 0 ]; then
		stat_fail
	    else
		$DAEMON --start
		stat_done
	    fi
	fi
	;;
    stop)
	stat_busy "Stopping tuxhttpserver"
	if [ -a $PIDFILE ]
	then
	    PID=`cat $PIDFILE`
	    kill $PID > /dev/null
	    if [ $? -gt 0 ]; then
		stat_fail
	    else
		rm $PIDFILE
		$DAEMON --stop
		stat_done
	    fi
	else
	    stat_done
	fi
	;;
	restart|force-reload)
	$0 stop
	sleep 1
	$0 start
	;;
esac
exit 0

For now, the init script isn't in the package so you have to copy it into /etc/rc.d/tuxhttpserver

You can start the server with 

/etc/rc.d/tuxhttpserver start

To launch the server at startup, edit /etc/rc.conf, and add tuxhttpserver in the daemon list. 

 DAEMONS=( ... tuxhttpserver ... )

Testing your installation

Now, the base installation is finished. You will be able to test your Tux Droid !

Please make sure your dongle is plugged in and Tux is turned on. The LED's in both the dongle and Tux should be lit, indicating they are both connected to each other.

The first time, the server must be started manually. To do it, type the following command : 

$ tuxhttpserver --start #as normal user

or use the launcher located on "Applications / Accessories / Tux Box2.0

A very quick test that can be done to test Tux, is by sending some commands with the Python API. From a terminal, type the command tuxsh. This will open a Tux Droid shell. 

tuxsh
>>> tux.eyes.on(2) # Will blink the eyes
True
>>> tux.flippers.on(2) # Will flap the wings
True
>>> exit()

If the commands return False instead of True, it means that your installation has a problem.

Please see this article to know how to fix the problem : Troubleshooting


If the installation seems OK, you can now start the graphical interface. The new graphical interface is web-based, so is accessible from a web browser such as Firefox.

To start the graphical interface, open a web browser and go to http://127.0.0.1:54321 .


Installing the Text-To-Speech (TTS) (optional)

If you've installed tuxbox without the TTS voices, please read the below titles to know how to install the voices manually. If you've choosen the complete tuxbox package with the TTS engine, your installation is done. at this step.

Downloading the language file

The TTS will allow your Tux Droid to speak. This functionality is optional, but is used for the majority of the Tux Droid software.

The Acapela license allows to install two different languages. The available languages are :


Installing the language file

All the packages contain a script named WIZARD. Once the archive is unpacked, go in the directory, and type the following commands : 

./WIZARD # You need to be root to do that


The languages are installed in /opt/Acapela/TelecomTTS/babtts/engines/. By browsing this directory, you can see the installed languages.

After installing a new language, you have to restart the server. 

/etc/init.d/tuxhttpserver restart  # as root


Testing the voices

The easiest way to test the voices are with the python API.

Once again, we will use tuxsh : 

tuxsh
>>> tux.tts.getVoices()
['Heather', 'Ryan', 'Bruno', 'Julie'] # The english and french male / female voices
>>> tux.tts.setLocutor("Bruno")
>>> tux.tts.speak("Bonjour, je test mon installation de Tux")
True
>>> tux.tts.setLocutor("Ryan")
>>> tux.tts.speak("Hello, I'm testing my Tux Droid installation")
True
>>> exit()

If the voice list is empty, or if the commands return False, something is not installed correctly.

Please see this article to know how to fix the problem : Troubleshooting


The high level software

TODO : Control Center introduction on Linux.

Retrieved from "http://wiki.tuxisalive.com/index.php/Installing_on_ArchLinux"
Personal tools
information strucure
development tools
miscellaneous