summaryrefslogtreecommitdiff
path: root/app-laptop/pommed/pommed-1.31/INSTALL
blob: 63d39c5146db4754b286a2150302040637a50679 (plain)
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
Installation instructions for pommed
------------------------------------

pommed  - the daemon
gpomme  - GTK+ client
wmpomme - WindowMaker client


Building
--------

pommed requires:
 - pciutils / libpci (on Intel machines only)
 - libofapi aka oflib (PowerMac machines only, see below)
 - zlib
 - libconfuse
 - libdbus
 - libasound
 - libaudiofile
 - eject

gpomme requires:
 - libdbus
 - libdbus-glib
 - GTK+ 2.0
 - glade 2.0

wmpomme requires:
 - X11 libs
 - libdbus


To build everything, just run make from the top-level directory, or:
 - make pommed, to build pommed
 - make gpomme, to build gpomme
 - make wmpomme, to build wmpomme

For PowerPC machines, if you do not have libofapi installed, can't find it or
do not want to install it, run make pommed OFLIB=1 to use the embedded copy
of libofapi.


Installing
----------

To install pommed:
 - copy pommed somewhere in your PATH (/usr/bin)
 - copy pommed/data/* to /usr/share/pommed
 - copy pommed.conf.(mactel|pmac) as /etc/pommed.conf
 - install the pommed.init initscript as /etc/init.d/pommed, make it executable
   and perform any additional configuration needed on your system (links to
   /etc/rc?.d/ for instance)
 - configure DBus for pommed
    + if you have a /etc/dbus-1/system.d directory, copy dbus-policy.conf
      as /etc/dbus-1/system.d/pommed.conf
    + otherwise, copy dbus-policy.conf as /etc/dbus-1/pommed.conf and add 
          <include>pommed.conf</include>
      in /etc/dbus-1/system.conf, between the <busconfig>...</busconfig> tags
      (usually toward the end of the file, before the </busconfig> tag)
 - restart dbus

To install gpomme:
 - copy gpomme somewhere in your PATH (/usr/bin)
 - install gpomme/themes as /usr/share/gpomme/themes
 - install gpomme/po/$lang.mo as /usr/share/locale/$lang/LC_MESSAGES/gpomme.mo
 - copy gpomme/gpomme*.desktop to /usr/share/applications
 - copy gpomme/gpomme.glade to /usr/share/gpomme

Icons for gpomme are available in the icons/ directory. For the .desktop files
provided with gpomme to work, the icons should be installed under
/usr/share/icons/hicolor. PNG files go to the appropriate sub-directory
depending on their size, gpomme.svg goes to the scalable/ sub-directory.


To install wmpomme:
 - copy wmpomme somewhere in your PATH (/usr/bin)

Pick an icon from the icons/ directory to display in the dock. You can install
gpomme_32x32.xpm to /usr/share/pixmaps/wmpomme.xpm and use that in the dock for
instance.