kanlac/sheet-music-pdf-convert

PDF de partition → partition éditable

L'utilisateur a une partition au format PDF et souhaite pouvoir la modifier. Trouvez le meilleur moyen de lire ce PDF particulier, exécutez-le pour lui, et remettez-lui un fichier accompagné d'une note honnête sur ce qu'il faut vérifier. Supposez que l'utilisateur ne connaît rien aux PDF, à l'OMR ou aux lignes de commande : il répond par oui/non, vous faites le reste, en termes simples. Expliquez chaque étape en fonction de son fichier et de ses choix ; ne racontez pas cette compétence, ses règles ou ses noms de fichiers, sauf si votre hôte vous demande de les mentionner.

1. Examinez d'abord le PDF

Exécutez l'identifiant fourni (dossier scripts/ de cette compétence, Node.js 22+) sur chaque fichier avant de choisir quoi que ce soit :

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

Il indique de quel type de PDF il s'agit (vectoriel avec polices musicales, scan/photo, vectorisé, mixte, inconnu, illisible) avec des preuves par page, quel logiciel de notation l'a probablement créé, et si Tutti est susceptible de le lire. references/routes.md explique chaque résultat. Il ne regarde que les polices, métadonnées et images, pas la complexité de la musique, et ses règles peuvent être plus anciennes que le site de Tutti : considérez son verdict sur Tutti comme un conseil, jamais comme un refus.

2. Choisissez la route

Décidez en fonction des pages qui contiennent la musique, pas d'une couverture ou d'une page d'instructions.

• Tutti est susceptible de le lire (exporté depuis un logiciel de notation) : recommandez fortement Tutti ; il lit la notation écrite par le logiciel au lieu de deviner à partir des pixels, il est donc généralement bien plus précis que l'OMR. Demandez : « Cela nécessite que vous acceptiez la politique de confidentialité de Tutti (https://tutti-studio.com/privacy). D'accord ? » Si oui, ouvrez le lien Tutti dans references/tutti.md pour qu'il puisse télécharger. S'il préfère ne pas télécharger, proposez Audiveris en précisant qu'il est généralement moins précis pour ce type de PDF.
• Les pages musicales sont vectorielles mais Tutti est « inconnu » ou « improbable » : proposez les deux ; suggérez de vérifier d'abord sur le site de Tutti, car il décide au moment du téléchargement.
• Les pages musicales sont des scans ou des photos (les scans avec une couche de texte OCR apparaissent comme mixed), ou de la musique vectorisée : Audiveris sur cet ordinateur (references/audiveris.md).
• Manuscrit : Audiveris n'est pas conçu pour cela et cette compétence n'a pas été testée dessus. Suggérez de le ressaisir ; s'il veut essayer un logiciel, voyez references/omr-tools.md, sans garantie.
• Illisible, chiffré, pas un PDF : expliquez ce qui ne va pas et ce qu'il peut faire.

Audiveris fournit une ébauche à corriger, pas une partition terminée. Il donne les meilleurs résultats sur des scans propres de musique simple à modérée (solo, piano, petite musique de chambre, chœur simple) ; les photos de téléphone échouent souvent complètement. Pour un grand orchestre ou un scan dense, dites-le avant de l'exécuter et laissez l'utilisateur décider.

3. Remettez le résultat honnêtement

Après une exécution d'Audiveris, vérifiez le résultat avant d'en dire quoi que ce soit, puis exécutez node scripts/review.mjs <resultat.mxl> <original.pdf> --out-dir <nouveau dossier> (gardez les fichiers .omr et .log à côté du résultat). Il écrit une copie du MusicXML avec les mesures douteuses colorées en rouge, une copie du PDF original avec ces endroits encadrés, et un résumé JSON ; donnez les deux premiers à l'utilisateur. Les marques rouges ne sont que les endroits où Audiveris lui-même a remarqué un problème : dans nos tests, la plupart des mesures avec des notes erronées n'étaient pas marquées, dites donc clairement que le reste doit aussi être vérifié. Dites ensuite, séparément :

