1 About this document.

This tutorial was written by Chris Ball <chris@cpan.org>. Further itself was written by Evan Martin <evan@livejournal.com> and contributors. Further's web site is <http://further.sf.net/>.

2 Downloading Further.

From a directory where you have full access, run:

cvs -d:pserver:anonymous@cvs.further.sourceforge.net:/cvsroot/further co further

to check out the latest Further source code.

3 Satisfying dependencies.

Further depends, most notably, on the Evas library headers and Microsoft Typography Set.

3.1 Evas.

You can find out more about Evas at http://www.enlightenment.org/pages/evas.html - if you're running a Debian system, the Evas libraries can be installed via `apt-get install evas libevas`.

3.2 Microsoft Typography

You can download the Microsoft fonts from http://www.microsoft.com/typography/ .If you'd rather not use these fonts, it's possible to just substitute the references to them to something else in your conf files.

4 Building Further

$furtherroot = the directory you ran the cvs co command in. cd $furtherroot/further

make

cd $furtherroot/further/plugins

make

mkdir $HOME/.further

cd $furtherroot/further/conf

cp {launcher,rc} $HOME/.further

5 Customising your conf files

5.1 rc

• Change pluginpath/datapath to '$furtherroot/plugins/' and '$furtherroot/data/'
• Change fontpath to wherever you installed the typography kit.
• Change background to an image to use as your desktop background.
• Change launcher.rc to point to $HOME/.further/launcher

5.2 launcher

• The rc is grouped into two lines for every command. Ensure that the first of each pair points to the full path for a command, and that the second line points to an existing 48x48 pixel png image.

6 Running further.

From $furtherroot/further/, run './further' (this should have been built at the 'building further' stage. Keep an eye out for debug/error messages on stderr. If all goes well, you should see messages stating that each plugin has loaded successfully.

7 Troubleshooting.

• While building, I get errors about missing evas.h/gl.h/xlib.h - Install the -dev files for the missing library.
• Further builds fine, but when I try to run it I get a black background and garbled text - Your background image couldn't be loaded. Check the path.
• The task switcher and clock are missing, despite the plugin loading successfully - Check the font path.
• The launcher is missing, despite loading successfully. - Check the icon paths in your $HOME/.further/launcher file.
• None of the plugins loaded! - Make sure that you ran make in the $furtherroot/further/plugins/directory, and that it succeeded.