{"id":77,"date":"2021-04-16T11:39:25","date_gmt":"2021-04-16T09:39:25","guid":{"rendered":"https:\/\/radix-studio.fr\/blog\/?p=77"},"modified":"2023-04-05T13:10:44","modified_gmt":"2023-04-05T11:10:44","slug":"midirouter-by-example","status":"publish","type":"post","link":"https:\/\/radix-studio.fr\/blog\/2021\/04\/16\/midirouter-by-example\/","title":{"rendered":"MIDIRouter by example"},"content":{"rendered":"\n

This article provides some detailed example and associated configuration file for MIDIRouter (https:\/\/github.com\/NothNoth\/MIDIRouter<\/a>).<\/p>\n\n\n\n

<\/p>\n\n\n\n

Simple forward<\/h2>\n\n\n\n

Let’s start with a very simple use case: \u00ab\u00a0I want to forward all messages received on my input MIDI interface to my output MIDI interface\u00a0\u00bb.<\/p>\n\n\n\n

This may typically happen when you have a MIDI Usb keyboard connected to your audio interface and you want to send everything to you freshly acquired analog synthesizer connected to your MIDI output.<\/p>\n\n\n\n

Our configuration file will first specify your MIDI input and output devices.<\/p>\n\n\n\n

Simply run MIDIRouter with no arguments to list available devices:<\/p>\n\n\n\n

Usage: .\/midirouter <config file>\nMIDI inputs:\n   P\u00e9riph\u00e9rique MIDI USB\n   Korg\n   MOOG\n   Faderfox EC4\n   Port 1\n   Port 2\n   Port 3\n   Port 4\n   Port 5\n   Port 6\n   Port 7\n   Port 8\nMIDI outputs:\n   P\u00e9riph\u00e9rique MIDI USB\n   Korg\n   MOOG\n   Faderfox EC4\n   Port 1\n   Port 2\n   Port 3\n   Port 4\n   Port 5\n   Port 6\n   Port 7\n   Port 8\n<\/code><\/pre>\n\n\n\n
Let’s say I want to route everything from \u00ab\u00a0Korg\u00a0\u00bb to \u00ab\u00a0MOOG\u00a0\u00bb.<\/p>\n\n\n\n
{\n    \"SourceDevice\": \"Korg\",\n    \"DestinationDevice\": \"MOOG\",\n    \"DefaultPassthrough\": true,\n    \"Verbose\": true\n}<\/code><\/pre>\n\n\n\n
The \u00ab\u00a0DefaultPassthrough\u00a0\u00bb simply tells the MIDIRouter to forward all messages not matching any other rule. Since we don’t have any other rule set, this default behaviour will match all captured messages on the input interface.<\/p>\n\n\n\n
The \u00ab\u00a0Verbose\u00a0\u00bb option is useful when setting everything up: it will show a message everytime a MIDI event is received (you can switch it to ‘false’ once everything works fine).<\/p>\n\n\n\n
Note On\/off forward only<\/h2>\n\n\n\n
On our previous example we’ve used the DefaultPassthrough feature to allow a complete forward of all messages from the input MIDI device to the output MIDI device.<\/p>\n\n\n\n
Now we may not want to send everything to our vintage Analog Synth since it only supports NoteOn and NoteOff MIDI mesages. In order to do that, we will use what is the main feature of MIDIRouter: \u00ab\u00a0rules\u00a0\u00bb.<\/p>\n\n\n\n
A \u00ab\u00a0Rule\u00a0\u00bb is built using three main sections:<\/p>\n\n\n\n