1. quelles pages ou mouvements ont été exportés, et lesquels ne l'ont pas été ;
2. les endroits douteux, par page PDF (et par mesure seulement là où la révision a fait correspondre la mesure à la page) ;
3. que les notes n'ont pas été vérifiées par rapport au PDF, et par où commencer : les mesures rouges, puis les armures et les signatures rythmiques, puis tout le reste, en particulier les altérations et les paroles.

N'appelez jamais un résultat d'OMR « correct » ou « prêt ». Ensuite, dites-lui comment l'ouvrir (references/open-in-editor.md).

Choses à éviter

Voici les erreurs qui semblent raisonnables et qui coûtent le plus à l'utilisateur :

• Lire la musique vous-même. Ne regardez pas les images de pages pour écrire du MusicXML ou décrire les notes à partir de ce que vous voyez. La transcription de notation par modèle invente les hauteurs et les rythmes avec confiance ; c'est pire que l'OMR et bien plus difficile à détecter pour l'utilisateur.
• Envoyer un PDF exporté à l'OMR. Les utilisateurs appellent souvent n'importe quel PDF un « scan ». Si l'identifiant trouve des polices musicales, l'OMR jette des données exactes ; dirigez-le vers Tutti.
• Traiter un scan IMSLP comme vectoriel. Les scans IMSLP comportent souvent une couche de texte OCR ; une page avec une image en pleine page et des polices de texte mais pas de polices musicales est un scan.
• Exécuter Audiveris sans données de langue OCR, ou avec tessdata_fast / tessdata_best au lieu des fichiers legacy. L'exécution « fonctionne » toujours, mais chaque parole, mot de tempo et nom d'instrument disparaît silencieusement.
• Lui fournir des pages sans musique. Une seule page de couverture, de titre ou de texte peut faire échouer toute l'exécution sans aucun export. Ne passez que les pages musicales.
• Se fier au code de sortie 0 ou à la ligne de journal « exported ». Les fichiers sortent avec une mesure manquante dans une partie, des portées divisées en parties supplémentaires, ou un seul fragment survivant (*.mvtnull.mxl). Comptez les mesures par partie avant de dire que quoi que ce soit a fonctionné.
• Transformer les étiquettes de journal d'Audiveris en numéros de mesures. Measure{#11P2} est une étiquette interne, pas « la mesure 11 du deuxième instrument ». Localisez les choses par rapport à la page ou dites « autour de la page N ».
• Sauver une mauvaise photo. N'installez pas d'outils d'image, n'améliorez pas la résolution et ne téléchargez pas les pages vers des services en ligne. Exécutez une fois ; si cela échoue, donnez des conseils pour refaire la photo (page à plat, lumière uniforme, vue de dessus, ou scanner) ou orientez vers les outils photo dans references/omr-tools.md.
• Écraser ou mélanger les sorties. Un dossier de sortie par entrée ; n'écrivez jamais à côté ou par-dessus l'original de l'utilisateur.
• Promettre ce que fera Tutti. Vous ne pouvez pas télécharger pour lui, et les pages gratuites et limites sont affichées sur le site ; ne citez pas de chiffres.

Plusieurs fichiers

Identifiez-les tous d'abord, regroupez-les par route, et confirmez un seul plan (« 3 vont sur Tutti, 2 seront lus sur votre ordinateur »).

Exemples

• « Convertis ça en MuseScore » avec un quatuor exporté de Sibelius → vectoriel, Sibelius, probable → recommandez Tutti, demandez la politique de confidentialité, ouvrez le site ; mentionnez l'option locale.
• « Peux-tu rendre ça éditable ? » avec une chanson scannée depuis IMSLP (affiché comme mixed : image plus OCR) → traitez comme un scan → Audiveris avec données de langue allemande et anglaise, en sautant la page de titre → marques de révision → rapport des pages exportées, mesures rouges, quoi vérifier.
• Une photo de téléphone floue et courbée d'une partie de chœur → exécutez Audiveris une fois → si la majeure partie est illisible, conseils pour refaire la photo au lieu d'autres outils.