Änderungsprotokoll

Unsere REST-API-Spezifikation wechselt zu OpenAPI 3.1, die OMR-API beendet ihre Beta-Phase, und Aufgaben in Flat for Education gehen über das bloße Auflisten und Erstellen hinaus.

• Die OMR-API ist stabil. Endpunkte, Felder und Verhalten folgen nun vor jeder inkompatiblen Änderung unserem üblichen Abkündigungsprozess. Eine neue FAQ behandelt Credits und Abrechnung, Limits und Verarbeitungszeiten, Erkennungsqualität und Sprachen sowie kommerzielle Nutzung und Datenschutz.
• Aufgaben lesen, aktualisieren und löschen in Flat for Education. Beim Löschen einer Aufgabe werden auch ihre Abgaben und die Kopien der Schülerinnen und Schüler entfernt; archiviere sie stattdessen, um die Arbeit zu behalten.
• Credit ledger. Ein neuer Aufruf listet deinen Credit-Verlauf auf; das Guthaben bleibt im Aufruf für die OMR-Funktionen.
• Finale-Dateien (.musx) können importiert werden, nach bestem Bemühen, und der Import gescannter Musik (PDF und Bilder) ist bei der Erstellung von Partituren dokumentiert.
• OpenAPI 3.1. Nullable-Felder verwenden die 3.1-Syntax; Werkzeuge, die auf OpenAPI 3.0 festgelegt sind, müssen aktualisiert werden. Das Feld mimeType wurde aus OMR-Datei-Uploads entfernt.

Wähle eine Passage aus, drücke L, und sie wird wiederholt, bis du sie stoppst. Die Noten bleiben dabei bearbeitbar, sodass jede Änderung beim nächsten Durchlauf zu hören ist. Der Loop-Modus ist in allen Tarifen kostenlos.

• Drei Möglichkeiten, einen Loop zu starten: Wähle Takte aus und drücke L, wähle im Auswahlmenü Loop, oder drücke den Loop-Button in der Kopfzeile, um den Takt zu loopen, in dem sich dein Cursor befindet. Ziehe an den Griffen, um den Bereich zu erweitern oder zu verkleinern, auch während der Wiedergabe.
• Die Noten bleiben bearbeitbar. Klicke während der Wiedergabe auf eine Note, ändere sie, und höre das Ergebnis beim nächsten Durchlauf. Loops funktionieren auch mit synchronisiertem YouTube, Vimeo, SoundCloud oder einer hochgeladenen Aufnahme.
• Die Wiedergabe startet am Cursor, nicht am Anfang. Beim Stoppen bleibt die Position erhalten: Die Leertaste spielt ab dem Cursor, Shift + Leertaste setzt genau dort fort, wo die Musik gestoppt hat (auf Mobilgeräten Play gedrückt halten). Zurück zum Anfang verschiebt den Cursor im gestoppten Zustand und startet die Wiedergabe neu, wenn bereits abgespielt wird.

Verfügbar im neuen Editor im Web und in der neuen mobilen Symbolleiste auf Android; iOS folgt. Eingebettete Partituren können über die embed API ebenfalls in Schleife wiedergegeben werden.

Der Editor in Flat for Education verwendet jetzt dieselbe Werkzeugleiste wie Flat: eine vertikale Leiste auf der linken Seite, die Panels für Notation, Instrumente, Layout und Details öffnet, sowie zusätzliche Panels für den Unterricht.

• Aufgaben-Panels für Schüler:innen: Komposition, gemeinsames Schreiben, Aufführung, Arbeitsblätter und freie Aufnahme erhalten jeweils ein Panel neben der Partitur. Die Anweisungen der Lehrkraft sind nur einen Klick entfernt und lassen sich in ein schwebendes Fenster auslagern.
• Korrektur-Panels für Lehrkräfte mit demselben Layout bei der Bewertung der Arbeiten einzelner Schüler:innen sowie passenden Vorschauen der Schülerpartituren beim Erstellen einer Aufgabe.
• Die Schnellsuche ist standardmäßig aktiviert: Geben Sie ein, wonach Sie suchen, und der Editor findet das Werkzeug, beschränkt auf die Werkzeuge, die Ihr Werkzeugsatz zulässt.

Mehr über die neue Seitenleiste lesen Sie im Blog.

