kanlac/sheet-music-pdf-convert

Partitur-PDF → bearbeitbare Partitur

Der Benutzer hat eine Partitur als PDF und möchte etwas, das er bearbeiten kann. Finde den besten Weg, dieses bestimmte PDF zu lesen, führe ihn aus und gib eine Datei sowie eine ehrliche Notiz zurück, worauf zu achten ist. Gehe davon aus, dass der Benutzer nichts über PDFs, OMR oder die Kommandozeile weiß: Er beantwortet Ja/Nein-Fragen, du erledigst den Rest in einfachen Worten. Erkläre jeden Schritt im Hinblick auf seine Datei und seine Wahlmöglichkeiten; überspringe die Erzählung über dieses Skill, seine Regeln oder seine Dateinamen, es sei denn, dein Host verlangt, dass du sie erwähnst.

1. PDF zuerst ansehen

Führe den mitgelieferten Identifizierer (dieses Skills scripts/-Ordner, Node.js 22+) für jede Datei aus, bevor du etwas auswählst:

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

Er berichtet, um welche Art von PDF es sich handelt (Vektor mit Notenschriftarten, Scan/Foto, umrissen, gemischt, unbekannt, nicht lesbar) mit seitenweiser Begründung, welches Notationsprogramm es wahrscheinlich erstellt hat und ob Tutti es wahrscheinlich lesen kann. references/routes.md erklärt jedes Ergebnis. Es untersucht nur Schriftarten, Metadaten und Bilder, nicht die Komplexität der Musik, und seine Regeln können älter sein als die Tutti-Website: Behandle das Tutti-Urteil als Ratschlag, niemals als Ablehnung.

2. Route auswählen

Entscheide anhand der Seiten, die die Musik enthalten, nicht anhand eines Covers oder einer Anleitungsseite.

• Tutti kann es wahrscheinlich lesen (aus Notensatzsoftware exportiert): Tutti dringend empfehlen; es liest die Notation, die das Programm geschrieben hat, anstatt aus Pixeln zu raten, daher ist es normalerweise weitaus genauer als OMR. Frage: „Dies erfordert, dass du Tutti's Datenschutzrichtlinie (https://tutti-studio.com/privacy) zustimmst. OK?“ Wenn ja, öffne den Tutti-Link in references/tutti.md, damit sie es hochladen können. Wenn sie lieber nicht hochladen möchten, biete Audiveris an und sage, dass es für diese Art von PDF normalerweise weniger genau ist.
• Notenseiten sind Vektor, aber Tutti ist „unbekannt“ oder „unwahrscheinlich“: Beide anbieten; vorschlagen, zuerst auf der Tutti-Website zu prüfen, da diese beim Hochladen entscheidet.
• Notenseiten sind Scans oder Fotos (Scans mit einer OCR-Textschicht zeigen sich als gemischt), oder umrissene Noten: Audiveris auf diesem Computer (references/audiveris.md).
• Handschriftlich: Audiveris ist nicht dafür gemacht und dieses Skill ist darauf nicht getestet. Vorschlagen, die Noten erneut einzugeben; wenn sie Software ausprobieren möchten, siehe references/omr-tools.md, ohne Garantie.
• Nicht lesbar, verschlüsselt, kein PDF: Erklären, was falsch ist und was sie tun können.

Audiveris liefert einen Entwurf zum Korrigieren, keine fertige Partitur. Es funktioniert am besten mit sauberen Scans einfacher bis mittelschwerer Musik (Solo, Klavier, kleine Kammermusik, einfacher Chor); Handyfotos scheitern oft vollständig. Bei einem großen Orchester- oder dichten Scan sag dies vor dem Ausführen und lass den Benutzer entscheiden.

3. Ehrlich zurückgeben

Nach einem Audiveris-Durchlauf überprüfe das Ergebnis, bevor du etwas darüber sagst, führe dann node scripts/review.mjs <ergebnis.mxl> <original.pdf> --out-dir <neuer Ordner> aus (behalte die .omr- und .log-Dateien neben dem Ergebnis). Es schreibt eine Kopie der MusicXML mit zweifelhaften Takten rot markiert, eine Kopie des Original-PDFs mit eingerahmten Stellen und eine JSON-Zusammenfassung; gib dem Benutzer die ersten beiden. Die roten Markierungen sind nur die Stellen, an denen Audiveris selbst Probleme bemerkt hat: In unseren Tests waren die meisten Takte mit falschen Noten nicht markiert, also sage klar, dass auch der Rest überprüft werden muss. Sage dann getrennt:

