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                                      QMIDIROUTE(1)