Online Guzheng21 cuerdas · Práctica de jianpu

Referencia del formato · Jianpu 简谱 → JSON

El formato JSON de la partitura de guzheng

Online Guzheng reproduce notación numérica guardada en un pequeño archivo JSON. Todo el formato es un objeto con un array measures: aquí tienes cada campo, un ejemplo completo y un prompt que puedes dar a una IA junto con una foto de tu partitura.

Tres pasos para tener una partitura reproducible

  1. Da a cualquier asistente de IA el [prompt de abajo](#ai-prompt) junto con una foto o PDF de tu partitura jianpu.
  2. Guarda el JSON que devuelve como archivo .json.
  3. Abre el guzheng, cambia a 🎼 Tocar partitura y haz clic en 📂 Subir partitura JSON.

No se sube nada a un servidor. El archivo se procesa en tu navegador y se guarda en el almacenamiento local para que siga ahí la próxima vez. También puedes crear una partitura a mano en ✏️ Editor de partituras y exportarla como JSON.

Un ejemplo completo

Dos compases: uno pentatónico ascendente y después un trémolo, un silencio y una nota una octava más alta.

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 nivel superior

CampoTipoDescripción
versionnumberSiempre 1. Reservado para futuros cambios del formato.
titlestringSe muestra encima de la partitura. Si falta, usa “Partitura sin título”.
artiststring, optionalCompositor, arreglista o fuente. Se muestra junto al título.
keystring, optionalLa letra de la marca 1=D: “D”, “G”, “Bb”, “F#”. La app transpone todo el instrumento para coincidir, hasta 7 semitonos en cualquier dirección.
temponumberPulsaciones por minuto, 20–300. Si falta o no es válido, pasa a 80 con una advertencia.
timeSignaturestring, optionalTal como aparece impreso, p. ej., “4/4” o “2/4”. Define el número de pulsos del compás; por defecto 4/4.
youtubeobject, optionalUn id de 11 caracteres o una URL completa de YouTube. Carga el panel de la pista de karaoke.
measuresarray, requiredUna entrada por cada compás impreso. No puede estar vacío.

Campos de nota

Cada entrada de measures[n].notes es una nota o silencio impreso, en orden de lectura.

CampoTipoDescripción
degreeinteger 0–7El dígito jianpu impreso. 0 es un silencio. 4 y 7 se tocan haciendo bend por presión en las cuerdas 3 y 6: escríbelos exactamente como aparecen.
octaveinteger −2…2, optionalPuntos sobre el número → 1 (dos puntos → 2). Puntos debajo → −1 (dos puntos → −2). Omite el campo para la octava central.
beatsnumber 0–16, optionalDuración en pulsos de negra. El valor predeterminado es 1. Los valores incorrectos pasan a 1 con una advertencia.
techniquestring, optionalActualmente solo tremolo (摇指). Cualquier otra cosa se ignora.

Grados y cuerdas

El instrumento está afinado en pentatónica de D: D, E, F♯, A, B se repiten por 21 cuerdas. Jianpu 4 y 7 no tienen cuerda propia; la app los toca haciendo bend por presión en las cuerdas verdes 3 y 6, igual que un intérprete. Escribe 4 y 7 con normalidad y la app se encarga.

GradoAltura (tonalidad de D)Cómo se tocaColor de la cuerda
1Dcuerda 1 de cada grupo
2Ecuerda 2 de cada grupo
3F♯cuerda 3 de cada grupoverde
4Gbend por presión desde 3 (+1 semitono)verde
5Acuerda 4 de cada grupo
6Bcuerda 5 de cada grupoverde
7C♯bend por presión desde 6 (+2 semitonos)verde

Un grado que quede fuera del intervalo de 21 cuerdas se muestra en rojo en la partitura y se omite durante la reproducción, con una advertencia sobre el panel. Baja el valor de octave o transpón con Afinación.

Pasar el ritmo a pulsos

beats cuenta pulsos de negra, así que corresponde directamente a los subrayados, guiones y puntos del jianpu impreso. Une las notas ligadas en una sola nota con el valor sumado.

ImpresoNombrebeats
5número simple1
5 —un guion2
5 — —dos guiones3
con puntillo1.5
5 (un subrayado)corchea0.5
5 (un subrayado, con puntillo)corchea con puntillo0.75
5 (dos subrayados)semicorchea0.25

Prompt para convertir una partitura con IA

Copia esto, pégalo en ChatGPT, Claude, Gemini o cualquier otro asistente y adjunta una foto o PDF claro de la página jianpu. Es la misma especificación de arriba, escrita para un 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.

Los modelos se equivocan con escaneos muy cargados. Carga el resultado, escúchalo una vez con 👂 Escuchar y corrige cualquier error en ✏️ Editor de partituras antes de practicar.

Las partituras tienen copyright como cualquier otra obra. Convierte música que hayas escrito, música para la que tengas licencia o piezas tradicionales y de dominio público, y guarda el resultado para ti salvo que los derechos permitan otra cosa. Este sitio no aloja partituras de terceros y nunca sube las tuyas: el archivo se queda en tu navegador.

La demo incluida y cada ejercicio de Lecciones son material original escrito para este sitio y puedes usarlos gratis.