Eine neue Version unseres hauseigenen Modells verarbeitet jetzt alle PDF- und Fotoimporte und konzentriert sich darauf, wie Tuplets auf der Seite gesetzt sind.

• Implizite Tuplets werden jetzt unterstützt. Notenstecher drucken die kleine „3“ oder „6“ meist nur über der ersten Triole oder Sextole einer Passage; die folgenden Gruppen bleiben dann ohne Kennzeichnung – von den Spielenden wird erwartet, dass sie das Muster fortführen. Diese unmarkierten Gruppen sind implizite Tuplets: Sie werden als Tuplets gespielt, obwohl nichts Entsprechendes notiert ist. Sie kommen sehr häufig in Ausgaben des 19. Jahrhunderts, Etüden und Variationen vor. Beim Scannen werden sie jetzt aus dem Rhythmus des Taktes rekonstruiert, statt Noten wegzulassen, damit der Takt zur Taktart passt.
• Weniger frei erfundene Tuplets. Das Modell markierte früher gewöhnliche Balkengruppen als Triolen, selbst wenn keine Zahl darüber stand, und diese Zahlen erschienen dann in deiner Partitur. Jetzt schreibt es ein Tuplet nur noch dort, wo auf der Seite tatsächlich eines notiert ist.

• Datenaufbewahrung unter Ihrer Kontrolle. OMR-Jobs geben jetzt an, wie lange ihre Dateien aufbewahrt werden (standardmäßig 30 Tage), jeder MusicXML-Job hat ein Ablaufdatum, und Sie können die Dateien und Ergebnisse eines Jobs löschen, sobald Sie sie abgeholt haben.
• Funktionsprüfung vor der Anmeldung. Der OMR-Funktionsaufruf funktioniert jetzt ohne Konto und listet die unterstützten Erkennungssprachen mit ihren Namen auf.
• ABC-Notation-Export für jede Partiturrevision, zusammen mit MusicXML, MIDI und den anderen Formaten. Wie bei MIDI wird dabei nicht die vollständige grafische Gestaltung übertragen.
• Free Record-Aufgaben können in Flat for Education über die API konfiguriert werden.
• Fehler von einem Upstream-Anbieter (zum Beispiel Google Classroom) enthalten jetzt die eigene lokalisierte Meldung des Anbieters.

Der Flat for Education-Editor ist jetzt auch als Desktop-App für Mac und Windows verfügbar. Dasselbe Konto, dieselben Partituren – für alle Konten, die durch eine Schullizenz abgedeckt sind: Lehrkräfte, Schülerinnen und Schüler sowie Administratoren.

• Funktioniert offline. Kein Wi‑Fi im Unterricht? Komponiere und bearbeite einfach weiter: Deine Arbeit wird auf dem Computer gespeichert, und deine Änderungen werden beim nächsten Online-Start der App wieder mit deinem Konto synchronisiert.
• Deine gesamte Bibliothek, synchronisiert. Melde dich an, und alle Partituren, Aufgaben und Klassen sind da – im Web und auf dem Desktop. Beginne eine Partitur im Browser und arbeite in der App weiter, oder umgekehrt.
• Der vollständige Editor in einem eigenen Fenster. Notation, Wiedergabe, MusicXML- und MIDI-Import und -Export, PDF-Export sowie Noteneingabe über ein USB- oder Bluetooth-MIDI-Keyboard.
• Installiere sie auf jedem Computer. Rechner im Fachraum, das Laptop des Kollegiums, der Heimcomputer eines Schülers oder einer Schülerin: Es gibt kein Installationslimit pro Arbeitsplatz.

Du bekommst sie unter flat.io/edu/desktop oder über dein Kontomenü in der Web-App: Dort wird automatisch der passende Download für deinen Computer ausgewählt.

Eine neue Version unseres hauseigenen Modells steckt jetzt hinter jedem PDF- und Fotoimport und reduziert die Fehler in unseren Benchmarks für gescannte Noten um 22 % bis 51 %. Am größten sind die Verbesserungen bei schwierigeren Seiten – älteren Stichen und ungleichmäßigem Druck.

Eine verbesserte Version von Flats internem Modell verarbeitet nun jeden PDF- und Fotoimport, insbesondere:

