# MIDI-Macros

MIDI-Macros são um recurso MIDI muito poderoso do SongBook+.

Com isso, é possível definir uma sequência de comandos MIDI, que pode ser usada em vários locais diferentes no SongBook+:

* Como ação em configurações de pedal
* Como ação no controle com gestos
* Como ação em botões de função
* Como ação em um macro MIDI (aninhamento de macros)
* Como ação nas músicas ao abrir/iniciar/parar/fechar
* Como ação global ao abrir/iniciar/parar/fechar músicas
* Macros marcados como favoritos aparecem no botão MIDI na barra de ferramentas

Dessa forma, você pode definir uma vez sequências MIDI frequentemente usadas, por exemplo, para ligar ou desligar certos efeitos e então usá-las em muitas músicas, em vez de inserir a mesma sequência em todos os lugares. Isso também tem a vantagem de que você pode ajustar essa sequência posteriormente em um local central.

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

{% hint style="info" %}
**Dica:**

Com um macro MIDI como ação nas configurações do pedal de MIDI, é até possível que o SongBook+ responda a um comando MIDI configurável e envie outros comandos MIDI em resposta.

Por exemplo, ele poderia atuar como um tradutor respondendo a um comando MIDI do teclado e então desencadear algo em outro dispositivo compatível com MIDI.
{% endhint %}

{% hint style="info" %}
**Dica:**

Se você exportar uma música contendo macros MIDI (em ações ao abrir ou em botões de função) como um arquivo .sbk, os macros MIDI usados serão exportados para o mesmo arquivo .sbk, para que os macros também estejam presentes após a importação deste arquivo .sbk em outro dispositivo.

Dessa forma, você também pode transferir conscientemente macros MIDI de um dispositivo para outro criando uma música, inserindo os macros, por exemplo, em "Ações ao Iniciar" ou em um botão de função, e em seguida exportando essa música.

Caso no dispositivo para o qual o arquivo .sbk está sendo importado já existam macros com o mesmo nome mas conteúdo diferente, será perguntado se os macros existentes devem ser substituídos ou não.
{% endhint %}


---

# 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.songbookplus.com/portugues/readme/midi-features-verwenden/midi-makros.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.
