> For the complete documentation index, see [llms.txt](https://docs.songbookplus.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.songbookplus.com/portugues/readme/midi-features-verwenden/midi-makros.md).
# 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.
{% 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 na inicialização" 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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, and the optional `goal` query parameter:
```
GET https://docs.songbookplus.com/portugues/readme/midi-features-verwenden/midi-makros.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.