README
1 _ _____ ___
2__ ___ __ ___ (_)_ __ |___ / / _ \ timecop@japan.co.jp
3\ \ /\ / / '_ ` _ \| \ \/ / |_ \| | | | skunk@mit.edu
4 \ V V /| | | | | | |> < ___) | |_| |
5 \_/\_/ |_| |_| |_|_/_/\_\ |____(_)___/
6______________________________________________________________________________
7
8* This is a complete dockapp mixer utilizing the OSS mixer API
9* Has a nice On-Screen-Display to visualize current volume levels
10* Can adjust main volume, balance, recording status, and mute/unmute channels
11* Supports mousewheel to adjust the volume settings
12* Supports user specified signals to adjust the volume remotely
13* User configuration file can be used to set options
14
15How to use it:
16
17.---------------------------.
18| Message Area Message Area | <- (1)
19| [ Rec ] [ ST ] [ Mute ] | <- (2) (3) (4)
20| <- -> xxx | <- (5) (6) (7)
21| L R ___ |
22| | ||| | /the\ |
23| |--|||---| |K NOB| | <- (8) (9)
24| ||| <- slider \___/ |
25`---------------------------'
26
271) Current channel name is displayed in this area. If scrolling messages are
28 enabled in config, the text will scroll every 30 seconds or so, using long
29 sound channel names. If scrolling is disabled, short 5-character channel
30 names are used instead, and the message constantly stays on the screen. In
31 scroll mode, clicking in this area will re-scroll current message.
32
332) Clicking REC will toggle record status for current channel, if the channel
34 is capable of recording. Some sound cards will allow you to set multiple
35 record sources. Some don't, so you can only have one selected at any time.
36 If you click here and nothing happens, the channel is not record-capable.
37
383) ST indicator is lit if the current channel is stereo.
39
404) Clicking MUTE will mute the current channel. Old volume settings are
41 remembered, so clicking it again will un-mute. Also see the knob section
42 because there is more than one way to do it :)
43
445) Clicking <- will switch to previous channel
45
466) Clicking -> will switch to next channel
47
487) Numeric indicator of current volume from 0 to 100 percent. Doesn't change
49 when the channel is muted, so you can still adjust the volume and then
50 unmute.
51
528) If ST light is on (Stereo channel), you can move this slider left and
53 right to set balance. Click on the slider, and drag the mouse left or
54 right to adjust. Double-clicking on the slider will center the balance.
55 If you are on a mono channel, the slider doesn't move or do anything.
56
579) Ah, yes, the knob. One of the biggest visual differences since version
58 2.x of WMix is that the knob now rendered in real-time opposed to switching
59 pixmaps with various knob angles. Bow down to Daniel Richard G. for coming
60 up with this awesome routine. Also utilizes new "cursor-hiding-and-moving"
61 code which first appeared in volume.app by the same guy. Now you don't
62 have to scroll the mouse off your desk to adjust the volume. Anyway, simply
63 click on the knob and drag the mouse up or down to adjust the volume.
64 After you release the button, your mouse cursor is right back where you
65 started. Very Nifty! You can also double-click on the knob to mute the
66 current channel. Red LED will turn off... Channel is muted!
67
68Most people have mice with wheels these days, to this support is enabled by
69default. Scrolling the mouse wheel up or down will adjust the volume by 3%
70up or down. Buttons and step size are configurable from the config file -
71see below.
72
73You can also check out ~/.wmix.pid, and use SIGUSR1/2 to adjust the volume
74up or down by the configured step size.
75
76The config file:
77
781 = yes, 0 = no
79
80mousewheel=1 # use mousewheel?
81scrolltext=1 # scroll the system messages?
82osd=1 # display OSD?
83osdcolor=green # color of the OSD (from rgb.txt)
84wheelbtn1=4 # which mousewheel button is "up"
85wheelbtn2=5 # which mousewheel button is "down"
86wheelstep=3 # the step for mousewheel adjustment
87
88Most defaults are good for normal use, and if there is no config file,
89the settings you see above are used. If you want to hack on a config file,
90copy sample.wmixrc to ~/.wmixrc and change it around. Comments are ignored,
91but don't put comments at the end of line like I did here.
92
93timecop [timecop@japan.co.jp]
94