Fetching contributors…
Cannot retrieve contributors at this time
79 lines (53 sloc) 2.08 KB

kupfer is a simple, flexible, launcher for Gnome

Credits:Copyright 2007--2009 Ulrik Sverdrup <>
Licence:GNU General Public License v3 (or any later version)


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
chmod +x waf

Installation follows the steps:

./waf configure


./waf install


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.5 or later, and the following important libraries:

  • gtk python bindings, version 2.14
  • glib python bindings (pygobject) 2.18
  • dbus python bindings

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)
  • cjson (only req for Python 2.5, not 2.6), for web browser bookmarks
  • rst2man

Some plugins might require additional python modules!


Kupfer is installed as kupfer into $PREFIX/bin.

Keybinder Module

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.