546bc1e49b
The original parser would not say anything if the user had misspelled something in the file which can be annoying. Now the parser will report warnings for everything not understood with a message trying to be more helpful to debug and fix. Signed-off-by: Christophe CURIS <christophe.curis@free.fr>
147 lines
4.4 KiB
Plaintext
147 lines
4.4 KiB
Plaintext
.TH wmix 1x "2.2" "Fredrik Steen"
|
|
.SH NAME
|
|
wmix \- Dockapp mixer for OSS or ALSA
|
|
.
|
|
.SH SYNOPSIS
|
|
.B wmix
|
|
.RI [ options... ]
|
|
.br
|
|
.B wmix
|
|
.I \-h
|
|
.
|
|
.SH DESCRIPTION
|
|
Docked application to control audio mixer for OSS or ALSA.
|
|
Allows toggling record source,
|
|
muting individual channels, adjusting volume and balance, all in a
|
|
compact dockapp size, with TV\-like on\-screen\-display for volume levels.
|
|
.LP
|
|
Supports mouse wheel to adjust current channel's volume
|
|
and can be controlled remotely with unix signals
|
|
.IR SIGUSR1 / SIGUSR2
|
|
to raise/lower the volume.
|
|
Keeps a simple configuration file for user\-defined settings.
|
|
.
|
|
.SH OPTIONS
|
|
.TP
|
|
\fB\-d\fR <\fIdisplay\fP>
|
|
Connect to remote X display
|
|
.TP
|
|
\fB\-e\fR <\fIname\fP>
|
|
Exclude channel from control (see
|
|
.SM
|
|
.B "CHANNEL NAMES"
|
|
below)
|
|
.TP
|
|
\fB\-f\fR <\fIfile\fP>
|
|
Use config file instead of
|
|
.I ~/.wmixrc
|
|
.TP
|
|
\fB\-h\fR
|
|
Display list of command\-line options
|
|
.TP
|
|
\fB\-m\fR <\fIdevice\fP>
|
|
Use specified mixer device instead of
|
|
.I /dev/mixer
|
|
.TP
|
|
\fB\-v\fR
|
|
Verbose start, report detected channels
|
|
.
|
|
.SH CONFIGURATION FILE
|
|
If readable, the file \fI~/.wmixrc\fP (or the file specified through \fB\-f\fR option)
|
|
is read on startup.
|
|
It may contains one configuration command per line:
|
|
.TP
|
|
mousewheel=<\fI0\fP|\fI1\fP>
|
|
when set to \fI0\fP, disable the volume control through mouse wheel (default=\fI1\fP)
|
|
.TP
|
|
osd=<\fI0\fP|\fI1\fP>
|
|
when set to \fI0\fP, disable display of the volume in an OSD like fashion (default=\fI1\fP)
|
|
.TP
|
|
osdcolor=<\fIcolor\fP>
|
|
specify the color to use for OSD volume display.
|
|
It can be the name of a color (see \fI/usr/share/X11/rgb.txt\fP)
|
|
or an RGB specification (as \fBrgb:\fP<\fIred\fP>/<\fIgreen\fP>/<\fIblue\fP>
|
|
with hexadecimal numbers) as expected by X11 (default=\fIgreen\fP)
|
|
.TP
|
|
scrolltext=<\fI0\fP|\fI1\fP>
|
|
when set to \fI0\fP, disable text scrolling to display the name of current selected
|
|
channel, use static short name instead (default=\fI1\fP)
|
|
.TP
|
|
wheelbtn1=<\fIbutton\fP>
|
|
.TQ
|
|
wheelbtn2=<\fIbutton\fP>
|
|
defines the buttons events associated in X11 to the mouse wheel,
|
|
with \fIbtn1\fP for up and \fIbtn2\fP for down
|
|
(default: btn1=\fI4\fP and btn2=\fI5\fP)
|
|
.TP
|
|
wheelstep=<\fIpercentage\fP>
|
|
sets the volume change step when using the mouse wheel,
|
|
specified as a percentage of the total volume range (i.e.: 1\~<\~\fIvalue\fP\~<\~100,
|
|
default=\fI3\fP)
|
|
.br
|
|
For compatibility, values between 0.0 and 1.0 will be considered as a raw percentage
|
|
.LP
|
|
You may include comments in the file using the character # in which case
|
|
everything will be ignored from the character to the end of the line.
|
|
.
|
|
.SH CHANNEL NAMES
|
|
The names for the different channels are provided by ALSA/OSS as short names, for which
|
|
.B wmix
|
|
provides a long name match for readability.
|
|
The default behavior is to scroll the long name of the current channel
|
|
in the text line of the dockapp, but if you disable the scroll text
|
|
then the short name will be displayed instead.
|
|
.LP
|
|
If you want to exclude a channel from the list of channels controlled by
|
|
the dockapp you have to use the short name.
|
|
You can get the list of all the channels available in your sound card with
|
|
.B wmix -v
|
|
and the short name will be between parentheses, here is an example:
|
|
.LP
|
|
.EX
|
|
Supported channels:
|
|
1: Master volume (Vol )
|
|
2: PC Speaker (Spkr )
|
|
3: PCM Wave 2 volume (Pcm2 )
|
|
4: Input gain (IGain)
|
|
5: Phone output (PhoneOut)
|
|
.EE
|
|
.
|
|
.SH FILES
|
|
.TP
|
|
.I ~/.wmixrc
|
|
User configuration file (change with option
|
|
.BR \-f )
|
|
.TP
|
|
.I ~/.wmix.pid
|
|
Contains process id of wmix, in case you'd need it for
|
|
.IR SIGUSR1 / SIGUSR2
|
|
volume control
|
|
.TP
|
|
.I /dev/mixer
|
|
Device used for controlling volume (change with option
|
|
.BR \-m )
|
|
.TP
|
|
.I /usr/share/doc/wmix/README
|
|
More information on the user interface
|
|
.
|
|
.SH BUGS
|
|
The \fImute\fP functionality is implemented by setting the volume to 0
|
|
and remembering the previous volume to restore it when unmuting.
|
|
While this is perfectly ok, you may encounter strange looking behavior
|
|
if you have other application controlling the volume, and possibly
|
|
implementing mute in similar ways, because there is no way to know
|
|
that a channel has been muted.
|
|
.LP
|
|
If you modify the configuration file, do not expect \fBwmix\fP to reload
|
|
it automatically, this is considered a too costly feature for such a
|
|
small application.
|
|
.
|
|
.SH AUTHORS
|
|
This man page was written by Fredrik Steen <stone@debian.org> for the Debian
|
|
distribution.
|
|
It was expanded by Christophe CURIS for the Window Maker Dev Team.
|
|
.PP
|
|
wmix was written by Tim, timecop <timecop@japan.co.jp>,
|
|
with some code by Daniel Richard G. <skunk@mit.edu>
|