1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
|
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.6.3
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.6 or later, and the following important libraries:
* gtk python bindings, GTK+ version 2.16
* 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)
* rst2man / python docutils to build manpages
* xml2po / gnome docutils to install mallard help pages
* `keyring` python module, and optionally its extensions
python-keyring-gnome or python-keyring-kwallet
Opportunistic dependencies
* The deprecated 'gnome' module is used for session connection as
fallback
* If available, 'setproctitle' is used to set the process name
* python-appindicator for ubuntu-style notification icon
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
|