MIDI bagunçado no MuseScore: por que acontece e como corrigir

A resposta curta

Um arquivo MIDI registra uma execução: que tecla desceu, quando, com que força e por quanto tempo. As notas dele não têm sustenidos ou bemóis, vozes, pausas escritas nem barras, e o arquivo muitas vezes não tem armadura de clave, então o MuseScore precisa adivinhá-los, e os palpites são piores quando as notas estão fora da grade de tempos. Em 12 transcrições de violão, o nosso primeiro conversor não escreveu armadura de clave e escondeu todas as pausas; o importador do MuseScore Studio 4.7.5, com as mesmas notas numa grade de semicolcheias, em andamento constante e com a tonalidade escrita em todas as faixas, acertou a tonalidade em 10 de 12 e mostrou todas as pausas. O MuseScore Studio 4 não tem painel de importação de MIDI, então essas correções vão no arquivo MIDI ou num arquivo de opções na linha de comando.

O que um arquivo MIDI não guarda?

A maior parte do que um leitor precisa. Uma nota MIDI é um número de tecla de 0 a 127 mais uma velocity, enviada uma vez quando a nota começa e outra quando termina (MIDI Association). A nota 63 é Ré sustenido e Mi bemol ao mesmo tempo; qual escrever depende da tonalidade, e a nota não diz. Um Standard MIDI File pode acrescentar andamento, fórmula de compasso e armadura de clave como eventos meta, mas não tem lugar padrão para vozes, pausas, barras ou quiálteras. Uma pausa é só uma lacuna, e uma duração é uma contagem de ticks sem valor escrito associado.

Ferramentas de áudio para MIDI acrescentam um segundo problema: a temporização delas vem de uma gravação, então as notas raramente caem exatamente num tempo. O Basic Pitch, do Spotify, que o ScoreStarling usa, escreve todas as notas numa única parte Electric Piano 1 no andamento que você informa, sem armadura de clave (note_creation.py). Transformar isso em notação significa escolher, para cada nota, uma grafia, uma duração escrita, uma voz e uma pauta. Todo conversor faz essas escolhas, alguns melhor que outros.

O que um conversor simples fez com 12 transcrições de violão

Nosso primeiro passo de notação foi um conversor que escrevemos sobre a biblioteca music21. Alimentamos esse conversor com o MIDI do Basic Pitch de 12 gravações do conjunto de dados público GuitarSet, informando o andamento de cada gravação, e o Verovio editorou exatamente o que ele escreveu. Uma auditoria dessas 12 partituras encontrou:

• Nenhuma pausa visível em nenhuma partitura: por padrão, o exportador de MusicXML do music21 preenche as lacunas com pausas ocultas (m21ToXml.py).
• Nenhuma armadura de clave em nenhuma partitura. Peças em Mi maior não mostravam sustenidos, e um acompanhamento em Dó maior trazia bequadros redundantes em 153 das suas 431 notas escritas (421 notas MIDI, algumas divididas por ligaduras de prolongamento).
• Grafia só pelo número da nota. A nota MIDI 63 sempre saía como Mi bemol, mesmo onde Mi maior pede Ré sustenido; numa peça em Sol♭ maior, 30 das 49 notas que pertencem à tonalidade foram escritas com a grafia errada.
• Até cinco vozes em uma pauta. O início e o fim de cada nota foram alinhados à semicolcheia mais próxima, então uma corda ainda soando sob a nota seguinte forçava outra voz, com pontos e ligaduras de prolongamento correspondentes.
• Violão escrito como piano: 10 das 12 partituras em pauta dupla e as outras 2 em clave de fá, nenhuma em clave de sol com 8 embaixo (a do violão), porque o Basic Pitch rotula todas as notas como “Electric Piano”.

Rodamos esse conversor de novo sobre os mesmos arquivos MIDI salvos em 7 de outubro de 2026 e obtivemos as mesmas contagens.

A fonte musical não era a culpada. O Verovio e a fonte Leipzig dele desenharam exatamente o que o MusicXML dizia, e o MusicXML estava errado.

Antes e depois: o importador do MuseScore Studio

Olhamos primeiro as alternativas de código aberto. A biblioteca partitura cuida de tonalidade, grafia e vozes, mas não tem quantizador e não escreve pausas; as outras ferramentas de pesquisa que encontramos eram só para piano, sem licença, não comerciais ou ainda não lançadas. Então entregamos o trabalho ao importador de MIDI do MuseScore Studio 4.7.5, executado como um programa separado. As mesmas 12 gravações, as mesmas notas do Basic Pitch, o mesmo andamento informado, preparados como descrito abaixo, num Mac, em 2 de outubro de 2026:

