Building sushi IRC from Source

First of all, this article is for users who want to use a feature of sushi that is currently not released in any binary package but don't exactly know how to build an application, especially sushi, from source. If you're an advanced user and you're searching for help with an error while compiling, feel free to ask in our IRC channel or submit a bug/question on launchpad.

For a beginner I would suggest to download a nightly source package from http://sushi.ikkoku.de/downloads/nightly/. It contains all sushi components.

You can also get the source directly from the development repository. This is a bit more complicated, plus, if you want to build all components you have to fetch them separately.

• Check out the git repository for the component you want to build:

  git clone git://ikkoku.de/sushi/<component>
  

  For example:

  git clone git://ikkoku.de/sushi/maki

  Following components are available right now:

  • maki
  • tekka
  • nigiri

Every sushi component has it's own INSTALL file. This file contains information about how to build the component.

maki's INSTALL file says:

Just type "./waf configure --prefix=${HOME}", followed by "./waf install". This
will install all the necessary files in your home directory. Other directories
can be specified with the prefix option, for example, "./waf configure
--prefix=/usr".

It refers to a file in the component's directory. The waf script. It should take all the complicated stuff for you and build the package if all requirements are met. Those requirements are checked with the “configure” command. If a required package is missing you have to install it manually. If you're using a binary package based distribution like Ubuntu or Debian it is perfectly possible that the required package is in a higher version than your package system offers. This is a situation where this article won't help you, there are several guides on how to manually build a required package, just search for it.

tekka and nigiri are both written in Python so they don't need to be build. But there are files which need to be processed. The build process is the same as in maki. Additionally you can look in the INSTALL file for further help.

If you are using the Ubuntu Mono Theme you can run the configuration with an additional flag to install all necessary Ubuntu Mono Icons:

./waf configure <other options> --ubuntu-icons

Beware: This will work only if you're installing to /usr or /usr/local. Home directories are not supported yet. The icons will not be displayed then.