kupfer is a simple, flexible, launcher for Gnome
|Credits:||Copyright 2007--2009 Ulrik Sverdrup <firstname.lastname@example.org>|
|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 http://waf.googlecode.com/files/waf-1.5.8 chmod +x waf
Installation follows the steps:
./waf configure ./waf
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
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
- 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
Some plugins might require additional python modules!
Kupfer is installed as
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