SYNOPSIS

       xvolume  [-mixer  device]  [-volstring string] [-fg color]
       [-bg color] [-timeout sec] [-geometry geometry] [-volumeup
       keyname] [-volumedown keyname] [-font fontname]

DESCRIPTION

       The  xvolume program displays a volume bar known from dif-
       ferent appliances and allows the user to change the master
       volume  up  and down by using keyboard shortcuts. The pro-
       gram is highly configurable.

OPTIONS

       Xvolume options specified on the command line override any
       options  specified  in  the  resources file (se section on
       Resources below).


       -display display
               Opens xvolume on a specified display (usefull  for
               dual head displays).  Defaults to current display.

       -fg color
               Standart toolkit option to control the  foreground
               color  of  the  volumebar  and  font.  Defaults to
               green to match the standart OSD color of  most  TV
               sets.

       -bg color
               Standart  toolkit option to control the background
               color of the volumebar and font.  If  you  do  not
               specify  the  background  color,  then  it will be
               transparent.  Defaults to transparent if not spec-
               ified.

       -geometry geometry
               Standart  toolkit  option  to specify the size and
               position of the window.  The  only  difference  is
               that you may not use negative values, ie. all cal-
               culations are done relative to the upper left cor-
               ner of the screen.  Defaults to 600x100+100+100.

       -font fontname
               Standart  toolkit  option  to specify the name and
               size of the font to display above the volume  bar.
               Defaults to misc-fixed-medium.

       -mixer device
               Uses  the  specified  mixer device file to control
               the master volume.  Defaults to /dev/mixer,  which
               is a standart location on supported systems.

       -volstring string
               and KP_Subtract.

RESOURCES

       All  aspects of the xvolume can be controlled by following
       resources.

       foreground (class String)
               The foreground color used to draw the  volume  bar
               with. Equivalent to the -fg option above.

       background (class String)
               The  background  color  for the bar window. Do not
               specify it at all to get a transparent  background
               color. Equivalent to the -bg option above.

       geometry (class String)
               The size and position of the xvolume window on the
               screen. Equivalent to the -geometry option  above.

       font (class String)
               Specifies  the  name  and size of the font to draw
               the string above the volumebar.  Equivalent to the
               -font option above.

       mixer (class String)
               A path to the mixer device file. Equivalent to the
               -mixer option above.

       volstring (class String)
               The string to print above the displayed volumebar.
               Equivalent to -volstring option above.

       timeout (class Integer)
               The  ammount  of  seconds  to  wait for user input
               before quitting. Equivalent to the -timeout option
               above.

       volumeup (class String)

       volumedown (class String)
               Keybindings for controlling the volume. Equivalent
               to the -volumeup and -volumedown options above.

NOTES

       The best way to use xvolume is to bind some  key  in  your
       window  manager to execute it and then use the up and down
       keys to control the volume while recieving a visual  feed-
       back from the OSD bar drawn on screen. It is also possible
       to directly adjust the volume by pressing the 1 through 9.





X Version 11               Release 1.0                 XVOLUME(1)