NAME

       I8kbuttons - Monitor the status of Fn-buttons on Dell Inspiron laptops.

SYNTAX

       i8kbuttons [<options>]

DESCRIPTION

       The  i8kbuttons  daemon  monitors  the  status  of  the  two  volume buttons of the Inspiron 8000 and the
       corresponding Fn- combinations.

       When a button is pressed the daemon runs the corresponding command specified in the command-line options.
       By specifying the proper commnds it is then possible to control the volume of the sound mixer or run  any
       other command you like.

       It  must  be  noted  that  although the program has default commands for the various buttons there are no
       standard mixer command shipped with the many Linux distributions which can  change  volume  incrementally
       and  support  the mute/restore function.  The default commands must therefore be overridden with specific
       commands depending on which mixer software is installed. Example:

              i8kbuttons -u "aumix -v +10" -d "aumix -v -10" -m "aumix -v 0" -r 100 -v

OPTIONS

       The program accepts the following command-line options:

       -v, --verbose
              Verbose mode, show all commands executed.

       -u, --up <command>
              Specifies the command to be executed when the VolumeUp button is pressed.

       -d, --down <command>
              Specifies the command to be executed when the VolumeDown button is pressed.

       -m, --mute <command>
              Specifies the command to be executed when the VolumeOn/Off button is pressed.

       -t, --timeout <milliseconds>
              Specifies the interval in milliseconds at which the daemon checks the button status. Useful values
              are in the range 50-200. Default is 100.

       -r, --repeat <milliseconds>
              Specifies the autorepeat interval in milliseconds.  Useful  values  are  in  the  range  100-1000.
              Default is 0, i.e. no autorepeat. Autorepeat starts after an initial delay of 250 milliseconds.

       This  program  can be used by normal users or started as daemon by an init script. Under Debian GNU/Linux
       it is possible to  start  automatically  the  daemon  at  boot  by  creating  an  /etc/default/i8kbuttons
       configfile  and setting the I8KBUTTONS_UP_CMD, I8KBUTTONS_DOWN_CMD and I8KBUTTONS_MUTE_CMD variables with
       the command which must be executed by the program. Note the the /etc/default/i8kbuttons configfile is not
       installed by the i8kutils package because the program is usually run by normal users. If you want to  use
       it as daemon you must create the config file yourself.

FILES

       /proc/i8k
       /etc/default/i8kbuttons

AUTHORS

       Massimo Dal Zotto <dz@debian.org>

COPYRIGHT

       i8kbuttons  and  all the i8kutils programs, scripts and other files are distributed under the GNU General
       Public License (GPL).  On Debian GNU/Linux systems, the complete text of the GNU General  Public  License
       can be found in `/usr/share/common-licenses/GPL'.

SEE ALSO

       i8kctl(1), i8kmon(1)

Massimo Dal Zotto                                 6 April 2009                                     i8kbuttons(1)