INTRODUCTION:
~~~~~~~~~~~~~

I know what you're thinking: "Not *another* mixing utility!"

Well, this one is a little different - it's designed specifically to allow
volumes to be controlled with an infra-red remote control.  For this, it
requires LIRC (the lirc_client library).

Also required is a working OSS or ALSA mixer (autodetected at .configure time),
and an X server - preferably XFree86 with Xft extension (which is used for a
nice translucent On-Screen Display), but the translucency can be disabled for
other X servers.

Irmix is released under the GPL version 2; for details please see the file
"COPYING".

This is my first Linux project, so please feel free to provide me with
feedback and constructive criticism.


USAGE:
~~~~~~

irmix takes the following options:
         -h --help                      display a help message
         -v --version                   display version
         -d --daemon                    run in background
         -m --mixer=/dev/mixer<n>       select alternative mixer device
         -s --screen=0                  use a Xinerama screen other than screen 0

The following commands can be used in your .lircrc file:
(Please note - channel are specified by number.  Precisely which number will
map to which function depends on the precise implementation in your
soundcard's driver.)

set <level> [channel]
  Sets the current channel (or [channel] if supplied) to the specified volume.

inc <delta> [channel]
  Increases the current or specified channel's volume by <delta> steps.

dec <delta> [channel]
  As inc, but reduces the volume.

nextchannel
  Increases the current channel number by one.  The channel number will
  wrap around if it exceeds the number of available channels.

prevchannel
  Decreases the current channel number by one.  Again, the channel number
  will wrap around if it goes below zero.

select <channel>
  Selects specified channel and displays it.

mute [channel]
  Mutes the current or specified channel.

unmute [channel]
  Unmutes the current or specified channel.

togglemute [channel]
  Toggles the mute status of the specified channel.

record [channel]
  Sets the recording source to the current or specified channel.

CONTACT:
~~~~~~~~

I can be contacted at:
blackfive@fakenhamweb.co.uk

--

Alastair M. Robinson
