GTKPBBUTTONS(1)

NAME
gtkpbbuttons - a visual client for pbbuttonsd to display adjustments on a X desktop.

SYNOPSIS
gtkpbbuttons [options]

DESCRIPTION
gtkpbbuttons 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 without 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 support 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 managers using the X session protocol.

If GtkPBButtons was built with GNOME session management support, GtkPBButtons 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.

OPTIONS
gtkpbbuttons 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, gtkpbbuttons.themes (5)

AUTHOR
Matthias Grimm.