midi-track-split

App sencilla para separar un archivo MIDI en sus pistas individuales. Incluye una CLI y una interfaz web (arrastrar/soltar, reproducción y descarga).

Cada pista de salida es un .mid independiente que conserva el mapa global de la canción (tempo, compás, tonalidad) para que suene igual que el original.

Demo en vivo: https://miditracksplit.martinezsebastian.com

Requisitos

• Node.js 18 o superior

npm install

CLI

node bin/cli.js <entrada.mid> [opciones]

Opción	Descripción
-o, --out <carpeta>	Carpeta de salida (por defecto <nombre>-tracks)
-z, --zip [archivo]	Genera además un .zip con todas las pistas
--only-zip [archivo]	Genera sólo el .zip
--include-empty	Incluye también las pistas sin notas
-h, --help	Ayuda

Ejemplos:

node bin/cli.js sample/demo.mid
node bin/cli.js sample/demo.mid -o pistas --zip
node bin/cli.js sample/demo.mid --only-zip cancion-pistas.zip

También se puede enlazar como comando global:

npm link
midi-track-split cancion.mid --zip

Interfaz web

npm run web          # http://localhost:4173
npm run web:https    # https://<tu-ip>:4173  (necesario para Web MIDI desde otro equipo)

npm run web:https genera un certificado autofirmado (cacheado en .cert/, con tu IP local en el certificado); el navegador avisará una vez (Avanzado → Continuar). Web MIDI no funciona por http:// + IP porque no es contexto seguro.

Abre la URL, arrastra un .mid, y podrás:

• escucharlo con el instrumento General MIDI de cada pista (muestras reales; la percusión del canal 10 se aproxima con una caja de ritmos TR-808);

• S (solo, como en una mesa de mezclas): escuchar solo esa pista en el PC; se pueden poner varias a la vez; no afecta a la exportación ni a la salida MIDI;

• silenciar / activar pistas con el botón MUTE de cada fila;

• EXT: enviar solo esa pista al teclado MIDI externo (deja de sonar en el PC); el resto de pistas sigue reproduciéndose en el PC y puedes encenderlas / apagarlas / ponerlas en solo con normalidad. Útil para dejar una pista en el teclado hardware y seguir mezclando el resto;

• localizar una pista: el botón ▶ de cada fila salta la reproducción al instante en que esa pista entra por primera vez (y la desilencia si hacía falta); la fila muestra "empieza m:ss" cuando no arranca desde el principio;

• renombrar cada pista (clic en su nombre): ese nombre se usa como nombre de archivo al descargar el .mid y dentro del .zip, y también se escribe como nombre de pista dentro del propio .mid;

• desplazar el punto de reproducción arrastrando la barra o haciendo clic (también con ←/→, +Shift = 5 s);

• ver iluminadas en la lista las pistas que están sonando;

• descargar cada pista por separado;

• MIDI combinado: descargar un único .mid reconstruido a partir del original, sin las pistas silenciadas y con los nombres nuevos aplicados;

• Pistas (.zip): descargar todas las pistas separadas en un .zip;

• Enviar a un teclado MIDI externo (Web MIDI): elegir dispositivo de salida y canal (1-16); luego pulsa EXT en las pistas que quieras mandar al teclado. Al parar / pausar / saltar se manda all-notes-off. Requiere Chrome, Edge u Opera (Safari no lo soporta) y conceder el permiso del navegador.

  Si no pide permiso / no aparece el dispositivo:

  • Estás por http:// + IP → no es contexto seguro y la API ni existe. Usa npm run web:https y entra por https://…, o abre http://localhost:4173 en el mismo equipo, o añade el origen en chrome://flags/#unsafely-treat-insecure-origin-as-secure.
  • Solo se listan MIDI. Un controlador que solo notas (muchos teclados master, pads, etc.) no aparece: para oírlo hace falta un aparato con generador de sonido o un puerto virtual (loopMIDI) hacia un DAW.

La interfaz está hecha con React y Trama (trama-ui), con un estilo minimalista oscuro: negro, blanco y un solo gris, tipografía enorme (Inter) y etiquetas diminutas en JetBrains Mono. Está pensada para usarse desde el móvil o la tablet: controles grandes, sin ayudas flotantes en pantallas táctiles.

El fondo es una escena 3D (RetroCanvas de Trama) ligada a la música: la batería es el núcleo y cada una de las demás pistas un anillo que dibuja su forma de onda real y se ilumina con sus notas. Solo se ven las pistas activas, así que silenciar una o dejarla fuera de un solo retira su pieza. El botón de pantalla completa de la cabecera esconde la interfaz y deja solo las visuales; ahí, un toque en el lienzo cambia el estilo de render (con un archivo cargado también vale tocar su nombre).

