NAME
qmidiroute - MIDI event processor and router
SYNOPSIS
qmidiroute [OPTION] [file]
qmidiroute { --help | --version }
DESCRIPTION
qmidiroute is a versatile MIDI event processor and router for the ALSA
sequencer. The graphical interface is based on the Qt4 toolkit.
qmidiroute permits setting up an unlimited number of MIDI maps in which
incoming events are selected, modified or even changed in type before
being directed to a dedicated ALSA output port. The maps work in
parallel, and they are organized in tabs. With qmidiroute it is for
example possible to change or invert the scale of a keyboard, to
transform keyboard strokes into program changes or controller data into
notes.
Incoming MIDI events can be logged in a list and are displayed in
different colors according to their MIDI type. qmidiroute provides one
ALSA input port and as default two ALSA output ports. The numerical
ALSA client id is displayed as part of the window title.
General Usage
After starting the application, the Unmatched tab is presented (see
below). To start MIDI routing setup, the New map... button can be
clicked, which will create a new MIDI map appearing as a tab in the map
area. The entire setup can be saved to and loaded from a QMidiRoute
file (.qmr). Several maps can be created to work in parallel. The maps
can be organized using the Map Rename, Remove and Clone buttons. The
Event Log is displayed in the bottom area by default, but can be hidden
if not needed or floated as a top-level window on the desktop. Logging
can also be disabled generally or for MIDI Clock events only.
MIDI Input
The Input field represents the incoming event filter of each map.
Handled event types are Note, Controller, Pitchbend and Program Change.
The events can be filtered by their respective values or by MIDI
channel. Events matching the conditions specified in the Input field
are directed to the Output field.
MIDI Output
The Output field sets terms into which event type the matching events
are transformed, how their channel and values are transformed, and to
which ALSA port they are directed. Channels and Values can be set
Fixed, Offset or Reverse Offset with respect to the input event. As an
example, Reverse Offset will take the value specified and subtract the
incoming event value from it to produce the output event value. If the
output range for a value is different from its input counterpart, the
input range will be smoothly scaled to the output range. Events will be
sent to the ALSA port specified. The number of available ALSA ports can
be set using the corresponding command-line option.
Unmatched MIDI events
In the Unmatched tab, the handling of events not matching any input
filter of the defined maps is specified. These events can be discarded
or sent to a specified ALSA port.
OPTIONS
--portCount <num>
Set the number of available ALSA output ports to <num>. The
default is 2.
--help Print possible command-line options and exit.
--version
Print version information and exit.
file Name of a valid QMidiRoute (.qmr) file to be loaded on start.
FILES
*.qmr
QMidiRoute files containing MIDI routing data in plain text
format.
EXAMPLES
An example MIDI map file can be found in /usr/share/qmidiroute or in
/usr/local/share/qmidiroute
NOTES
Errors and warnings are written to stderr(3).
SUPPORT
alsamodular-devel@lists.sourceforge.net
AUTHORS
Matthias Nagorni, Frank Kober and Guido Scholz. This manual page was
written by Frank Kober <emuse@users.sourceforge.net>.
2009-09-13