Caso de estudio

Cómo se hizo Libitum.

Un lector de partituras nativo para Android, para tablet y móvil. Lo he diseñado y programado yo, de la primera auditoría a la versión que hoy prueban músicos de verdad.

Qué hice
Producto, diseño e ingeniería
Plataforma
Android, tablet y móvil
Tecnología
Kotlin, Jetpack Compose, Room, WorkManager, Jetpack Ink
Estado
En prueba con músicos. Próximamente en Google Play
Libitum: el logotipo junto a una tablet con la biblioteca de partituras

El problema

Un músico que toca en grupo lleva una carpeta de papel por cada repertorio: hojas sueltas, fotocopias de fotocopias, anotaciones a lápiz que se borran. Pasar página con el instrumento en las manos es un riesgo en cada concierto.

En Android la referencia es MobileSheets. Es muy completa, pero abruma: solo sus ajustes generales suman unas 150 opciones. Y los músicos con los que toco leen en tablets baratas, no en una de gama alta.

El objetivo: una app completa que cualquiera entienda sin manual, fluida en una tablet de menos de 200 euros, y que en un concierto no dependa nunca de internet.

El método

Antes de escribir una línea de la app, cuatro fases que no se saltan:

  1. Auditoría. Recorrí MobileSheets módulo a módulo en un emulador de tablet, con capturas automáticas por adb: biblioteca, visor, paso de página, anotaciones, importación, listas, ajustes y sincronización. Cada módulo tiene su ficha.
  2. Requisitos. Un PRD destilado de la auditoría, con prioridades: lo de cada minuto (pasar página, anotar, leer) por delante de todo lo demás.
  3. Diseño. Un sistema de diseño con tokens como única fuente de verdad (los mismos valores en el diseño y en el código) y prototipos HTML del visor, la biblioteca y las listas, probados antes de programarlos.
  4. Pruebas técnicas. Siete prototipos desechables para medir lo arriesgado antes de comprometerse: motor PDF y caché, limpieza de escaneos, tinta, giro de página, audio, nube sin conexión y el móvil como pedal.

Después, la construcción: una especificación por función, con criterios de aceptación que se comprueban uno a uno. Van 20, del visor a la sincronización entre aparatos.

Trabajo con desarrollo asistido por IA (Claude Code). Yo decido el producto, el diseño y los criterios de aceptación; cada decisión queda escrita con su fecha y su porqué en un registro, para no reabrir lo ya decidido sin un motivo nuevo.

Decisiones de producto

Siempre una página

Nunca dos a la vez, ni en horizontal: con dos páginas las notas se ven diminutas en una tablet pequeña. Para quien ve peor de lejos, una opción ajusta la página al ancho y la recorre por tramos.

30 · 30 · 40

Las zonas de toque del visor: el 30 % izquierdo vuelve atrás, el centro saca los controles y el 40 % derecho pasa página. Elegidas probando el prototipo, porque pasar adelante es lo que más se hace.

650 ms, no 260

El giro de página va a 650 ms con una curva que imita al papel. A 260 ms resultaba brusco y artificial. La velocidad se puede cambiar.

Cada función, a su distancia

Sencilla no es recortada. Lo que se usa cada minuto está a cero o un toque; lo que se usa una vez al mes, escondido pero localizable.

Solo licencias permisivas

Fuera MuPDF (AGPL) y TarsosDSP (GPL), aunque habrían ahorrado trabajo. La app va a tener una versión de pago y su código no puede quedar obligado a abrirse.

Sin servidor propio

No hay cuentas de Libitum ni datos en servidores míos. La copia y la sincronización usan el Google Drive del propio músico, con el permiso más limitado que ofrece Google.

Un afinador que no se confunde en el ensayo

Un afinador de micrófono funciona bien con una nota limpia. En un ensayo no hay notas limpias: suenan compañeros, gente hablando, percusión, el zumbido de las luces. Los fallos típicos son leer la nota del de al lado o saltar de octava.

Lo resolví con unas reglas propias sobre la detección de tono: el afinador escucha la sala al abrirse y sigue aprendiendo su fondo, solo empieza a leer cuando un sonido destaca sobre él, resta lo que ya sonaba, decide por la serie de armónicos y, una vez enganchada una nota, solo acepta esa o una nueva que destaque. El principio: mejor callar que mentir.

Para medirlo construí un banco de pruebas con 756 audios generados: once notas de distintos instrumentos, varias escenas de sala y relaciones de 20, 12 y 6 dB entre el músico y el resto. Se pasa en cada compilación. Comparado con los motores de detección de referencia sobre los mismos audios:

Nota equivocadaSin lecturaError medianoError p95
Libitum0,25 %1,76 %0,8 ¢2,6 ¢
pYIN12,7 %0,2 %2,4 ¢10,1 ¢
CREPE5,9 %2,9 %6,9 ¢12,4 ¢
YIN con puerta13,6 %0,0 %0,8 ¢8,3 ¢

Cómo leerlo. Los audios los diseñé yo y el afinador se ajustó con ellos; los otros no, así que parte de la ventaja es jugar en casa. pYIN y CREPE son detectores de uso general, no afinadores. Y cuando toda la sala toca la misma nota igual de fuerte, ellos aciertan y Libitum se calla. Falta validarlo con grabaciones reales de instrumentos.

Dos aparatos al día, sin servidor

Muchos músicos ensayan con la tablet y repasan con el móvil. Sin un servidor propio, el único punto común es la carpeta de Libitum en su Google Drive. Una copia única que cada aparato sube entera tiene tres fallos: lo borrado vuelve, el último en subir pisa al otro y nadie baja los cambios.

La solución: antes de subir, la app baja la copia y la fusiona con lo local, cosa por cosa. Obras, listas, anotaciones de cada página e instrumentos llevan su fecha de último cambio y gana la más reciente. Borrar deja una marca que viaja en la copia, para que el otro aparato borre lo mismo; las marcas se limpian a los 90 días. Las subidas van en segundo plano con WorkManager, esperan a tener red y nunca bloquean la app.

Y una regla que manda sobre todo lo demás: una lista de concierto se descarga entera en el aparato. En el escenario, la app no necesita internet.

Escaneos viejos que se leen de noche

Muchas partituras reales son fotocopias o fotos de fotocopias: papel gris, sombras, bordes negros. Teñidas tal cual en modo sepia o noche, se leen mal.

Al importar, cada página se clasifica (digital, escaneo o imagen) y los escaneos se limpian en segundo plano: papel blanco y uniforme, tinta negra. La página limpia se guarda ya calculada, así que pasar página no cuesta nada: el visor solo la escala y la tiñe con una matriz de color. El PDF original nunca se toca y se puede volver a él.

La app

La biblioteca de Libitum en una tablet: portadas de partituras, buscador y navegación lateral
La biblioteca. Las marcas de cada portada dicen si la obra está en la tablet, guardada para un concierto o solo en la nube.
El metrónomo de Libitum: péndulo, tempo grande, rueda de tempo y compases
Metrónomo con péndulo, rueda de tempo y marcar tempo.
El afinador de Libitum con la aguja y la transposición del instrumento
Afinador en la transposición del instrumento.

En cifras

20
especificaciones de función
11.500
líneas de Kotlin, aproximadamente
76
pruebas automáticas
5,9 MB
pesa la app instalable
3
idiomas: español, gallego e inglés
7 días
del primer documento (8 de noviembre de 2026) a la versión 0.6.2

Lo que falta