---
name: "gtkpbbuttons"
section: "1"
platform: "linux"
package: "gtkpbbuttons-common"
version: "0.6.9-2"
release: "Debian 5.0 (Lenny)"
platforms: ["linux"]
url: "https://new.carta.tech/gtkpbbuttons"
---

# gtkpbbuttons(1)

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

## 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.