Hay cuatro escenas para el fondo, que se cambian con el botón «Visual» de la portada (o el icono de capas a pantalla completa) y se recuerdan entre visitas: Anillos (la descrita), Espectro (un aro de barras por pista), Terreno (el espectro de la mezcla convertido en relieve) y Notas (las notas del MIDI viniendo de frente, una fila por pista). A pantalla completa, arrastrar con el dedo o el ratón gira la escena. También hay tema claro y oscuro.

Recursos locales (sin CDN)

Todo vive en el proyecto para no depender de internet:

Recurso	Dónde	Se regenera con
Librerías JS (tone, smplr, jszip, @tonejs/midi, midi-file)	web/vendor/*.js (versionado, ~560 KB)	npm run build:vendor
Interfaz empaquetada (React + trama-ui + three.js)	web/app.js, web/app.css y web/chunks/ (versionado, ~1,5 MB)	npm run build:ui
Fuentes (woff2 + fonts.css)	web/fonts/ (versionado, ~80 KB)	npm run fetch-fonts
Muestras de instrumentos + batería	web/soundfonts/ (no versionado)	npm run fetch-sounds

web/vendor/, web/fonts/ y la interfaz empaquetada ya vienen en el repo, así que npm run web funciona sin internet nada más clonar, sin instalar dependencias de desarrollo.

La web está en español (/), inglés (/en/) y alemán (/de/). Los textos de la interfaz están en ui/i18n.js y el contenido de cada página (título, texto, preguntas frecuentes) en scripts/pages/content.mjs; npm run build:pages regenera los tres index.html y el sitemap.

Para tocar la interfaz, edita ui/ y recompila con npm run build:ui (o deja npm run dev:ui vigilando los cambios). trama-ui se instala desde scripts/vendor-pkg/ porque la versión que usa el proyecto aún no está en npm.

Las muestras de sonido son pesadas (~2-3 MB por instrumento), así que se descargan aparte:

npm run fetch-sounds                 # ~70 instrumentos habituales + batería (~180 MB)
npm run fetch-sounds -- --all        # los 128 instrumentos GM (~300 MB)
npm run fetch-sounds -- flute cello  # solo esos

Lo que no esté descargado se coge de un CDN (gleitz.github.io) la primera vez que se usa y el navegador lo cachea. Con --all la reproducción es 100% offline.

Estructura

bin/cli.js          Entrada de la CLI
server.js           Servidor estático (HTTP, o HTTPS autofirmado con --https)
ui/                 Código de la interfaz (React + trama-ui); se empaqueta en web/
ui/App.jsx          Pantalla: portada, pistas, teclado MIDI, bancos de sonido y transporte
ui/Stage.jsx        Fondo 3D reactivo (una pieza por pista)
ui/engine.js        Motor sin DOM: carga, reproducción, enrutado MIDI y exportación
ui/gm.js            Tablas General MIDI (instrumentos y mapa de percusión)
ui/midiout.js       Envío a dispositivo MIDI externo (Web MIDI API)
ui/sounds.js        Resuelve muestras locales (web/soundfonts/) o CDN
web/                Lo que sirve server.js: index.html + app.js/app.css empaquetados
web/split-core.js   Lógica de separación (compartida por CLI y web)
web/vendor/         Librerías JS empaquetadas (sin CDN)
web/fonts/          Fuentes locales
web/soundfonts/     Muestras descargadas con `npm run fetch-sounds` (no versionado)
scripts/            Build de vendor, descarga de fuentes/sonidos, ejemplo
sample/demo.mid     MIDI de ejemplo (4 pistas con entradas escalonadas)

Cómo funciona la separación

1. Se parsea el MIDI con midi-file.
2. Se construye una pista de conductor con los eventos globales (setTempo, timeSignature, keySignature, ...) de todas las pistas.
3. Por cada pista con notas se escribe un MIDI formato 1 con dos pistas: la de conductor y la pista original.

split-core.js también expone:

• sanitizeName(nombre) — limpia un nombre para usarlo como archivo;
• renameTrack(bytes, nombre) — copia del .mid con el trackName cambiado;
• mergeMidi(bytes, [{ index, name, muted }]) — reconstruye un único .mid quitando las pistas silenciadas y renombrando el resto (lo usa "MIDI combinado").

Créditos

Las muestras de instrumentos vienen de los soundfonts de MIDI.js / MusyngKite y la caja de ritmos TR-808 de smpldsnds, reproducidas con smplr sobre Tone.js. Interfaz con Trama. Tipografías: Inter y JetBrains Mono (Google Fonts, SIL Open Font License).

Licencia

MIT © Daniel Martínez Sebastián