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)