=====================================
Volume.app -- a simple volume control
=====================================


HOW TO USE IT
-------------

* Startup: The -c option allows you to specify which channel the knob will
  control. The -l option prints an enumerated list of the available
  channels. As usual, -h prints the usage help text.

* To adjust volume: Left-click on the knob, and drag it up or down.

  Or, hover the cursor on the knob, and turn the mouse's wheel button up
  or down.

  Or, send the program a signal: USR1 decreases the volume by 10%, and
  USR2 increases it by the same amount.

* To mute/unmute volume: Double-click on the knob.


WHAT IT IS
----------

This is a simple volume control for the AfterStep / BlackBox / Window
Maker dock. It is based on an idea in timecop's WMixer program, and was
bootstrapped with his code base.

Volume.app is intended to be an extremely simple, efficient, and
attractive interface to a system's sound mixer. It differs from most other
dockapp mixer programs in that it does not require minute control of the
mouse to perform simple volume adjustments. It also lacks the ability to
monitor or control more than one mixer source at a time.

(NOTE: In the program's present state, it lacks the ability to even switch
between sources once it has started up. This is a feature that will
hopefully be added in the future; see the TODO file)

Currently, only the only Linux OSS mixer interface is supported. Adding
support for other sound architectures requires only that the corresponding
mixer-$(SNDARCH).c file be written, implementing the hardware-independent
API defined in mixer.h.

--Daniel Richard G.
  <skunk@mit.edu>