wmmixer/README

   1 wmmixer - A mixer designed for WindowMaker
   2
   3 Copyright (C) 1998  Sam Hawker <shawkie@geocities.com>
   4 Copyright (C) 2002  Gordon Fraser <gordon@debian.org>
   5
   6 Now maintained by the Window Maker Team <wmaker-dev@googlegroups.com>
   7
   8 This software comes with ABSOLUTELY NO WARRANTY
   9 This software is free software, and you are welcome to redistribute it
  10 under certain conditions
  11 See the COPYING file for details.
  12
  13   This program is free software; you can redistribute it and/or modify
  14   it under the terms of the GNU General Public License as published by
  15   the Free Software Foundation; either version 2 of the License, or
  16   (at your option) any later version.
  17
  18   This program is distributed in the hope that it will be useful,
  19   but WITHOUT ANY WARRANTY; without even the implied warranty of
  20   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  21   GNU General Public License for more details.
  22
  23   You should have received a copy of the GNU General Public License
  24   along with this program; if not, write to the Free Software
  25   Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  26
  27
  28 AUTHORS:
  29 ========
  30
  31 Original Author: Sam Hawker <shawkie@geocities.com>
  32 Current Author: Gordon Fraser <gordon@debian.org>
  33
  34
  35 CONFIGURATION:
  36 ==============
  37
  38 Users can configure wmmixer to suit their requirements by means of a ~/.wmmixer
  39 file. A commented example is supplied, and would be a good starting point.
  40
  41 cp home.wmmixer ~/.wmmixer
  42
  43
  44 USAGE:
  45 ======
  46
  47 You can access all the channels on your soundcard's mixer with wmmixer. Most
  48 common channels are identified with an appropriate icon.
  49 Controls include a stereo (mono where appropriate) volume control and a recording
  50 source toggle button.
  51
  52 Press the "<" and ">" arrow buttons to select a channel.
  53 The icon identifies the current channel (a volume symbol with a question mark
  54 represents an unrecognised channel).
  55 Click and/or drag the volume display to set channel volume.
  56 There is a also a button to set recording sources.
  57
  58 See the program's manpage ('man wmmixer') for detailed listings of the
  59 available options.
  60
  61 SHADED VOLUME BARS:
  62 ===================
  63 As of version 1.5 wmmixer allows shading the volume bar in two colours.
  64 If you do not want this and prefer the traditional single-coloured
  65 look, you'll have to tell wmmixer to use the same colour for high and
  66 low colours:
  67
  68 $ wmmixer -l green -L green
  69 ...this will give you the traditional look.
  70
  71 $ wmmixer -l lightgreen -L blue
  72 ...this is an example for the new look. By default, green is used for low volume
  73 settings and fade to red for high volumes.
  74
  75
  76 AFTERSTEP USERS:
  77 ================
  78 (thanks to tygris@erols.com)
  79
  80 This release includes in a new command line option.
  81 The effect this has is to enable shape support (it implies "-s"), and
  82 to reduce the size of the window to 56x56 pixels.
  83 The "-position position" option has also been added, so you can push
  84 wmcdplay off the edge of the screen while it gets swallowed.
  85 To put wmmixer in your Wharf, add the following line in the appropriate
  86 part of your .steprc
  87
  88 *Wharf wmmixer nil MaxSwallow "wmmixer" wmmixer -a -g -0-0 &
  89
  90 It is also possible (by editing and recompiling the afterstep sources),
  91 to make Wharf handle the new 56x56 pixel window properly - yes, I add
  92 an option to use a 56x56 pixel window, even though the AfterStep Wharf
  93 really wants 55x57 pixel ones.
  94
  95 I am told (by tygris@erols.com):
  96
  97 "Locate Wharf.c (or is it Wharf.cc?)  Should be in
  98 AfterStep-1.0/modules/Wharf.  Locate this:
  99
 100             if (Buttons[button].maxsize) {
 101               Buttons[button].icons[0].w = 55;
 102               Buttons[button].icons[0].h = 57;
 103             }
 104
 105 and change the 55 and 57 to 56's.  Save and compile."