Änderungsprotokoll

Das Entwickler-Dashboard wurde rund um die Möglichkeiten deiner Integration neu aufgebaut. Jede Funktion (Embed, OMR, REST API, Import API, LTI) erhält eine Karte mit Umfang, Preisen und Dokumentation, und die Funktionen, die deine App bereits nutzt, stehen an erster Stelle.

• Ein neuer OMR-Bereich auf Kontoebene mit deinen Jobs, deinen Credits und ihrem Verlauf an einem Ort, da OMR-Credits von all deinen Apps gemeinsam genutzt werden.
• Probiere OMR aus, bevor du Code schreibst. Der Playground nimmt eine PDF oder Fotos, zeigt die Seitenzahl, die Kosten pro Seite und das verbleibende Guthaben an und startet den Job nach deiner Bestätigung. Die Ausgabe geht in MusicXML-Downloads, nichts landet in deiner Bibliothek.
• Klarere App-Seiten. Persönliche Tokens, OAuth2-Zugangsdaten und OMR-Zugriff sind pro Anwendung gruppiert; die Zugangsdaten mit OMR-Umfang sind dabei klar gekennzeichnet.

Du findest es unter flat.io/developers.

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.

Flat gibt es jetzt auch als Desktop-App für macOS und Windows: den vollständigen Editor in einem eigenen Fenster, kostenlos zum Herunterladen, mit einer Bibliothek, die zwischen Desktop, Web und Mobilgeräten synchron bleibt.

• Funktioniert offline. Schreibe, bearbeite und spiele Partituren ohne Verbindung ab; deine Änderungen werden synchronisiert, sobald du wieder online bist.
• Deine Partituren auf jedem Gerät. Mit Flat Power ist die Bibliothek auf dem Desktop dieselbe, die du auch im Web, auf dem iPhone, iPad und Android öffnest.
• MIDI-Eingabe über USB und Bluetooth. Schließe ein Keyboard an und spiele die Noten ein.
• Öffnet deine Dateien. Doppelklicke in Finder oder Explorer auf eine Partitur, und sie wird in der App geöffnet, nicht in einem Browser-Tab.
• Mit Apple anmelden unter macOS, zusätzlich zu den Anmeldeoptionen, die du bereits hattest.
• Hält sich selbst auf dem neuesten Stand. Neue Versionen werden automatisch installiert.

Kostenlos zum Herunterladen; ein Flat-Konto wird nur für die Synchronisierung benötigt. Hol sie dir unter flat.io/desktop.

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.

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.

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.

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.

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.

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.