• Mehrstimmige Passagen mit gemeinsam genutzten Pausen und unsichtbaren Pausen werden jetzt unterstützt.
• Taktstriche und Wiederholungsklammern (Volten) werden nun innerhalb der Takte korrekt platziert.
• Balken werden zuverlässiger erkannt.
• Taktarten, die sich wie in Orchesterauszügen über mehrere Notensysteme erstrecken, werden nun erkannt.
• Einige Akkordsymbole wurden korrigiert, die mit einem nicht standardisierten Akkordtyp nach MusicXML exportiert wurden.

Vorspielaufgaben brauchen kein angehängtes Notenblatt mehr. Wähle beim Erstellen im Schritt für die Partitur Free Record, und Schülerinnen und Schüler nehmen sich selbst bei allem auf, was die Aufgabe verlangt: ihr eigenes Repertoire, eine Improvisation, ein Warm-up oder ein Stück, das nur auf Papier existiert.

• Für Lehrkräfte. Im Erstellungsablauf werden die Optionen ausgeblendet, die nur mit einer Partitur sinnvoll sind (Wiedergabe, Metronom, Backingtrack, Tempo). Abgaben landen in einer für Aufnahmen vorgesehenen Korrekturansicht, in der du wie gewohnt zuhörst, kommentierst und benotest.
• Für Schülerinnen und Schüler. Die Aufgabe öffnet sich in einer Aufnahmeansicht mit deinen Anweisungen daneben. Sie nehmen auf, hören es sich an und geben ab, wenn sie bereit sind. Videoaufnahmen werden unterstützt.

Partiturbasierte Vorspielaufgaben funktionieren genau wie bisher. Mehr dazu im Blog.

Der Prima-vista-Generator bietet jetzt mehr Kontrolle darüber, was er schreibt, und eine Möglichkeit für Schüler, ihn selbstständig zu nutzen.

• Ton- und Taktarten wählen. Wähle eine oder mehrere Tonarten und Taktarten aus, und jede Übung bleibt innerhalb dieser Vorgaben sowie des für das Instrument festgelegten Tonumfangs.
• Stimmen für die ganze Band. Erstelle eine Übung für eine Band, und jede Gruppe erhält ihre eigene Stimme in passendem Schlüssel und mit der richtigen Transposition (C, B, Es, F, Bassschlüssel), wobei alle dieselbe Zeile lesen.
• Direkt in die Aufgabe. Öffne den Generator direkt beim Erstellen einer Performance-Aufgabe und füge das Ergebnis hinzu, ohne den Ablauf zu verlassen.
• Übungsmodus für Schüler. Schüler finden den Generator auf ihrer eigenen Werkzeugseite und erstellen Übungen zum Vom-Blatt-Lesen in ihrem eigenen Tempo, unabhängig von einer Aufgabe. Nichts wird abgegeben oder benotet.
• Öffnet in der Spuransicht. Eine erzeugte Übung wird in der horizontalen Spuransicht geöffnet, bereit zum Lesen von links nach rechts, und enthält nie zwei Pausen hintereinander.

Mehr dazu im Blog.

Der Import von Noten aus einer PDF-Datei oder einem Foto hat in der Web-App einen neuen Ablauf, basierend auf Flats eigener Erkennungs-Engine. Er ersetzt den bisherigen PDF-Import für alle.

• Wähle die gewünschten Seiten aus. Lade eine PDF-Datei oder mehrere Fotos hoch und behalte nur die Seiten, die die Musik enthalten. Jede Seite, die du behältst, verbraucht einen Credit.
• Verfolge die Erkennung während des Vorgangs. Ein Fortschrittsbalken zeigt seitenweise an, wie weit der Scan ist, und du kannst Flat währenddessen weiter benutzen.
• Prüfe alles, bevor die Partitur erstellt wird. Wenn die Engine sich bei einem Instrument nicht sicher ist, bittet sie dich, den Titel und die erkannten Instrumente zu bestätigen; die auf der Seite gedruckten Stimmenbezeichnungen werden jeweils daneben angezeigt. Wenn alle Instrumente eindeutig erkannt werden, wird dieser Schritt übersprungen.

Verfügbar in Flat und für Lehrkräfte und Administratoren auch in Flat for Education. Der neue Ablauf kommt in den nächsten Wochen in die iOS-App.

Die OMR-Engine von Flat ist jetzt programmatisch über die Developer API verfügbar. Sende PDFs oder Fotos, verfolge den Erkennungsfortschritt, prüfe die erkannten Instrumente und importiere das Ergebnis dann als bearbeitbare Partitur in eine Flat-Bibliothek oder exportiere MusicXML oder MIDI. Es ist dasselbe hauseigene Modell, das den PDF- und Fotoimport im Editor ermöglicht, und steht jetzt in großem Maßstab für deine eigenen Apps und Workflows zur Verfügung.

