Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Fetching contributors…

Cannot retrieve contributors at this time

79 lines (53 sloc) 2.126 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
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.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.
.. _`keybinder`:
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.
.. vim: ft=rst tw=72
Jump to Line
Something went wrong with that request. Please try again.