_ _____ ___ __ ___ __ ___ (_)_ __ |___ / / _ \ timecop@japan.co.jp \ \ /\ / / '_ ` _ \| \ \/ / |_ \| | | | skunk@mit.edu \ V V /| | | | | | |> < ___) | |_| | \_/\_/ |_| |_| |_|_/_/\_\ |____(_)___/ ______________________________________________________________________________ * This is a complete dockapp mixer utilizing the OSS mixer API * Has a nice On-Screen-Display to visualize current volume levels * Can adjust main volume, balance, recording status, and mute/unmute channels * Supports mousewheel to adjust the volume settings * Supports user specified signals to adjust the volume remotely * User configuration file can be used to set options How to use it: .---------------------------. | Message Area Message Area | <- (1) | [ Rec ] [ ST ] [ Mute ] | <- (2) (3) (4) | <- -> xxx | <- (5) (6) (7) | L R ___ | | | ||| | /the\ | | |--|||---| |K NOB| | <- (8) (9) | ||| <- slider \___/ | `---------------------------' 1) Current channel name is displayed in this area. If scrolling messages are enabled in config, the text will scroll every 30 seconds or so, using long sound channel names. If scrolling is disabled, short 5-character channel names are used instead, and the message constantly stays on the screen. In scroll mode, clicking in this area will re-scroll current message. 2) Clicking REC will toggle record status for current channel, if the channel is capable of recording. Some sound cards will allow you to set multiple record sources. Some don't, so you can only have one selected at any time. If you click here and nothing happens, the channel is not record-capable. 3) ST indicator is lit if the current channel is stereo. 4) Clicking MUTE will mute the current channel. Old volume settings are remembered, so clicking it again will un-mute. Also see the knob section because there is more than one way to do it :) 5) Clicking <- will switch to previous channel 6) Clicking -> will switch to next channel 7) Numeric indicator of current volume from 0 to 100 percent. Doesn't change when the channel is muted, so you can still adjust the volume and then unmute. 8) If ST light is on (Stereo channel), you can move this slider left and right to set balance. Click on the slider, and drag the mouse left or right to adjust. Double-clicking on the slider will center the balance. If you are on a mono channel, the slider doesn't move or do anything. 9) Ah, yes, the knob. One of the biggest visual differences since version 2.x of WMix is that the knob now rendered in real-time opposed to switching pixmaps with various knob angles. Bow down to Daniel Richard G. for coming up with this awesome routine. Also utilizes new "cursor-hiding-and-moving" code which first appeared in volume.app by the same guy. Now you don't have to scroll the mouse off your desk to adjust the volume. Anyway, simply click on the knob and drag the mouse up or down to adjust the volume. After you release the button, your mouse cursor is right back where you started. Very Nifty! You can also double-click on the knob to mute the current channel. Red LED will turn off... Channel is muted! Most people have mice with wheels these days, to this support is enabled by default. Scrolling the mouse wheel up or down will adjust the volume by 3% up or down. Buttons and step size are configurable from the config file - see below. You can also check out ~/.wmix.pid, and use SIGUSR1/2 to adjust the volume up or down by the configured step size. The config file: 1 = yes, 0 = no mousewheel=1 # use mousewheel? scrolltext=1 # scroll the system messages? osd=1 # display OSD? osdcolor=green # color of the OSD (from rgb.txt) wheelbtn1=4 # which mousewheel button is "up" wheelbtn2=5 # which mousewheel button is "down" wheelstep=3 # the step for mousewheel adjustment Most defaults are good for normal use, and if there is no config file, the settings you see above are used. If you want to hack on a config file, copy sample.wmixrc to ~/.wmixrc and change it around. Comments are ignored, but don't put comments at the end of line like I did here. timecop [timecop@japan.co.jp]