This project is configured for waf; waf is shipped in the distributable tarball but not in the repository. If you need to get waf, run:

wget -O waf http://waf.googlecode.com/files/waf-1.5.8
chmod  x waf

Installation follows the steps:

./waf configure
./waf

then:

./waf install

or

sudo ./waf install

You can use --prefix=$PREFIX when configuring to assign an installation spot. By default, Kupfer is installed for all users. Installing only for your user, the prefix ~/.local is often used; you just have to check that: ~/.local/bin is in your $PATH.

Kupfer requires Python 2.6 or later, and the following important libraries:

• gtk python bindings, GTK version 2.16
• glib python bindings (pygobject) 2.18
• dbus python bindings
• keyring python module

Optional, but very recommended dependencies:

• python-keybinder (see below)
• wnck python bindings
• gvfs
• xdg-terminal (to find which terminal application you use, if it's not Gnome Terminal)
• rst2man / python docutils to build manpages
• xml2po / gnome docutils to install mallard help pages
• python-keyring-gnome or python-keyring-kwallet

Some plugins might require additional python modules!

Kupfer is installed as kupfer into $PREFIX/bin.

Kupfer uses tomboy's keybinder code, just like many other applications do for global keybindings. I had to break out the python wrapping of the code into a standalone python module keybinder that you need to install first.

Now you can set kupfer's keybinding by editing kupfer's config. See kupfer --help for how to do that.

You can use kupfer without the keybinder module, for example by assigning a global keybinding to the kupfer binary, but it not the recommended way.