1. welche Seiten oder Sätze exportiert wurden und welche nicht;
2. die zweifelhaften Stellen, nach PDF-Seite (und nur nach Takt, wo die Überprüfung sie der Seite zugeordnet hat);
3. dass die Noten nicht mit dem PDF abgeglichen wurden und wo man beginnen sollte: die roten Takte, dann Vorzeichen und Taktarten, dann alles andere, insbesondere Akzidenzien und Liedtexte.

Bezeichne ein OMR-Ergebnis niemals als „korrekt“ oder „fertig“. Sage ihnen dann, wie sie es öffnen können (references/open-in-editor.md).

Dinge, die vermieden werden sollten

Dies sind die Fehler, die vernünftig aussehen und den Benutzer am meisten kosten:

• Die Musik selbst lesen. Sieh dir keine Seitenbilder an und schreibe MusicXML oder beschreibe die Noten nicht basierend auf dem, was du siehst. Modelltranskription von Notation erfindet Tonhöhen und Rhythmen überzeugend; sie ist schlechter als OMR und für den Benutzer viel schwerer zu erkennen.
• Ein exportiertes PDF an OMR senden. Benutzer nennen jedes PDF oft einen „Scan“. Wenn der Identifizierer Notenschriftarten findet, verwirft OMR exakte Daten; leite es zu Tutti weiter.
• Einen IMSLP-Scan als Vektor behandeln. IMSLP-Scans haben oft eine OCR-Textschicht; eine Seite mit einem ganzseitigen Bild und Textschriftarten, aber keinen Notenschriftarten, ist ein Scan.
• Audiveris ohne OCR-Sprachdaten ausführen oder mit tessdata_fast / tessdata_best anstelle der Legacy-Dateien. Der Durchlauf „funktioniert“ noch, aber jeder Liedtext, Tempowort und Instrumentenname verschwindet lautlos.
• Seiten ohne Musik füttern. Ein einzelnes Cover, eine Titelseite oder Textseite kann den gesamten Durchlauf zum Scheitern bringen, ohne Export. Gib nur die Notenseiten weiter.
• Dem Exit-Code 0 oder der „exportiert“-Log-Zeile vertrauen. Dateien kommen mit einem fehlenden Takt in einer Stimme, in zusätzliche Stimmen aufgeteilte Systeme oder einem einzelnen überlebenden Fragment (*.mvtnull.mxl) heraus. Zähle die Takte pro Stimme, bevor du sagst, dass etwas funktioniert hat.
• Audiveris-Log-Labels in Taktnummern umwandeln. Measure{#11P2} ist ein internes Label, nicht „Takt 11 des zweiten Instruments“. Orientiere dich an der Seite oder sage „ungefähr Seite N“.
• Ein schlechtes Foto retten. Installiere keine Bildwerkzeuge, skaliere nicht hoch und lade keine Seiten zu Online-Diensten hoch. Führe einmal aus; wenn es fehlschlägt, gib Ratschläge zum erneuten Fotografieren (flache Seite, gleichmäßiges Licht, von oben, oder ein Scanner) oder verweise auf die Fotowerkzeuge in references/omr-tools.md.
• Ausgaben überschreiben oder mischen. Ein Ausgabeordner pro Eingabe; schreibe niemals neben oder über das Original des Benutzers.
• Versprechen, was Tutti tun wird. Du kannst nicht für sie hochladen, und kostenlose Seiten und Limits werden auf der Website angezeigt; zitiere keine Zahlen.

Mehrere Dateien

Identifiziere sie alle zuerst, gruppiere sie nach Route und bestätige einen Plan („3 gehen zu Tutti, 2 werden auf deinem Computer gelesen“).

Beispiele

• „Konvertiere dies zu MuseScore“ mit einem in Sibelius exportierten Quartett → Vektor, Sibelius, wahrscheinlich → Tutti empfehlen, nach der Datenschutzrichtlinie fragen, die Website öffnen; die lokale Option erwähnen.
• „Kannst du das bearbeitbar machen?“ mit einem gescannten Lied von IMSLP (zeigt sich als gemischt: Bild plus OCR-Text) → als Scan behandeln → Audiveris mit deutschen und englischen Sprachdaten, Titelseite überspringen → Markierungen überprüfen → exportierte Seiten, rote Takte, was zu prüfen ist, melden.
• Ein unscharfes, gekrümmtes Handyfoto einer Chorstimme → Audiveris einmal ausführen → wenn das meiste unlesbar ist, Ratschläge zum erneuten Fotografieren statt weiterer Werkzeuge.