Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
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.
Python Shell

This branch is even with engla:pastebin-wip

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
kupfer.py
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
    ./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``.

Requirements
------------

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!

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.