Die dedizierte OMR-API (v2.24.0) baut auf dem Hintergrundimport von PDFs auf, der in v2.23.0 zur Partiturerstellung hinzugefügt wurde: Fordere beim Importieren einer Datei Aufgabenunterstützung an und frage die Aufgabe ab, bis die Partitur bereit ist. Details zu beiden Releases findest du im API-Änderungsprotokoll.

Flat for Education hat jetzt vier Kontorollen: Admin, Support Admin, Lehrkraft und Schüler/in. Die neue Rolle Support Admin ist für Personen gedacht, die die Schule im Hintergrund organisieren (IT-Kontakte, Finanzteams, Schulleitung) und das Konto verwalten müssen, ohne zu unterrichten.

• Voller Verwaltungszugriff: Abrechnung und Abonnement, Personen (Lehrkräfte und Schüler/innen einladen und entfernen), Schuleinstellungen, Integrationen und das Usage Dashboard.
• Keine Unterrichtswerkzeuge: keine Klassen, keine Aufgaben, keine Schülerarbeiten zur Durchsicht.
• Kein Lizenzplatz belegt: Fügen Sie so viele Support Admins hinzu, wie Ihre Schule benötigt. Wenn jemand die Admin-Rolle nur hat, um die Abrechnung einzusehen, wird durch den Wechsel zu Support Admin ohne zusätzliche Kosten ein Platz für eine Lehrkraft frei.

Admins und Support Admins weisen Rollen im Bereich Personen zu. Unter Rollen und Berechtigungen sehen Sie, was die einzelnen Rollen können, oder lesen Sie den Blogbeitrag.

Wir haben verbessert, wie der Scan das Seitenlayout liest. Beim Import von PDFs und Fotos entstehen jetzt sauberere und genauere Noten, besonders bei komplexen Layouts:

• Dichte Seiten werden jetzt korrekt getrennt. Seiten mit vielen kurzen, übereinander gestapelten Systemen werden nicht mehr zusammengeführt – jedes System wird separat erkannt.
• Besser bei Orchester- und großen Ensemblepartituren. Instrumente mit mehreren Notensystemen wie Klavier und Orgel sowie große Partituren mit vielen Systemen werden zuverlässiger erkannt.
• Breite Seiten, Querformat und Booklet-Layouts. Seiten im Querformat werden links nicht mehr abgeschnitten (wodurch Schlüssel verloren gehen konnten), und mehrseitige sowie Booklet-Scans werden korrekt verarbeitet.
• Weniger Streuerkennungen. Irrelevante Elemente in der Nähe von Fußzeilen und Seitenrändern werden nicht mehr als Musik erkannt.

Das Stimmgerät in Flat for Education wurde rund um die Instrumente neu aufgebaut, die Ihre Schülerinnen und Schüler spielen.

• Instrumentenvoreinstellungen. Wählen Sie Gitarre, Bass, Ukulele, Mandoline und mehr, darunter 7- und 8-saitige Gitarren, Bariton-Ukulele, 5-saitigen Bass und Mandola, und das Stimmgerät zeigt jede zu stimmende Saite an. Der Modus für freie Tonhöhe heißt jetzt Chromatisch.
• Alternative Stimmungen. Drop-D-, Open-Tunings und andere gängige Alternativen sind für alle Bundinstrumente verfügbar, nicht nur für Gitarre.
• Referenztöne. Spielen Sie die Tonhöhe einer Saite ab und stimmen Sie nach Gehör.
• Kalibrierung und präzise Anzeige. Stellen Sie die Referenztonhöhe auf einen anderen Wert als A = 440 Hz, wenn ein Ensemble das benötigt, und lesen Sie die Abweichung in Cent neben der erkannten Frequenz ab. Die neu gestaltete Anzeige hält den Zielton fest und bewegt den Zeiger, und ein Verlauf zeigt die zuletzt gespielten Töne an.
• Im Editor. Das Stimmgerät lässt sich auch über die Werkzeugleiste des Editors öffnen und wählt das Instrument der aktuellen Stimme vorab aus.

Sie finden es unter Werkzeuge neben Metronom und Tongenerator, oder lesen Sie den Leitfaden zu den Übungswerkzeugen.

