." Text automatically generated by txt2man
.TH ossmix 1 "09 March 2015" "" "OSS User Commands"
.SH NAME
\fBossmix \fP- Open Sound System command-line mixer program.
\fB
.SH SYNOPSIS
.nf
.fam C
\fBossmix\fP [\fB-d\fP <dev#>] [\fB-achqD\fP] [\fIcontrol\fP \fIname\fP] [\fIvalue\fP]

.fam T
.fi
.fam T
.fi
.SH DESCRIPTION
\fBossmix\fP is a simple command-line mixer utility that is used to display the mixer
settings of physical and virtual audio devices. OSS version 4 has an extended
mixer API which supports some device specific features that may not available
using other mixer applications. 
.SH OPTIONS
.TP
.B
\fB-D\fP
Display device information.
.TP
.B
\fB-a\fP
Dump mixer settings for all mixers (normal format).
.TP
.B
\fB-c\fP
Dump mixer settings for all mixers (command format).
.TP
.B
\fB-h\fP
Display usage information.
.TP
.B
\fB-q\fP
Quiet mode.
.TP
.B
\fB-v\fP[1|2]
Verbose mode. \fB-v2\fP prints more detailed infoamation than \fB-v1\fP.
.TP
.B
ctrl# \fIvalue\fP
Change \fIvalue\fP of a mixer \fIcontrol\fP.
.TP
.B
<no arg>
Display current/possible settings.
.SH USAGE
\fBossmix\fP without any arguments displays the current settings of the
default mixer device (usually the motherboard sound chip). This
printout can also be used to find out the supported \fIcontrol\fP names and
their possible values. Currently all controls accept an ON/OFF \fIvalue\fP, a
mono \fIvalue\fP (0 to 100) or a stereo \fIvalue\fP (left:right where both channel
volumes can be between 0 and 100). The \fIvalue\fP can also be expressed in a
relative form (e.g. +1 to add 1 to the previous volume). An ON/OFF \fIcontrol\fP
can also receive a TOGGLE \fIvalue\fP. If a \fIcontrol\fP has a \fIname\fP in quotes following
the normal output, than the \fIname\fP can be used instead of the \fIcontrol\fP when
setting a \fIvalue\fP.
.PP
The following is a sample printout produced by \fBossmix\fP:
.PP
.nf
.fam C
        Selected mixer 0/Creative AudioPCI
        Known controls are:
        vol <both/leftvol>[:<rightvol>] (currently 50:50)
        pcm <both/leftvol>[:<rightvol>] (currently 50:50)
        speaker <monovol> (currently 21)
        line <both/leftvol>[:<rightvol>] (currently 32:32)
        line.rec ON|OFF (currently OFF)
        mic <monovol> (currently 16)
        mic.rec ON|OFF (currently ON)
        cd <both/leftvol>[:<rightvol>] (currently 100:100)
        cd.rec ON|OFF (currently OFF)
        pcm2 <both/leftvol>[:<rightvol>] (currently 75:75)
        line1 <both/leftvol>[:<rightvol>] (currently 32:32)
        line1.rec ON|OFF (currently OFF)
        line2 <monovol> (currently 32)
        line2.rec ON|OFF (currently OFF)
        line3 <monovol> (currently 0)
        line3.rec ON|OFF (currently OFF)
        mic.micboost ON|OFF (currently ON)
        mic.micbias ON|OFF (currently ON)
        mute.pcmmute ON|OFF (currently OFF)
        mute.pcm2mute ON|OFF (currently OFF)
        mute.micmute ON|OFF (currently OFF)
        mute.cdmute ON|OFF (currently OFF)
        mute.linemute ON|OFF (currently OFF)
        mute.line1mute ON|OFF (currently OFF)
        mute.line2mute ON|OFF (currently OFF)
        mute.line3mute ON|OFF (currently OFF)

.fam T
.fi
.SH SELECTING MIXER DEVICE
It's possible to select the mixer device by using the \fB-d\fP<mixernumber>
command line argument. This argument (when used) should be the first one
on the command line. By default the mixer number 0 will be accessed.
To find the available mixer devices, type ossinfo \fB-x\fP and look
under the Mixers heading for available mixer devices. 
.SH CHANGING MIXER SETTINGS
Changing the values is done just like with the original "mixer" applet.
For example:
.PP
.nf
.fam C
        ossmix pcm 50:60

.fam T
.fi
The above sets the pcm \fIcontrol\fP (audio playback volume) so that the left
channel volume is 50 and the right channel volume is 60. With just
"\fBossmix\fP pcm 50" the both channel volumes will be set to 50.
.PP
In addition to the old mixer there are now some (usually ON/OFF) settings.
These settings are device specific and don't work with all soundcards.
The easiest way to find them out is to start \fBossmix\fP without command line
arguments (other than \fB-d\fP#).
.PP
Some \fIcontrol\fP names contain a dot ("."). This dot is required when changing
the value. For example: "\fBossmix\fP \fB-d0\fP mic.micboost ON".
.PP
."USING OSSMIX WITH A MIDI CONTROLLED MIXER
."The \fBossmix\fP program has capability to listen MIDI main volume controller
."messages from a MIDI port. You can assign a \fBossmix\fP \fIcontrol\fP to each MIDI
."channel. After receiving a channel main volume change message \fBossmix\fP will then
."change the mixer level of the volume \fIcontrol\fP assigned to the channel. In this
."mode \fBossmix\fP will not exit (you need to kill it manually).
."
."This mode is very useful if you need to make several rapid mixer changes
."simultaneously.
."
."To use this mode you need to give the MIDI device file and a list of the
."volume sliders on command line. For example:
."
."\fBossmix\fP \fB-d1\fP \fB-m\fP/dev/midi00 vol mic pcm line gain.out1/2 gain.in3/4
."
."After that the MIDI channels will be assigned in the following way:
."
."Ch 0 = "vol"
."Ch 1 = "mic"
."Ch 2 = "pcm"
."Ch 3 = "line"
."Ch 4 = "gain.out1/2"
."Ch 5 = "gain.in3/4"
."
."Other MIDI channels (6 to 15) will be ignored.
."
."Only mono and stereo slider type controls can be assigned to MIDI channels.
."Both stereo channels will be set to the same volume (there is no balance 
."support).
."
."After starting \fBossmix\fP you should move the sliders on the external fader box
."so that \fBossmix\fP can figure out their current settings.
."
."At this moment only MIDI fader boxes that send only main volume change messages
."are supported (any other MIDI data will make \fBossmix\fP to behave incorrectly).
."For example the FM3 MIDI Mixer (AKA "FaderBaby") by JLCooper is compatible
."with \fBossmix\fP.
."
.SH EXAMPLES

.TP
.B
\fBossmix\fP vol 50
Set the vol \fIcontrol\fP volume to 50. If the pcm \fIcontrol\fP is a stereo \fIcontrol\fP,
than both channels will be set to 50.
.TP
.B
\fBossmix\fP vol 50:60
Set the vol \fIcontrol\fP so that the left channel volume is 50 and the right
channel volume is 60.
.TP
.B
\fBossmix\fP vol +2
Raise vol volume by 2.
.TP
.B
\fBossmix\fP -- vol +2:\fB-2\fP
Raise the left channel volume by 2, and lower right channel volume by 2.
The "--" is needed on some systems so that the "\fB-2\fP" won't be mistaken for
a parameter.
.TP
.B
\fBossmix\fP micboost ON
Set micboost to ON.
.TP
.B
\fBossmix\fP micboost TOGGLE
Toggle micboost.
.TP
.B
\fBossmix\fP mplayer +2
Raise mplayer volume by 2. This would only work if mplayer is using the
virtual mixer.
.SH FILES
/usr/bin/\fBossmix\fP
.SH SEE ALSO
\fBossdevlinks\fP(1), \fBossxmix\fP(1), \fBsavemixer\fP(1)
.SH AUTHOR
4Front Technologies