Online Guzheng21 cordas · Prática de jianpu

Referência do formato · Jianpu 简谱 → JSON

O formato JSON da partitura de guzheng

Online Guzheng toca notação numérica guardada em um pequeno arquivo JSON. O formato inteiro é um object com um array measures — aqui estão todos os campos, um exemplo completo e um prompt que você pode entregar a uma IA junto com uma foto da sua partitura.

Três passos para uma partitura tocável

  1. Entregue a qualquer assistente de IA o [prompt abaixo](#ai-prompt) junto com uma foto ou PDF da sua partitura jianpu.
  2. Salve o JSON retornado como um arquivo .json.
  3. Abra o guzheng, mude para 🎼 Tocar Partitura e clique em 📂 Enviar partitura JSON.

Nada é enviado para um servidor. O arquivo é processado no navegador e guardado no armazenamento local para continuar lá na próxima vez. Você também pode montar uma partitura à mão no ✏️ Editor de Partitura e exportá-la como JSON.

Um exemplo completo

Dois compassos — um compasso pentatônico ascendente, depois tremolo, uma pausa e uma nota uma oitava acima.

example-sheet.json
{
  "version": 1,
  "title": "Pentatonic Warm-Up",
  "artist": "Your name (optional)",
  "key": "D",
  "tempo": 88,
  "timeSignature": "4/4",
  "measures": [
    { "notes": [
      { "degree": 1, "beats": 1 },
      { "degree": 2, "beats": 1 },
      { "degree": 3, "beats": 1 },
      { "degree": 5, "beats": 1 }
    ] },
    { "notes": [
      { "degree": 6, "beats": 2, "technique": "tremolo" },
      { "degree": 0, "beats": 1 },
      { "degree": 1, "octave": 1, "beats": 1 }
    ] }
  ]
}

Campos de nível superior

CampoTipoDescrição
versionnumberSempre 1. Reservado para futuras mudanças no formato.
titlestringMostrado acima da partitura. Se estiver ausente, usa “Partitura sem título”.
artiststring, optionalCompositor, arranjador ou fonte. Exibido ao lado do título.
keystring, optionalA letra da marcação 1=D — “D”, “G”, “Bb”, “F#”. O app transpõe o instrumento inteiro para combinar, em até 7 semitons para qualquer lado.
temponumberBatidas por minuto, 20–300. Valores ausentes ou inválidos viram 80 com um aviso.
timeSignaturestring, optionalComo aparece impresso, ex.: “4/4” ou “2/4”. Define a contagem do compasso; padrão 4/4.
youtubeobject, optionalUm id de 11 caracteres ou uma URL completa do YouTube. Carrega o painel da batida de karaokê.
measuresarray, requiredUma entrada para cada compasso impresso. Não pode ficar vazio.

Campos de nota

Cada entrada de measures[n].notes é uma nota ou pausa impressa, na ordem de leitura.

CampoTipoDescrição
degreeinteger 0–7O dígito jianpu impresso. 0 é uma pausa. 4 e 7 são tocados com bend por pressão nas cordas 3 e 6 — escreva exatamente como aparecem.
octaveinteger −2…2, optionalPontos acima do número → 1 (dois pontos → 2). Pontos abaixo → −1 (dois pontos → −2). Omita para a oitava central.
beatsnumber 0–16, optionalDuração em batidas de semínima. O padrão é 1. Valores ruins viram 1 com um aviso.
techniquestring, optionalAtualmente apenas tremolo (摇指). Qualquer outra coisa é ignorada.

Graus e cordas

O instrumento usa afinação pentatônica de D — D, E, F♯, A, B se repetem pelas 21 cordas. Jianpu 4 e 7 não têm corda própria; o app os toca fazendo bend por pressão nas cordas verdes 3 e 6, exatamente como um músico faria. Escreva 4 e 7 normalmente e o app cuida do resto.

GrauAltura (tom de D)Como é tocadoCor da corda
1Dcorda 1 de cada grupo
2Ecorda 2 de cada grupo
3F♯corda 3 de cada grupoverde
4Gbend por pressão a partir de 3 (+1 semitom)verde
5Acorda 4 de cada grupo
6Bcorda 5 de cada grupoverde
7C♯bend por pressão a partir de 6 (+2 semitons)verde

Um grau que cair fora da faixa de 21 cordas aparece em vermelho na partitura e é pulado durante a reprodução, com um aviso acima do painel. Diminua o valor de octave ou transponha com Afinação.

Lendo ritmo em batidas

beats conta batidas de semínima, então corresponde diretamente aos sublinhados, traços e pontos do jianpu impresso. Una notas ligadas em uma única nota com o valor somado.

ImpressoNomebeats
5número simples1
5 —um traço2
5 — —dois traços3
pontuado1.5
5 (um sublinhado)colcheia0.5
5 (um sublinhado, pontuado)colcheia pontuada0.75
5 (dois sublinhados)semicolcheia0.25

Prompt para converter uma partitura com IA

Copie isto, cole no ChatGPT, Claude, Gemini ou qualquer outro assistente e anexe uma foto ou PDF nítido da página de jianpu. É a mesma especificação acima, escrita para um modelo.

Prompt Jianpu → JSON
Convert the attached jianpu (简谱, numbered musical notation) sheet music for guzheng into JSON.

Output ONLY a single JSON object — no commentary, no markdown code fence — with exactly this shape:

{
  "version": 1,
  "title": "song title as printed",
  "artist": "composer / source (optional)",
  "key": "D",
  "tempo": 88,
  "timeSignature": "4/4",
  "measures": [
    { "notes": [
      { "degree": 3, "octave": 0, "beats": 1 },
      { "degree": 5, "beats": 0.5 },
      { "degree": 6, "beats": 0.5, "technique": "tremolo" },
      { "degree": 1, "octave": 1, "beats": 2 }
    ] },
    { "notes": [
      { "degree": 0, "beats": 1 },
      { "degree": 6, "octave": -1, "beats": 3 }
    ] }
  ]
}

Rules:
- One entry in "measures" per printed measure. Split at every barline, reading left to right, top row to bottom row.
- "degree": the printed digit 1–7. Use 0 for a rest.
- "octave": dots above the digit → 1 (two dots → 2). Dots below → -1 (two dots → -2). No dots → 0 (or omit).
- "beats": length in quarter-note beats. Bare digit = 1. One underline = 0.5, two underlines = 0.25. A small dot after the digit makes it 1.5× (dotted note, e.g. 1.5). Each dash "—" after a digit adds 1 beat (so "5 — —" = beats 3). Merge tied notes into one note with the summed beats.
- "key": from the "1=D" marking — the letter only, e.g. "D", "G", "Bb", "F#". The app auto-tunes to it.
- "tempo": the metronome marking (♩=88). If missing, estimate from the tempo word.
- "timeSignature": as printed, e.g. "4/4" or "2/4".
- "technique": optional. Use "tremolo" on notes marked 摇指 / tremolo. Omit otherwise.
- Optionally add "youtube": { "videoId": "11-char id" } if a backing/karaoke video is known.
- Grace notes and ornaments: skip them, keep only the main melody notes. For chords, keep the top (melody) note.
- Do not transpose anything — copy the digits exactly as printed. Degrees 4 and 7 are fine: the app plays them by press-bending strings 3 and 6.

Modelos costumam ler scans muito carregados errado. Carregue o resultado, ouça uma vez com 👂 Ouvir e corrija qualquer coisa errada no ✏️ Editor de Partitura antes de praticar.

Partituras têm direitos autorais como qualquer outra obra. Converta músicas que você escreveu, músicas para as quais tem licença ou peças tradicionais e em domínio público — e guarde o resultado para você, a menos que os direitos permitam outra coisa. Este site não hospeda partituras de terceiros e nunca envia as suas: o arquivo fica no seu próprio navegador.

A demo incluída e todos os exercícios em Aulas são material original escrito para este site e podem ser usados gratuitamente.