As contagens de notas escritas diferem porque o MuseScore liga as notas através dos tempos e das barras de compasso de outro jeito. As duas tonalidades erradas ficaram ambas a uma quinta da anotação: Ré♭ maior para uma peça em Sol♭ maior, Si maior para uma em Mi maior. Sem a nossa estimativa no arquivo, o palpite do próprio MuseScore acertou só 5 das 12 (rodado de novo em 7 de outubro de 2026), então escrever a estimativa elevou isso para 10. O importador levou de 1,2 a 4,3 segundos por gravação, 2,3 segundos em média.

Antes: o nosso primeiro conversor

Depois: o importador do MuseScore Studio

Por que o MuseScore adivinha de novo o andamento, a fórmula de compasso e a tonalidade?

Para ele, um MIDI não quantizado parece uma execução ao vivo. O importador confere as notas que caem perto de um tempo e, se menos de 60% delas começam exatamente nele, trata o arquivo como uma execução humana (importmidi_quant.cpp). Aí ele roda o próprio rastreador de pulsação, escolhe uma fórmula de compasso e ajusta os instantes das notas para caberem nos tempos que achou. O manual mais antigo do MuseScore descreve esse modo como uma troca de precisão por legibilidade e diz que ele vem ativado por padrão em arquivos desalinhados.

A tonalidade tem uma regra própria. Se alguma faixa que não seja de bateria não tem armadura de clave, ou se o arquivo conta como uma execução, o importador estima a tonalidade a partir das notas (importmidi_key.cpp). Uma armadura de clave só na faixa de andamento não basta; toda faixa com notas precisa de uma. Com MIDI cru do Basic Pitch, vimos fórmula de compasso, andamento e tonalidade serem adivinhados de novo, mesmo com a opção de execução humana definida como false.

Como preparar o MIDI antes de importar?

Tome dentro do arquivo MIDI as decisões de notação que puder, antes que o MuseScore o veja. É o que fazemos com toda transcrição:

1. Use um andamento constante. O ScoreStarling usa o BPM que você definir, ou um detectado na gravação; numa DAW, grave com metrônomo ou ajuste o andamento do projeto ao da gravação.
2. Leve o início e o fim de cada nota para uma grade do menor valor que você quer ler. O teste de 2 de outubro aqui usou semicolcheias em 4/4. Com todas as notas na grade, o MuseScore lê o arquivo como música escrita.
3. Ponha o andamento e a fórmula de compasso na primeira faixa, e uma armadura de clave em toda faixa que tenha notas. Estimamos a tonalidade a partir das notas com o detector de tonalidade de Krumhansl–Schmuckler do music21; se você sabe a tonalidade real, use-a.
4. Dê a cada faixa o instrumento real. O MuseScore escolhe pautas e claves pelo programa General MIDI: um violão deixado como “Electric Piano” cai numa pauta dupla, enquanto um programa de violão de cordas de nylon recebe clave de sol com 8 embaixo.
5. Atenção às notas repetidas. Se uma altura é tocada duas vezes dentro de um único passo da grade, o alinhamento funde os dois ataques; nós colocamos o segundo uma fusa depois.

Quais configurações de importação do MuseScore usar?