Alle PDF- und Fotoimporte werden jetzt mit Flats eigenem, intern entwickelten Modell verarbeitet. Diese Veröffentlichung ist eine wichtige neue Version mit Fokus auf die Genauigkeit der Transkription: Die musikalische Korrektheit (Noten, Rhythmen, Haltebögen und Vorzeichen, die darüber entscheiden, ob eine Partitur stimmt) verbessert sich in allen Testsätzen, mit den größten Fortschritten bei:

• Dynamikangaben: +39 %
• Fermaten, Artikulationszeichen, Haltebögen, Vorzeichen: +30 bis 37 %
• Notendauern: +22 %
• Phrasierungsbögen, punktierten Noten, Pausen, System- und Stimmenzuordnung: +14 bis 20 %

Auch die Platzierung von Text, Dynamikangaben und Layout ist präziser: Liedtext, Akkordsymbole und Dynamikangaben werden zuverlässiger den richtigen Noten zugeordnet, auch in komplexen Layouts wie Klaviernoten mit Akkolade und Stimmen mit Schlüsselwechseln.

Wir führen Flats eigenes KI-Modell für den Import von PDFs und Fotos ein. Es wurde intern entwickelt und trainiert, um die beim Start verwendete Drittanbieter-Engine zu ersetzen. Wenn wir die Technologie vollständig selbst kontrollieren, können wir die Genauigkeit weiter verbessern, den Umfang der Erkennung erweitern, Verbesserungen deutlich schneller bereitstellen und die Ergebnisse an Flats eigenes Notationsformat anpassen, damit sich Importe nahtlos in den Rest des Produkts einfügen. Diese erste Version liest bereits deutlich mehr Ihrer Musik:

Breitere Notationsabdeckung. Neu erkannt werden:

• Akkordsymbole, korrekt mit ihrer musikalischen Bedeutung als bearbeitbare Akkorde kodiert und nicht nur als einfacher Text
• Taktwiederholungen und Rhythmus-Slashes
• Tempo- und Metronomangaben (mit BPM)

Liedtext und Text in mehr Sprachen. Liedtext, Probebuchstaben und anderer Text werden standardmäßig in Sprachen mit lateinischer Schrift sowie in Japanisch, Koreanisch und Chinesisch erkannt.

Näher am ursprünglichen Layout. Importe folgen jetzt dem Layout der Ausgangspartitur deutlich genauer und übernehmen die Anzahl der Takte pro Zeile, der Systeme pro Seite und die Gesamtstruktur. Das macht sich besonders bei großen, komplexen Partituren wie Orchesterwerken und bei Instrumenten mit mehreren Systemen wie Klavier bemerkbar. Außerdem werden mehr Seitenformate unterstützt, darunter Querformatseiten, die zuvor nicht unterstützt wurden.

Das größte Spezifikationsupdate seit 2024, das die API an zwei Jahre Produktänderungen anpasst.

• Import aus mehr als 15 Formaten. Guitar Pro, MuseScore, ABC-Notation, PowerTab, Capella, MEI, Overture, TablEdit, Band-in-a-Box, Karaoke MIDI, MuseData, Score Writer, Bagpipe Music Writer und Encore ergänzen MusicXML und MIDI, und Partituren können als native .flat-Dateien exportiert werden.
• Virtuelle Sammlungen. Alle Partituren, Kollaborationen und „Gefällt mir“-Angaben ersetzen die bisherige Ordnerhierarchie in der Bibliothek und entsprechen damit der neu gestalteten Flat-Bibliothek.
• Flat for Education. Performance-Aufgaben mit Audio- oder Videoaufnahmen sowie Optionen für Backingtrack, Metronom und Tempo; Gruppeneinreichungen für gemeinsames Schreiben; Anweisungen mit Rich-Text; Schüleruntergruppen; geplante und individuell zugewiesene Microsoft Teams-Aufgaben; ausführliche Beschreibungen und Aufgabentypen in der Ressourcenbibliothek.
• Einheitliche LTI-Konfiguration für LTI 1.1 und 1.3, einschließlich dynamischer Registrierung. Die bisherigen Anmeldedaten-Aufrufe für LTI 1.1 sind veraltet.
• Jährliche Statistiken zu Partituren, Anzahl öffentlicher Partituren auf Profilen und die Entfernung einiger seit Langem veralteter Felder.