setting up canola 2.0


instructions for building and running the new Canola 2.0 release

Originally posted on - 27 Mar, 2009


Canola2, the best rated media center application for Maemo was just released as Free Software. ProFUSION has been working together with INdT on the development of Canola2, and the first non-beta release is just around the corner, with lots of the improvements that we’ve been making here.

With source code available (link no longer working, source code can be found here), there has been increasing interest by people to not only try it but also find out how it works. There is already work on packaging it for Ubuntu and other distributions, but those who wish to develop for Canola will probably want to build it themselves. Below there is some information that might help with that. The ProFUSION team has really enjoyed working on this project and expects the community will enjoy being part of it as well.

First of all, in order to build Canola and part of the Enlightenment Foundation Libraries on which it depends there are some libraries/applications that you need to have installed on your workstation. The following list is based on a clean install of Ubuntu 8.10. If you’re using other distributions, the package names will probably vary but should be easy enough to find.

apt-get install git-core subversion build-essential python-pyrex cython python-setuptools automake libtool zlib1g-dev libjpeg62-dev gettext cvs xorg-dev libpng12-dev libdbus-1-dev libsqlite3-dev libogg-dev libflac-dev libmp4v2-dev libvorbis-dev python-feedparser

Having those installed, you need to install EFL plus the Canola dependencies, such as Lightmediascanner. We’ve created a little script that will do just that for you, in the correct order, and also fetching the source code directly from the repositories so that you don’t have to do it all by hand. You can find the script here. It will create a directory src where it will download the source code for all projects, and also a directory local inside your $HOME where they will be installed, but remember that all this can be easily changed by editing the script.

After it finishes, there are some final steps to configure and run Canola. Add the following to your .bashrc:

PREFIX=$HOME/local/canola
export PKG_CONFIG_PATH=$PREFIX/lib/pkgconfig:$PKG_CONFIG_PATH
export PATH=$PREFIX/bin:$PATH
export LD_LIBRARY_PATH=$PREFIX/lib/:$LD_LIBRARY_PATH
export PYTHONPATH=$PREFIX/lib/python2.5/site-packages/:$PYTHONPATH

And then just:

cd src/canola
utils/compile_themes
terra-rescan-collections -c canola.conf
terra-disable-plugin -s -c canola.conf "Maemo System"
terra-enable-plugin -s -c canola.conf "Linux System"

Now, Canola is ready to run. In order to do it you need to start some services that Canola use and then Canola itself. This script will do just that. Have fun!