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
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
- Se parsea el MIDI con
midi-file.
- Se construye una pista de conductor con los eventos globales
(
setTempo, timeSignature, keySignature, ...) de todas las pistas.
- 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
