GTKPBBUTTONS(1)GTKPBBUTTONS(1)NAMEgtkpbbuttons - a visual client for pbbuttonsd to display adjustments on
a X desktop.
SYNOPSISgtkpbbuttons [options]
DESCRIPTIONgtkpbbuttons is a client for pbbutonsd which visualize user adjustments
for display brightness and volume on a X desktop like for example the
Apple OS does.
Each time someone pressed one of the hotkeys, a small GTK popup window
would appear and show what happened. After roundabout two seconds with‐
out any changes, the popup window vanishes again.
This Client has support for battery warning messages from pbbuttonsd
built in. In case of a battery warning a popup window would appear and
a beep will be played (see sound subsystem options below and the man
page of pbbuttonsd for details).
The sound subsystem based on the audiofile library and POSIX threads.
If either the libaudiofile or the libpthread is missing at compile
time, the audio subsystem would be disabled. gtkpbbuttons is still
usable without audio.
GtkPBButtons uses popt for parsing command line parameters. The change
from getopt to popt becomes necessary as GNOME session management sup‐
port has been built in because GNOME uses popt, and getopt and popt
don't cooperate very well. Nevertheless it's called 'GNOME session
management support' it will also work with KDE3 and other session man‐
agers using the X session protocol.
If GtkPBButtons was built with GNOME session management support, GtkPB‐
Buttons would understand all GNOME specific command line options as
well. This options are not described in this manual page but a short
description will be displayed if the --help option is given.
Because of some design flaws in popt the option detach with an optional
PID file must be divided into two options (detach and pidfile) with
required options. See below for details.
GtkPBButtons will register itself at the server PBButtonsd to get the
desired messages. In case there is already an instance of GtkPBButtons
running, the new instance will replace the old one. The server will
send a ´Good Bye´ message to the old instance.
OPTIONSgtkpbbuttons accepts the following options:
-?, --help
Show summary of options.
-v, --version
Show version of gtkpbbuttons.
-d, --detach
Start gtkpbbuttons as background process.
In this mode we can't assume to have a valid terminal so all
outputs will be blocked and error messages will be rerouted to
syslog.
-p, --pidfile=PIDFILE
This option sets an alternative filename to store the PID in if
started as background process.
-a, --audio=DSP
Set an alternative audio device.
-t, --theme=THEME
Gtkpbbuttons is themeable and with this option the theme to use
could be chosen. Look in /usr/share/gtkpbbuttons/themes for
available themes. The argument of this option is the name of
the theme directory.
If this option was missing the default theme 'Classic' would be
chosen.
The former options --beep, --warnbeep and --popups are now handled by
the theme management and are not longer available as command line
switches.
SEE ALSO
pbbuttonsd (1), pbbuttonsd.conf (5), libaudiofile documentation, gtkpb‐
buttons.themes (5)
AUTHOR
Matthias Grimm.
April 3, 2005 GTKPBBUTTONS(1)