kanlac/sheet-music-pdf-convert

Partitura en PDF → partitura editable

El usuario tiene una partitura en PDF y quiere algo que pueda editar. Encuentra la mejor manera de leer este PDF en particular, ejecútalo y entrega un archivo junto con una nota honesta sobre qué revisar. Asume que el usuario no sabe nada sobre PDF, OMR o líneas de comando: él responde preguntas de sí/no, tú haces el resto, en lenguaje sencillo. Explica cada paso en términos de su archivo y sus opciones; omite narraciones sobre esta skill, sus reglas o sus nombres de archivo a menos que tu anfitrión requiera que los menciones.

1. Mira el PDF primero

Ejecuta el identificador incluido (la carpeta scripts/ de esta skill, Node.js 22+) en cada archivo antes de elegir cualquier cosa:

node scripts/identify.mjs <archivo.pdf> --json

Reporta qué tipo de PDF es (vectorial con fuentes musicales, escaneado/foto, contorneado, mixto, desconocido, ilegible) con evidencia por página, qué programa de notación probablemente lo creó, y si es probable que Tutti lo lea. references/routes.md explica cada resultado. Solo revisa fuentes, metadatos e imágenes, no la complejidad de la música, y sus reglas pueden ser más antiguas que el sitio web de Tutti: trata su veredicto sobre Tutti como un consejo, nunca como una negativa.

2. Elige la ruta

Decide según las páginas que contienen la música, no por una portada o una página de instrucciones.

• Es probable que Tutti lo lea (exportado desde software de notación): recomienda fuertemente Tutti; lee la notación que el programa escribió en lugar de adivinar a partir de píxeles, por lo que suele ser mucho más preciso que el OMR. Pregunta: "Esto requiere que aceptes la política de privacidad de Tutti (https://tutti-studio.com/privacy). ¿De acuerdo?" Si es así, abre el enlace de Tutti en references/tutti.md para que suban su archivo. Si prefieren no subirlo, ofrece Audiveris y di que suele ser menos preciso para este tipo de PDF.
• Las páginas de música son vectoriales pero Tutti es "desconocido" o "poco probable": ofrece ambas opciones; sugiere verificar primero en el sitio web de Tutti, ya que decide al subir el archivo.
• Las páginas de música son escaneos o fotos (los escaneos con una capa de texto OCR aparecen como mixed), o música contorneada: Audiveris en esta computadora (references/audiveris.md).
• Manuscrito: Audiveris no está hecho para ello y esta skill no ha sido probada en ello. Sugiere reingresarlo; si quiere probar software, consulta references/omr-tools.md, sin promesas.
• Ilegible, encriptado, no es un PDF: explica qué está mal y qué puede hacer.

Audiveris entrega un borrador para corregir, no una partitura terminada. Funciona mejor en escaneos limpios de música simple a moderada (solistas, piano, música de cámara pequeña, coro simple); las fotos de teléfono a menudo fallan por completo. Para un escaneo orquestal grande o denso, dilo antes de ejecutarlo y deja que el usuario decida.

3. Entrega el resultado con honestidad

Después de una ejecución de Audiveris, revisa el resultado antes de decir algo sobre él, luego ejecuta node scripts/review.mjs <resultado.mxl> <original.pdf> --out-dir <nueva carpeta> (mantén los archivos .omr y .log junto al resultado). Escribe una copia del MusicXML con los compases dudosos coloreados en rojo, una copia del PDF original con esos lugares enmarcados, y un resumen JSON; entrega al usuario los dos primeros archivos. Las marcas rojas solo son los lugares donde el propio Audiveris notó problemas: en nuestras pruebas, la mayoría de los compases con notas incorrectas no estaban marcados, así que di claramente que el resto también necesita revisión. Luego, di por separado:

1. qué páginas o movimientos se exportaron y cuáles no;
2. los lugares dudosos, por página del PDF (y por compás solo cuando la revisión lo vinculó a la página);
3. que las notas no han sido verificadas contra el PDF, y por dónde empezar: los compases rojos, luego las armaduras de clave y los compases, luego todo lo demás, especialmente alteraciones y letras.

Nunca llames a un resultado de OMR "correcto" o "listo". Luego dile cómo abrirlo (references/open-in-editor.md).

Cosas que evitar

Estos son los errores que parecen razonables y que más le cuestan al usuario:

• Leer la música tú mismo. No mires las imágenes de las páginas y escribas MusicXML o describas las notas a partir de lo que ves. La transcripción de notación por modelo inventa alturas y ritmos con seguridad; es peor que el OMR y mucho más difícil de detectar para el usuario.
• Enviar un PDF exportado a OMR. Los usuarios a menudo llaman "escaneo" a cualquier PDF. Si el identificador encuentra fuentes musicales, el OMR descarta datos exactos; enrútalo a Tutti.
• Tratar un escaneo de IMSLP como vectorial. Los escaneos de IMSLP a menudo tienen una capa de texto OCR; una página con una imagen a página completa y fuentes de texto pero sin fuentes musicales es un escaneo.
• Ejecutar Audiveris sin datos de idioma de OCR, o con tessdata_fast / tessdata_best en lugar de los archivos heredados. La ejecución aún "funciona", pero cada letra, palabra de tempo y nombre de instrumento desaparece silenciosamente.
• Alimentarlo con páginas sin música. Una sola portada, página de título o texto puede hacer que toda la ejecución falle sin exportación. Pasa solo las páginas de música.
• Confiar en el código de salida 0 o en la línea de registro "exported". Los archivos salen con un compás faltante de una parte, pentagramas divididos en partes extra, o un solo fragmento superviviente (*.mvtnull.mxl). Cuenta los compases por parte antes de decir que algo funcionó.
• Convertir las etiquetas de registro de Audiveris en números de compás. Measure{#11P2} es una etiqueta interna, no "compás 11 del segundo instrumento". Localiza las cosas contra la página o di "alrededor de la página N".
• Rescatar una mala foto. No instales herramientas de imagen, no aumentes la resolución ni subas páginas a servicios en línea. Ejecuta una vez; si falla, da consejos para volver a tomar la foto (página plana, luz uniforme, directamente encima, o un escáner) o señala las herramientas de foto en references/omr-tools.md.
• Sobrescribir o mezclar salidas. Una carpeta de salida por entrada; nunca escribas junto a o sobre el original del usuario.
• Prometer lo que hará Tutti. No puedes subir archivos por ellos, y las páginas gratuitas y los límites se muestran en el sitio; no cites números.

Varios archivos

Identifícalos todos primero, agrúpalos por ruta y confirma un plan ("3 van a Tutti, 2 se leerán en tu computadora").

Ejemplos

• "Convierte esto a MuseScore" con un cuarteto exportado desde Sibelius → vectorial, Sibelius, probable → recomienda Tutti, pregunta sobre la política de privacidad, abre el sitio; menciona la opción local.
• "¿Puedes hacer esto editable?" con una canción escaneada de IMSLP (aparece como mixed: imagen más texto OCR) → tratar como escaneo → Audiveris con datos de idioma alemán e inglés, omitiendo la página de título → marcas de revisión → reporta páginas exportadas, compases rojos, qué revisar.
• Una foto borrosa y curvada de teléfono de una parte de coro → ejecuta Audiveris una vez → si la mayor parte es ilegible, consejos para volver a tomar la foto en lugar de más herramientas.