Install

Quuxbox is distributed with an xml installation system written in python. The standard python xml libraries should work fine, and they are usually installed as part of the standard python installation. Unfortunately, debian does not install python in a standard way. You will need the python xml package as well as the developlment package to build some extension modules included with QuuxBox.

Dependencies

The basic QuuxBox runtime depends on the following packages.

• Python >= 2.2.1
• PyXML

To run the applications packaged with QuuxBox, you will additionally need the following packages.

• pygame
  • SDL
  • SDL_image
  • SDL_ttf
• PLWM
  • X Python Library
• Ogle
• LAME
• cdparanoia

Download

Go to the download page for information about how to get QuuxBox.

Install

Installation from a cvs snapshot is farily straightforward given the simplicity of our install system. Just unpack the source, cd into the directory, and then run install.py.

tar -xvf quuxbox-*.tar.gz cd quuxbox python install.py -system

If you need to change where files get installed, you'll have to edit config.xml. config.xml is used by the installation system to determine where files are installed and then it is copied to the CONFIG directory (defined in config.xml) and used for system configuration. If you already have a config.xml installed in one of the standard locations the paths defined in that will be used by the installation.

Running

(one terminal) # python /usr/lib/quuxbox/Init/init.py (another terminal) # cd /usr/lib/quuxbox/ # . setup.sh # python Util/appshell.py QuuxBox Application Process Shell Interact with remote process objects: start(...) - start remote application processes find(...) - find already running processes release(...) - release main process stop(...) - stop processes For more info: run help() on a command for pydoc info. >>> find("Servers.ComponentManager") >>> startApplication("Chooser") >>> [CTRL-D]

The first terminal shows messages printed by the various servers and such. The amount of output to this depends on how many applications enable debugging, and can be very verbose or quite minimal. Some exceptions that are printed can be ignored, others are generally bad news. Most fall into the second category.

Notes

Have Fun!