# MIDI

MIDI is an asynchronous serial data protocol that is commonly used in live events.

## Receiving MIDI

### Setup in the Devices window

<div align="left"><figure><img src="/files/GjBAgPAG1uxi7aAM1nHW" alt=""><figcaption></figcaption></figure></div>

Insert a **MIDI receirver** node and after you have selected a *Stream* income source, you can enable the **Receive** checkbox.​

### Timecode

If there is any MIDI Timecode coming in, it will be displayed at the bottom of the Data section.

{% hint style="info" %}
**Good to know**: Please note you need to use **MTC Short Message** format for LightAct to be able to parse MTC.
{% endhint %}

{% hint style="info" %}
**Good to know**: in the properties of MIDI Receiver node, you can also apply Timecode offset, which will affect all subsequent operations with this timecode.
{% endhint %}

### Setup in the Layouts window

Place a **Read MIDI** node and select the **MIDI** **receiver** device node whose data you would like to read.

<div align="left"><figure><img src="/files/Wiox4cHMccmU7HsqBBTA" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
**Good to know**: In order to watch the output values, you can right-click on the output pins and select **Watch**.
{% endhint %}

### Controlling Layers with MIDI

<figure><img src="/files/na562DmhvdnCXDkFzTZS" alt=""><figcaption></figcaption></figure>

Similarly to [OSC](/osc-and-midi/receiving-osc/oscin.md), it is possible to control layers with MIDI. You can do that through MIDI In window where if you click on **Regenerate** button, every layer variable that has MIDI flag enabled, will get a unique MIDI Control and Value combination. If the corresponding MIDI message comes in, this variable will be set.

## Sending MIDI

### Setup in the Devices window

Place a **MIDI Sender** node in the *Device* window. After choosing your *Stream* parameters, such as the *Timecode rate* and Stream output, you can enable the **Send** checkbox to activate the node.

<div align="left"><figure><img src="/files/SkWU4BC8Y8qtgI7zC2Qn" alt=""><figcaption></figcaption></figure></div>

### Setup in the Layouts window

Place a **Send Mtc** node and as an input, select the newly created **MIDI sender** device node.

<div align="left"><figure><img src="/files/ahERmIHfnc7i3mHfgsLT" alt=""><figcaption></figcaption></figure></div>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.lightact.com/osc-and-midi/midi.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.