O MuseScore Studio 4 não tem painel de importação para elas. O manual dele chama o painel de importação de MIDI de “not currently implemented” [ainda não implementado], e a issue do GitHub que pede a volta dele (#11918, aberta em junho de 2022) continuava aberta quando conferimos em 3 de outubro de 2026. Dentro do app, o único controle de quantização é o menor valor de nota para arquivos MIDI importados, em “Preferences → Import” [Preferências → Importar].

O importador ainda lê as principais opções de um arquivo passado na linha de comando com -M; a página de linha de comando do manual traz um exemplo. Este é o arquivo que o teste de 2 de outubro usou; o ScoreStarling agora escreve uma linha de melodia em uma voz (VoiceCount 0) e ativa RecognizePickupBar quando o primeiro compasso é uma anacruse:

<?xml version="1.0" encoding="UTF-8"?>
<MidiOptions>
  <QuantValue>2</QuantValue>
  <VoiceCount>1</VoiceCount>
  <Duplets>false</Duplets>
  <Triplets>false</Triplets>
  <Quadruplets>false</Quadruplets>
  <Quintuplets>false</Quintuplets>
  <Septuplets>false</Septuplets>
  <Nonuplets>false</Nonuplets>
  <HumanPerformance>false</HumanPerformance>
  <MeasureCount2xLess>false</MeasureCount2xLess>
  <SplitStaff>false</SplitStaff>
  <ClefChanges>false</ClefChanges>
  <SimplifyDurations>true</SimplifyDurations>
  <ShowStaccato>false</ShowStaccato>
  <DottedNotes>true</DottedNotes>
  <RecognizePickupBar>false</RecognizePickupBar>
  <Swing>0</Swing>
</MidiOptions>

Depois converta, nomeando a saída como MusicXML:

mscore -M midi-import.xml -o score.musicxml performance.mid

O nome e o local do programa dependem do seu sistema; no Windows, o manual usa MuseScore4.exe. O que as principais opções fazem:

Se a sua música tem tercinas, não a alinhe a uma grade reta e deixe a busca de tercinas ligada. Não medimos quão bem o MuseScore as encontra. No MuseScore 3, as mesmas escolhas ficavam num painel de importação, com colunas como “Max. voices” [Máx. de vozes], “Search tuplets” [Buscar quiálteras] e “Is human performance” [É execução humana].

O Starling Refine consegue arrumar uma transcrição depois?

Sim. O Starling Refine é uma revisão de uma transcrição de gravação, e cada mudança que ele faz é salva como uma versão que você pode desfazer. É grátis com o Plus, e sem o Plus você tem uma tentativa grátis por mês (preços, conferidos em 24 de outubro de 2026). Aqui está o início de uma transcrição de Für Elise antes e depois dele.

Antes: a transcrição

Depois do Starling Refine

O que a partitura mais arrumada custa?

Alguma precisão, principalmente nas durações das notas. Estas são as trocas que medimos ou conhecemos:

• O MuseScore escreveu 26% das notas mais longas do que na execução quantizada, em até três semicolcheias e nunca mais curtas, e notas que soam juntas com durações diferentes podem compartilhar um valor só. No ScoreStarling, a reprodução e as exportações em MIDI mantêm a temporização da execução, embora uma linha de melodia seja limpa antes: entre as notas tocadas juntas, a mais forte fica, os ecos fracos saem, e uma nota sustentada termina onde a seguinte começa.
• A tonalidade é estimada a partir das notas e estava errada em 2 de 12 casos, sempre a uma quinta de distância. Tonalidades com sete sustenidos ou bemóis são escritas como as equivalentes com cinco.
• A grade reta de semicolcheias deste teste de violão de 2 de outubro não conseguia mostrar tercinas nem swing. Isso continua valendo quando o ScoreStarling transcreve um instrumento ou uma voz, que começa em 4/4; para piano solo, ele segue os compassos da execução e pode escolher 4/4, 3/4, 6/8 ou 12/8. Se você mesmo prepara um arquivo, escreva nele a fórmula de compasso real.
• O MuseScore divide os acordes de piano entre as mãos por uma regra própria, e até acordes próximos de duas notas podem cair em pautas diferentes.

Parte disso dá para arrumar depois da importação. “Tools → Regroup rhythms” [Ferramentas → Reagrupar ritmos] reescreve uma passagem selecionada para que as notas se agrupem por tempo, sem mudar o ritmo em si. “Tools → Respell pitches with sharps or with flats” [Ferramentas → Reescrever a grafia das alturas com sustenidos ou com bemóis] muda a grafia, embora o manual diga que é para notas de uma única altura. Corrigir uma tonalidade errada é mais rápido no arquivo MIDI, antes da importação, do que nota por nota depois.

O MuseScore consegue transformar um MP3 em partitura?

O MuseScore Studio não consegue. Ele abre formatos de partitura, como MusicXML e MIDI, e nenhum arquivo de áudio. A Muse Group anunciou um beta de Audio-to-Score na plataforma web do MuseScore em 17 de agosto de 2026: piano solo e violão acústico, arquivos MP3 de até 30 MB (cerca de três minutos), grátis, com o resultado em um arquivo MSCZ para o MuseScore Studio. Não o testamos.

O outro caminho é o deste artigo: um modelo de áudio para MIDI, a preparação da temporização dele e depois o importador do MuseScore. O ScoreStarling funciona assim quando faz áudio para MIDI ou áudio para MusicXML: para um instrumento ou uma voz, com o Basic Pitch, e para piano solo, com um modelo de piano cujas notas também dão a pulsação e as barras de compasso; o Verovio desenha a página. Uma linha de notas únicas agora é escrita em uma só pauta, em uma só voz, e uma parte que toca acordes os mantém em uma pauta. Em Configurações da partitura, Reescrever a partir da gravação pode escrever de novo uma gravação de uma só parte como uma linha de melodia, em uma pauta ou em duas. As medições acima são de 2 de outubro. Uma nova rodada de 4 de outubro, depois que as melodias passaram a ser escritas uma nota de cada vez em uma pauta, de novo acertou a tonalidade em 10 de 12, escreveu 0 de 3.158 notas da tonalidade com grafia contrária a ela e mostrou todas as 357 pausas.

Você também pode escolher ou soltar um arquivo MIDI no ScoreStarling e receber uma partitura editável. As faixas de bateria vão para uma pauta de bateria, e a partitura inteira mantém uma só fórmula de compasso. Um instrumento ou uma voz e Piano solo cobrem 6 minutos (15 com Plus); Banda cobre até 30 minutos (6 sem Plus), a partir de um envio de até 95 MiB. O PDF vem com toda conta e o MusicXML com o Plus ativo; as especificações trazem o resto (conferido em 24 de outubro de 2026). O espaço de trabalho é grátis para começar, e o artigo sobre precisão guarda as medições datadas de violão e de banda.

Fontes

1. Summary of MIDI 1.0 Messages, MIDI Association
2. Meta Message Types, documentação do mido
3. basic_pitch/note_creation.py, Spotify Basic Pitch, GitHub
4. music21/musicxml/m21ToXml.py, music21, GitHub
5. GuitarSet 1.1.0, Xi et al., Zenodo (CC BY 4.0)
6. MIDI import, manual do MuseScore 4
7. Restore MIDI import panel, issue #11918, MuseScore, GitHub
8. importmidi_quant.cpp e importmidi_key.cpp, código-fonte do MuseScore, GitHub
9. MIDI import, manual anterior do MuseScore (painel de importação)
10. Command line usage e o sample MIDI import options file, MuseScore Studio Handbook
11. Preferences, File export, Regroup rhythms e Respell pitches, MuseScore Studio Handbook
12. Hear It, Play It: MuseScore Introduces New Smart Audio Recognition Features, Muse Group, 17 de agosto de 2026

Perguntas e respostas

Como converto MIDI em MusicXML?

Abra o arquivo MIDI no MuseScore Studio, escolha “File → Export” [Arquivo → Exportar] e selecione MusicXML; o formato .mxl compactado é o padrão. Em um terminal, mscore -o score.musicxml file.mid faz o mesmo, e -M acrescenta um arquivo de opções para quantização e vozes. Prepare o MIDI antes, ou o MusicXML vai carregar a mesma bagunça.

Por que há tantas ligaduras de prolongamento e notas pontuadas depois de importar MIDI?

Notas tocadas raramente terminam num tempo. Alinhadas a uma grade fina, elas atravessam tempos e barras de compasso e pedem ligaduras de prolongamento, e notas que se sobrepõem vazam para vozes extras. Quantize para o menor valor que você quer ler, limite o importador a duas vozes e deixe que ele simplifique as durações. O MuseScore então vai escrever algumas notas um pouco mais longas para arrumar a página.

Por que o MuseScore escreve Ré sustenido onde eu esperava Mi bemol?

O MIDI guarda a nota 63 sem grafia, então o MuseScore decide a grafia pela armadura de clave e, se uma faixa não tem nenhuma, estima a tonalidade sozinho. Escreva a armadura de clave certa em cada faixa antes de importar. Depois da importação, “Tools → Respell pitches with sharps or with flats” [Ferramentas → Reescrever a grafia das alturas com sustenidos ou com bemóis] altera as notas selecionadas que têm a mesma altura.

Dá para ter o painel de importação de MIDI do MuseScore 3 no MuseScore Studio 4?

Não quando conferimos, em 3 de outubro de 2026. O painel não foi trazido para a nova versão, e a issue #11918 do GitHub, que pede a volta dele, continua aberta. O MuseScore Studio 4 mantém uma preferência de menor valor de nota para MIDI importado, e a linha de comando dele aceita um arquivo de opções com -M que cobre as principais escolhas do painel.

Posso abrir uma transcrição do ScoreStarling no MuseScore?

Sim. Exporte MusicXML (.musicxml ou .mxl), que mantém a armadura de clave, a grafia, as pausas e as vozes, ou MIDI se você só precisa das notas. Os dois vêm com o Plus ativo. O ScoreStarling é grátis para começar, e toda transcrição é um primeiro rascunho para conferir de ouvido.