🎼 piano-transcribe

Real-time pitch detection & sheet music engine for the browser: microphone or MIDI to notation, MIDI and MusicXML export, no server.

Motor open source de captura y escritura musical para la web: convierte lo que tocas en el piano (micrófono, MIDI o entrada de línea) en notas y partitura, en vivo y en el dispositivo.

▶ Probar la demo · la interfaz es una demo del motor

Usar el motor en tu proyecto

El motor es un módulo ES sin DOM publicado en engine/v1/, con interfaz estable (engine.INTERFACE = 1).

const root = 'https://juliangdeveloper.github.io/piano-transcribe/engine/v1/';
const version = (await (await fetch(root + 'version.txt', { cache: 'no-store' })).text()).trim();
const engine = await import(root + 'capture.js?v=' + version);

const session = engine.createCapture({ profile: 'score', score: { bpm: 80, timeSig: '4/4', clef: 'treble' } });
const out = session.hop(frame, sampleRate, performance.now());

• Llama a hop cada engine.HOP_MS (20 ms) con un Float32Array de un AnalyserNode (fftSize 2048). Devuelve out.events (notas que empiezan o terminan) y out.score (compases con notas y silencios).
• Con MIDI o teclado usa session.press('C4', 'midi', now) y session.release('C4', 'midi', now).
• profile: 'combat' limita el rango a C3–C6; maxVoices: 2 permite dos notas a la vez con el micrófono.
• engine.toMidi(session.score()) devuelve los bytes de un .mid y engine.toMusicXML(session.score()) el texto de un .musicxml, con el tempo y el compás de la sesión.
• examples/minimal.html escucha el micrófono y descarga el MIDI en unas 50 líneas.
• piano-magic lo usa así para su combate.

API (engine/v1, versión 1.13.0)

Función	Qué hace
createCapture(opts)	Crea una sesión: profile, maxVoices, a4 y score: { bpm, timeSig, clef }.
session.hop · press · release	Alimentan la sesión con audio o con notas MIDI/teclado.
session.score() · setScore({ bpm, timeSig })	Leen la partitura o cambian tempo y compás.
session.held() · advance · releaseSource · reset	Notas sonando, avanzar el tiempo, soltar una fuente y empezar de cero.
toMidi(score) · toMusicXML(score)	Exportan la partitura.
detectPitch(buffer, sampleRate)	Detecta la frecuencia de un bloque de audio.
noteFromFreq · noteFromMidi · hzForNote	Convierten entre Hz, número MIDI y nombre de nota.
TEMPO · TIME_SIGNATURES	Tempo de 40 a 208 y compases 2/4, 3/4, 4/4 y 6/8.

La demo

• Pulsa Escuchar y en ⚙ elige micrófono, MIDI o entrada de línea.
• En ⚙ eliges también el tempo (♩=60 a 144) y el compás (2/4, 3/4, 4/4 o 6/8).
• Arriba ves la nota, los cents y la claridad; abajo, la partitura en clave de sol, de fa o en pentagrama doble.
• MIDI y MusicXML descargan lo que tocaste.
• Si el micrófono falla o no tiene permiso, la demo dice por qué.
• Parar deja la partitura; al volver a escuchar empieza de cero.

Estado y límites

• En curso.
• Probado con micrófono. MIDI y entrada de línea pasan pruebas simuladas, pero no se han probado con hardware.
• La polifonía es limitada: en acordes puede aparecer una nota que no se tocó (por ejemplo, un G#3 en La menor).
• El tempo y el compás se eligen a mano; no se detectan.

Contribuir

Abre un issue o un PR. Áreas abiertas:

• Probar y corregir la entrada MIDI (USB y Bluetooth) y la entrada de línea.
• Polifonía y acordes más fiables.
• Detectar tempo y compás a partir de lo que se toca.
• Probar el MIDI y el MusicXML exportados en editores de partituras.

Stack

JavaScript vanilla, Web Audio y Web MIDI; la partitura se dibuja con VexFlow. Sin dependencias de npm.

python3 -m http.server 8000
npm test

Licencia: MIT. Incluye VexFlow (MIT) y la fuente Gonville (uso libre).

---

Más proyectos: https://juliangdeveloper.github.io/

Hecho con ❤️ y 🎼