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)