Guide

MIDI

Configure MIDI I/O with Streamer.bot

Introduction

Streamer.bot ships with full MIDI input & output support, allowing you to execute your actions with the push of a button using your existing MIDI device, or even let your bot take control of your devices by using sub-actions to send outgoing MIDI commands.

Devices

In Streamer.bot, navigate to the MIDI tab
MIDI In and MIDI Out devices are stored separately, so be sure to navigate to the appropriate tab for the type of interactions you would like to make. You can also add the same device in both tabs.

To add a new device, Right-Click anywhere in the device pane and select Add

Add Device Context Menuf

This will open the add device dialog:

Add Device Dialog

Configuration

Namerequired
Text

Enter a descriptive name for this device connection

Devicerequired
Select

Select your device from a list of currently connected MIDI devices

Auto Open on Startup
Toggle

Automatically connect to this device when Streamer.bot starts up?

Reopen on Close
Toggle

Automatically reconnect to this device when the connection is closed?

Retry Interval
Number

When Reopen on Close is enabled, retry the connection at the entered interval, in seconds

Context Menu

Right-Click any existing device to reveal the context menu options:

Context Menu

Add

Add a new MIDI device, opening the configuration dialog outlined above

Edit

Edit the selected MIDI device, opening the configuration dialog outlined above

Delete

Delete the selected MIDI device connection

Auto Open
Toggle

Quickly toggle the Auto Open on Startup configuration option for this device

Reopen
Toggle

Quickly toggle the Reopen on Close configuration option for this device

Open

Manually open the connection to this device

MIDI In

Once you have created a MIDI In device, you can select it to register your incoming event listeners in the bottom pane.

Make sure the device is currently connected. You can manually Right-Click the device and select Open

With your device selected in the top pane, you can Right-Click on bottom pane and select Add to create a new event listener.

Add MIDI Event

You should now see the Add MIDI Event dialog:

MIDI Event Dialog

You can now automatically generate the event configuration by triggering an event from your MIDI device
  • Press a key
  • Press a pad
  • Turn a dial, knob, or wheel
  • Press any button which sends a MIDI message

Configuration

Enabled
Toggle

Enable or disable this event listener

Namerequired
Text

Enter a descriptive name for this event listener

  • Automatic detection is supported
Commandrequired
Text

Select the MIDI event type you would like to listen to

  • Automatic detection is supported
Channelrequired
Number

Enter the MIDI channel to listen on

  • Automatic detection is supported
Ignore Channel
Toggle

Listen on any channel

Datarequired
Number

Enter the MIDI data value to listen for

  • Automatic detection is supported
Ignore Data
Toggle

Listen on any data value

This can be useful if you would like to trigger an action on any key value
Raw Message
ReadOnly

Displays the raw MIDI message value

Ignore NoteOff
Toggle

Ignore NoteOff events

Some keyboards will send both NoteOn and NoteOff events. This option allows you to automatically generate event configuration for NoteOn without it being overridden by the following NoteOff event

Triggers

All configured incoming MIDI events can be used to trigger your actions via triggers

MIDI Out

All outgoing MIDI messages can be configured directly in sub-actions

Usage

3Sub Actions

MIDI Sub-Actions

Documentation needed
Explore
1Trigger

MIDI Triggers

Documentation needed
Explore