Skip to content
kupfer, smart, quick launcher. `master' is kupfer's release branch and tracks the main repository at http://git.gnome.org/cgit/kupfer/ ; All topic branches are Works in Progress and might be rebased. http://kaizer.se/wiki/kupfer/
Python Shell
Pull request Compare This branch is 1 commit ahead, 1788 commits behind engla:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
Documentation
contrib
data
extras
kupfer
po
.gitattributes
AUTHORS
COPYING
NEWS
README
debug.py
kupfer-activate.sh
kupfer.doap
makedist.sh
wscript

README

kupfer is a simple, flexible, launcher for Gnome
++++++++++++++++++++++++++++++++++++++++++++++++

:Homepage:  http://kaizer.se/wiki/kupfer/
:Credits:   Copyright 2007--2009 Ulrik Sverdrup <ulrik.sverdrup@gmail.com>
:Licence:   GNU General Public License v3 (or any later version)

Installing
==========

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 --prefix=$PREFIX
    ./waf

then::

    ./waf install

or ::

    sudo ./waf install

here ``$PREFIX`` assigns an installation spot. For all users, programs
are normally installed with prefix as ``/usr``.  Installing only for
your user, the prefix ``~/.local`` is often used; you just have to check
that:

* ``~/.local/bin`` is in your ``$PATH``
* ``~/.local/lib/python2.*/site-packages`` is in python's sys.path
  (if not, you can add it by setting ``$PYTHONPATH``)

Spawning
========
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`: http://kaizer.se/wiki/python-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
Something went wrong with that request. Please try again.