# Earnote – Roadmap > Stand: 22.09.2026 (0.9.13) · gepflegt vom Architekten · Versionen sind Arbeitsstände, öffentlich wird erst 1.0. > Beta läuft: [Releases](https://github.com/louiskl/Earnote/releases) · [Anleitung für Tester](BETA.md) > Leitlinien: [DESIGN_GUIDELINES.md](DESIGN_GUIDELINES.md) · Aufbau: [ARCHITECTURE.md](ARCHITECTURE.md) **Ziel von 1.0:** Eine ausgereifte, native Mac-App, mit der Studierende ohne Technik-Kenntnisse und ohne KI-Abo Vorlesungen, Meetings und Calls mitschreiben lassen – kostenlos, privat, lokal. ## Überblick | Phase | Inhalt | Version | Status | |---|---|---|---| | 0 | Fundament: Code gesichert, Umbenennung Earmark → Earnote, Datenübernahme | 0.2.0 | ✅ fertig | | 1a | Kern herauslösen: `EarnoteKit` (Core + ML), `AppState` zerlegt, schnelle Tests, iOS-Build-Beweis | 0.3.0 | ✅ fertig | | 1b | Datenmodell: SwiftData, iCloud-tauglich, macOS 15, Speicher aufgeteilt | 0.4.0 | ✅ fertig | | 1c | Aufnahme robust + Mikrofon auswählen | 0.5.0 | ✅ fertig | | 2a | Neues natives Hauptfenster (Seitenleiste, Liste, Notiz, Inspector, Toolbar, Befehle, Suche, Teilen) | 0.6.0 | ✅ fertig | | 2b | Farbe zurück, Aufnahme-Bühne, Menüleiste, Call-Banner, signierte und notarisierte Version | 0.7.0 | ✅ fertig | | 2c | Einstellungen und Einrichtungsassistent nativ, altes Design-System entfernt | 0.7.1 | ✅ fertig | | 3a–3g | Notiz bearbeiten, Begriffe korrigieren & Wörterbuch, PDF-Lernzettel, Suche im Transkript, saubere Transkripte, Export je Ziel | 0.7.2–0.7.5 | ✅ fertig | | 3h | Schneller fertig: Transkription läuft schon während der Aufnahme | 0.8.0 | ✅ fertig | | 4a | Härtefälle, öffentliches Repository, Beta-Auslieferung, Sprecherlabels nur bei Calls | 0.8.1–0.8.5 | ✅ fertig | | 4b | Reif für andere: Player, englische Oberfläche, Nebeneinander, Suche, Kürzel, Kalender | 0.9.0–0.9.2 | ✅ fertig | | 4c | Lernhilfen, Aufgaben-Ziele, Modellwahl, Vorverdichten, Review, Swift 6 | 0.9.3 | ✅ fertig | | 4d | Feinschliff: Hilfe-Menü, Speicher aufräumen, ⌘G in der Notiz, Fassade entfernt, letzte Notizen in der Menüleiste | 0.9.6 | ✅ fertig | | 4e | Stabilität: vier Abstürze, Tonverlust, iCloud-Schema, Wächter gegen stummes Scheitern | 0.9.7–0.9.13 | ✅ fertig | | **Beta** | **Zwei Wochen mit Kommilitonen, danach 1.0** | 0.9.12 | ▶ **läuft** | | 5 | Launch: Website, Demo-Video, Homebrew, Beta mit Kommilitonen, Markenrecherche | 1.0 RC | geplant | | 🚀 | **Launch Earnote 1.0 für Mac** | 1.0 | | | 6 | iPad eigenständig, iPhone als Begleit-App, iCloud-Sync | 1.1 | nach Launch | | 7 | Mac App Store prüfen (Sandbox), Kurs-Gruppen teilen | 1.2 | nach Launch | --- ## ✅ Phase 0 – Fundament (0.2.0) - Stand gesichert, Git-Historie sauber, Tag `v0.1.1-earmark-final` - Name zentral in `AppInfo`, Bundle-ID `app.earnote.Earnote` - Einmalige Datenübernahme aus „Earmark“ (Ordner, Einstellungen, Schlüsselbund) - Fehler behoben: importierte Audiodateien, vertauschtes Whisper-Modell, Wiederholungsschleifen ## ✅ Phase 1a – Kern herauslösen (0.3.0) - Lokales Package `EarnoteKit`: `EarnoteCore` (ohne Oberfläche, läuft auf dem iPad) und `EarnoteML` (Whisper, MLX) - `AppState` zerlegt in `LibraryStore`, `RecordingController`, `ProcessingQueue`, `ProcessingPipeline`, `AppEnvironment` - Kern-Tests in Sekunden statt Minuten; Absturz bei völlig stiller Aufnahme behoben ## ✅ Phase 1b – Datenmodell (0.4.0) - SwiftData-Schema V1, CloudKit-kompatibel (Sync noch aus) - Transkript als ein Block pro Aufnahme, Notiz mit KI-Original, Wörterbuch-Modell vorbereitet - Audio bleibt lokal (`AudioStore`), Bibliothek im `LibraryRepository` - Bereich löschen lässt Aufnahmen stehen; Mindestversion macOS 15 --- ## ✅ Phase 1c – Aufnahme robust + Mikrofon auswählen (0.5.0) Anlass: Das USB-Mikrofon der Webcam hing, jede Aufnahme brach mit „avfaudio-Fehler 35“ ab. - [x] Mikrofon in den Einstellungen und im Menüleisten-Menü auswählen („Systemstandard“ oder ein bestimmtes Gerät) - [x] Gewähltes Gerät fehlt oder reagiert nicht → automatisch auf ein funktionierendes Mikrofon ausweichen und das verständlich sagen - [x] Ein Wiederholungsversuch beim Start, sauberes Aufräumen auch beim Stopp aus der Pause - [ ] Aufnahme während eines laufenden Teams-/Zoom-Calls zuverlässig (vom Nutzer noch zu testen) - [x] Verständliche Fehlermeldungen ohne Fehlernummern; Diagnose im Log - [x] Sicherheitsregeln für Tests mit echten Daten in `CLAUDE.md` ## ✅ Phase 2a/2b – Natives Mac-Hauptfenster (0.6, 0.7) - [x] Stabiles Gerüst: `NavigationSplitView` (Seitenleiste → Aufnahmeliste → Notiz) + **Inspector** - [x] Seitenleiste als echte Source List: Bibliothek (Alle, Offene Aufgaben, Probleme, Ohne Bereich) und Bereiche - [x] Aufnahmeliste kompakt, Detail zeigt Notiz und Transkript, Inspector zeigt Bereich, Datum, Dauer, Quelle, Modell, Export-Status - [x] Echte **Toolbar** (Aufnehmen/Stopp, Pause, Teilen, Inspector), **Menübefehle** und **Tastenkürzel**, Kontextmenüs - [x] `.searchable` über Titel, Notizen und Transkripte - [x] Views lesen direkt per `@Query`; `LibraryStore` schreibt nur noch - [x] **Fassade `AppState` entfernt (0.9.5)**: Menüleisten-Symbol liest `LibraryStore` und `RecordingController` direkt, der Call-Hinweis bekommt nur noch eine Funktion zum Starten. 104 Zeilen Weiterreichen weniger. - [x] Auswahl als Fensterzustand; mehrere Fenster möglich - [x] Einstellungen als native `Form`; Einrichtungsassistent überarbeitet - [x] Menüleisten-App und Call-Pop-up aufgeräumt (Call-Hinweis zuletzt in 0.9.3) - [x] Eigenes Design-System, Karten und Verläufe entfernt (übrig: `Support/Brand.swift`) - [x] Leer-, Lade- und Fehlerzustände; schmale und breite Fenster; Dark Mode; Tastaturbedienung - [x] Anti-Vibecoding-Review (Guidelines Abschnitt 28) – zuletzt in 0.9.3 ## ✅ Phase 2c – Einstellungen und Assistent nativ (0.7.1) - [x] Einstellungen als Szene mit sieben Tabs, jeder ein `Form` mit `.formStyle(.grouped)`; neuer Tab „Aufnahme“ - [x] Einrichtungsassistent: fünf Schritte, Kopfzeile, Inhalt, Knopfzeile – ohne Verläufe, Kacheln und eigene Knopfstile - [x] Ziele-Schritt aus dem Assistenten entfernt (Export ist optional und steckt in den Einstellungen) - [x] Whisper-Vorbereitung sichtbar: „Für diesen Mac vorbereiten“ (läuft nach dem Download automatisch), Status „Bereit“ - [x] Bereichs-Editor als `Form`; Vorlagen-Auswahl als Häkchenliste - [x] Altes Design-System gelöscht (`DesignSystem.swift`, `Components.swift`, `Views/Legacy/`), übrig: `Support/Brand.swift` - [x] Einstellungen und Assistent lesen `LibraryStore`/`RecordingController` direkt; `AppState` nur noch in Menüleiste und Call-Hinweis - [ ] Vom Nutzer zu prüfen: erster Durchlauf des Assistenten, Whisper-Vorbereitung auf dem eigenen Mac ## Phase 3 – Funktionen für 1.0 (0.7–0.8) **3a Notiz bearbeiten (0.7.2, Fehler behoben in 0.7.3)** - [x] Notiz direkt bearbeiten (⌘E), Titel über die Liste ändern, „Auf KI-Fassung zurücksetzen“ - [x] „Neu zusammenfassen …“ mit anderem Bereich, zusätzlicher Anweisung und wahlweise neuem Transkript **3b Namen & Begriffe korrigieren + Wörterbuch (0.7.2)** - [x] „Namen & Begriffe korrigieren“: eine Ersetzung gilt in Titel, Notiz und Transkript - [x] Wörterbuch pro Bereich und global (Einstellungen › Wörterbuch), Korrekturen wandern auf Wunsch hinein - [x] Wörterbuch als Kontext für Whisper (Prompt) und für die KI – Fehler entstehen gar nicht erst - [ ] Vom Nutzer zu prüfen: Wirkt der Whisper-Prompt bei echten Vorlesungen? (Apple-Spracherkennung kennt keine Begriffsliste) **3c PDF & Teilen (0.7.3)** - [x] Sauberes PDF im Lernzettel-Layout („Als PDF sichern …“), mehrseitig - [x] Drucken (⌘P) über den Druckdialog von macOS - [x] Teilen über das macOS-Teilen-Menü (Notiz als Text in der Toolbar; PDF nach dem Sichern aus dem Finder) **3d Suche (0.7.4)** - [x] Volltextsuche in Transkripten: Fundstellen hervorgehoben, Sprung zur ersten Stelle, Anzahl der Treffer - [x] Fundstellen auch in der Notiz hervorgehoben **3e Transkript-Qualität (0.7.4)** - [x] Erfundene Sätze bei Stille filtern: Abspann-Floskeln immer, Höflichkeitsfloskeln nur allein in einer Pause - [x] „Keine Sprache erkannt“ statt Fantasie-Notiz (unter drei gesprochenen Wörtern wird nichts zusammengefasst) - [x] Sprachaktivität vor der Transkription: Ist fast durchgehend Stille, läuft Whisper gar nicht erst - [ ] Vom Nutzer zu prüfen: Verschwinden die erfundenen Sätze bei echten Aufnahmen – und bleibt echter Inhalt stehen? **3f Erster Start ohne Wartefalle (0.7.2 und 0.7.5)** - [x] Whisper-Modell direkt nach dem Download für den Chip vorbereiten (einmalig, mehrere Minuten) - [x] Klare Anzeige im Assistenten („Läuft noch im Hintergrund“), im Hauptfenster und in der Menüleiste, solange geladen oder vorbereitet wird **3h Schneller fertig (0.8.0)** - [x] Transkribieren läuft schon während der Aufnahme (abschnittsweise, Schnitt am letzten fertigen Satz) - [x] Nach dem Stopp bleibt nur der letzte Abschnitt – die Warteschlange schreibt direkt die Notiz - [x] Schalter „Schon während der Aufnahme transkribieren“ (Einstellungen › Aufnahme) - [x] Hinweis während der Verarbeitung: zugeklappter Mac schläft und pausiert sie - [ ] Vom Nutzer zu prüfen: Wie viel schneller ist eine 90-Minuten-Vorlesung wirklich fertig? - [x] faster-whisper geprüft und verworfen: CTranslate2 hat kein Metal-Backend und liefe auf dem Mac nur auf der CPU – langsamer als WhisperKit, dazu mit Python-Abhängigkeit **3g Export (0.7.5)** - [x] Export-Status pro Ziel im Inspector – auch für Ziele, in die noch nie exportiert wurde - [x] Einzelnes Ziel erneut exportieren („Erneut“), erfolgreiche Exporte bleiben stehen - [x] Hinweis mit „Einrichten …“, wenn ein Ziel eingeschaltet, aber nicht fertig eingerichtet ist - [x] Nebenbei: Einstellungen einer älteren Version verlieren keine Ziele mehr (fehlende Felder bekommen Standardwerte) ## ✅ Phase 4a – Härtefälle und Beta-Auslieferung (0.8.1–0.8.5) - [x] Festplatte voll: unter 300 MB startet keine Aufnahme, unter 1,5 GB Hinweis mit Restlaufzeit, beim Vollaufen wird sauber beendet statt abgebrochen - [x] Mac schläft ein (Deckel zu): Aufnahme wird beendet und gespeichert; während der Verarbeitung weist eine Zeile darauf hin, dass ein zugeklappter Mac die Verarbeitung pausiert - [x] Kein Ton seit einer Minute → Hinweis mit nächstem Schritt, statt einer stummen Aufnahme am Ende - [x] Whisper-Download abbrechbar, halb geladene Modelle werden entfernt - [x] Öffentliches Repository (MIT), Kern-Tests in der CI, Kurzanleitung für Beta-Tester - [x] „Fehler melden“ als vorausgefülltes GitHub-Issue, „Diagnose kopieren“, Protokoll zeigen - [x] Update-Hinweis (tägliche Abfrage der GitHub-Releases, abschaltbar) und `docs/DATENSCHUTZ.md` - [x] Zeiten im Protokoll: Transkription mit Echtzeit-Faktor, Notiz, Ladezeit des lokalen Modells - [x] Sprecherlabels nur noch bei echten Calls (an echten Vorlesungen nachgewiesen fehlerhaft) - [ ] Gerät gewechselt und Berechtigung entzogen am echten Mac durchspielen **Gemessen an zwei echten Vorlesungen (M1 Air, 16 GB):** Whisper large-v3-turbo transkribiert mit **≈ 12× Echtzeit** (60 Min. Ton in 5 Min.), die Notiz der lokalen KI braucht 6–7 Minuten. Die gefühlte Stunde Wartezeit kam vom zugeklappten Deckel, nicht von der Rechenleistung. ## ✅ Phase 4b – Reif für andere (0.9.0–0.9.2) Ziel: Was eine fremde Person in der ersten Woche braucht, ohne zu fragen. **Anhören und finden** - [x] **Audio-Player (0.9.0)**: schmale Leiste unter Notiz und Transkript (Pause, ±15 Sekunden, Position), jede Zeitmarke in Transkript und Notiz springt an ihre Stelle, der laufende Absatz wird hervorgehoben, Bedienung auch über das Menü „Aufnahme“ (⌥Leertaste, ⌥←, ⌥→) - [x] **Notiz und Transkript nebeneinander (0.9.2)**: dritte Ansicht „Beides“ (⌘3) als natives `HSplitView`; ein Klick auf eine Zeitmarke in der Notiz spielt die Stelle, das Transkript scrollt mit - [x] **Vorwärts/rückwärts durch die Fundstellen (0.9.2)**: ⌘G und ⇧⌘G blättern im Transkript, die Kopfzeile zählt mit („Fundstelle 3 von 12“) **Für alle verständlich** - [x] **Englische Oberfläche (0.9.1)**: Deutsch steht im Quelltext und bleibt Standard, Englisch liegt als `en.lproj/Localizable.strings` daneben – 316 Texte der App und 79 aus dem Kern (Status, Fehlermeldungen, Vorlagen, Ziele). Der Projektgenerator bindet jede weitere Sprache automatisch ein. - [x] **Erster Start ohne Internet (0.9.2)**: vor jedem Modell-Download wird geprüft, ob überhaupt ein Netz da ist – sonst steht sofort „Keine Internetverbindung“ mit „Erneut laden“ statt eines stummen Wartens - [x] Anti-Vibecoding-Review über alle neuen Ansichten (Guidelines Abschnitt 28) – siehe Phase 4c **Alltag** - [x] **Kalender-Anbindung (0.9.2)**: Läuft ein Termin, heißt die Aufnahme wie er (Einstellungen › Aufnahme, fragt beim Einschalten nach Zugriff). **Kalender einzeln wählbar** – der Arbeitskalender bleibt draußen, Uni und Outlook zählen. Ganztägige, abgesagte, beendete und sehr lange Termine („Arbeit 9–17 Uhr“, über vier Stunden) zählen nicht; bei mehreren gewinnt der kürzeste. Vor dem Start steht der gefundene Titel im Fenster der Menüleiste und in den Einstellungen. - [ ] Kalender später: Teilnehmende als Sprecher-Hinweis, Termin-Notizen als Kontext für die KI - [x] **Globales Tastenkürzel (0.9.2)**: ⌃⌥⌘R startet und stoppt die Aufnahme aus jeder App heraus (fest vergeben, abschaltbar in Einstellungen › Aufnahme; belegt eine andere App dasselbe Kürzel, steht das im Protokoll) - [x] Aufnahme aus der Menüleiste mit Bereichswahl: die Bereiche stehen als Liste im Menüleisten-Fenster, ein Klick wählt, der nächste nimmt auf --- ## Phase 4c – Letzter Schliff vor 1.0 (0.9.3) **Zielgruppen schärfen** - [x] **Karteikarten (0.9.3)**: Die KI schreibt Frage-Antwort-Karten als Abschnitt in die Notiz („Frage :: Antwort“), dadurch im Editor änderbar und ohne eigenes Datenmodell. „Karteikarten sichern (Anki) …“ schreibt eine CSV, die Anki direkt importiert. - [x] **Aufgaben nach Apple Erinnerungen, Things und Todoist (0.9.3)**: je Bereich eine eigene Liste bzw. ein Projekt; Structured liest die Erinnerungslisten mit, eine eigene Anbindung braucht es nicht. - [x] **Logseq (0.9.3)**: Seite im Graphen als Aufzählung mit Eigenschaften und TODO-Blöcken - [x] **Semester-Zusammenfassung (0.9.3)**: Rechtsklick auf einen Bereich › „Übersicht erstellen …“ – Zeitraum wählen (Monat, drei, sechs Monate, alles), optional eine eigene Anweisung. Die KI liest die fertigen Notizen und schreibt Überblick, Themen, roten Faden, Prüfungshinweise und offene Aufgaben. Die Übersicht landet als eigener Eintrag im Bereich – lesbar, druckbar, exportierbar. - [x] **Formeln bleiben stehen (0.9.3)**: Ein einzelnes Sternchen ist in Markdown ein Kursiv-Zeichen – aus „A*v = λ*v“ wurde beim Anzeigen „Av = λv“. Jetzt wird es geschützt (fett und Code bleiben unberührt), und die KI wird angewiesen, Formeln in Code-Zeichen zu setzen. - [x] **Kurzprotokoll (0.9.3)**: „Kurzprotokoll kopieren“ und „Kurzprotokoll als Mail …“ – Titel, Kurzfassung, Ergebnisse und Aufgaben, ohne Themenblöcke und Transkript. - [x] **Einfach erklärt (0.9.3)**: Schalter in Einstellungen › KI – kurze Sätze, alltägliche Wörter, Fachbegriffe werden beim ersten Mal erklärt - [x] **Als Mail weiterschicken (0.9.3)**: öffnet einen Mail-Entwurf mit Titel und Notiz (geschickt wird nichts) - [x] **Schule**: kleinere Modelle für ältere Macs – Qwen3 1.7B (1 GB) steht in der Modellauswahl **Qualität und Modelle** - [x] **Modellauswahl (0.9.3)**: sechs lokale Modelle von Qwen3 1.7B (1 GB, alte Macs) bis Qwen3 30B A3B (17 GB, ab 32 GB RAM), dazu Gemma 3 in zwei Größen. Jedes Modell zeigt Größe, Speicherbedarf und wofür es taugt; Modelle, die nicht in den Speicher passen, sind als solche gekennzeichnet statt versteckt. - [x] **Automatische Wahl nach Gerät (0.9.3)**: „Automatisch“ nimmt, was zum Arbeitsspeicher passt (bis 16 GB Qwen3 4B, darüber Qwen2.5 7B). Ein bereits geladenes Modell geht der Empfehlung vor – ein Update zwingt niemanden zu einem neuen Download. - [ ] Modellvergleich an echten Vorlesungen: Lernzettel der Modelle nebeneinander bewerten - [x] **Vorverdichten während der Aufnahme (0.9.3)**: Sobald wieder ein Block von ~20 000 Zeichen (grob 25 Minuten) transkribiert ist, verdichtet die KI ihn schon zu Arbeitsnotizen. Nach dem Stopp bleibt nur der Rest plus die eigentliche Notiz. Läuft nur auf Macs ab 16 GB (sonst liegen Whisper und Sprachmodell gleichzeitig im Speicher) und nur, wenn „Schon während der Aufnahme transkribieren“ an ist. Schlägt es fehl, wird nach dem Stopp normal verdichtet – ohne dass jemand etwas merkt. - [x] **3-Stunden-Vorlesung Ende-zu-Ende bestanden** (21.09.2026, vom Nutzer gefahren): keine Abstürze, Verarbeitung durchgelaufen - [x] **Swift-6-Sprachmodus (0.9.3)** für Kern, ML und App. WhisperKit bleibt jetzt im Actor, statt das nicht-sendable Modell herauszureichen. - [x] **Datenübernahme aus „Earmark“ entfernt (0.9.3)** – sie hat ihren Zweck erfüllt; rund 400 Zeilen weniger, die niemand mehr braucht. Wer noch einen Earmark-Ordner hat, muss vor dem Update auf 0.9.3 einmal eine ältere Version starten. --- ## Wann ist die Mac-App fertig? (Abnahme für 1.0) Nicht „wenn nichts mehr einfällt“, sondern wenn diese Punkte abgehakt sind: **Funktion** - [x] Phase 4c abgeschlossen (Lernhilfen, Aufgaben nach Erinnerungen, Modellwahl, Vorverdichten) - [x] **Anti-Vibecoding-Review (0.9.3)**: Call-Hinweis auf Systemtypografie und -material umgestellt, Farbverlauf am Knopf entfernt, Sonderschrift der Laufzeit ersetzt, Blätter vereinheitlicht, lange Menüs in Untermenüs („Karteikarten“, „Weitergeben“) gegliedert. **Belastbarkeit** – an echten Daten nachgewiesen, nicht nur im Test - [x] **3-Stunden-Vorlesung Ende-zu-Ende bestanden** (21.09.2026, vom Nutzer gefahren): keine Abstürze, Verarbeitung durchgelaufen - [x] Teams- und Zoom-Calls am echten Mac aufgenommen (Systemton, Call-Erkennung) – vom Nutzer bestätigt - [x] **Gerät gewechselt (0.9.12)**: zwölf Wechsel unter laufender Aufnahme am echten Mac, Datei wächst durch - [ ] Rest der Härtefälle am echten Mac: Berechtigung entzogen, Platte voll, Deckel zu - [ ] Zwei Wochen Beta mit 5–10 Kommilitonen ohne Datenverlust und ohne Absturz - [x] Swift-6-Sprachmodus an, `LegacyMigration` entfernt **Drumherum** - [x] Screenshots hell/dunkel in beiden Sprachen (Website, Stand 0.9.3) und Homebrew-Tap - [ ] Demo-Video - [ ] Markenrecherche Earnote abgeschlossen (liegt beim Nutzer) Erst wenn alle drei Blöcke stehen, wird aus 0.9.x die 1.0 – und erst danach beginnt Phase 6. --- --- ## Phase 4d – Feinschliff nach der Beta-Auslieferung (0.9.5) - [x] **Hilfe-Menü**: Apples Platzhalter „Earnote-Hilfe“ führte ins Leere. Jetzt: Projektseite, Anleitung für Tester, Fehler melden, Datenschutz, Quelltext. - [x] **Speicher aufräumen**: Einstellungen › Allgemein zeigt, wie viel die Audiodateien belegen, und löscht auf Wunsch den Ton alter Aufnahmen (älter als ein Monat, drei Monate oder alles). Notizen und Transkripte bleiben. Ein Semester Vorlesungen sind sonst schnell 30 GB. - [x] **Notiz-Fundstellen mit ⌘G**: Die Suche blättert jetzt auch durch die Notiz, nicht nur durch das Transkript. Stehen beide nebeneinander, führt das Transkript den Zähler. - [x] **Letzte Notizen in der Menüleiste (0.9.6)**: Das Menüleisten-Fenster zeigt die drei neuesten Aufnahmen; ein Klick öffnet sie im Hauptfenster. Die README versprach das seit Monaten. - [x] **Fassade `AppState` aufgelöst**: siehe Phase 2a/2b ## ✅ Phase 4e – Stabilität (0.9.7–0.9.12) Alles aus echten Abstürzen des Nutzers, nicht aus Tests. Jeder Punkt wurde am Gerät nachgeprüft. - [x] **Absturz im Mikrofontest (0.9.7)**: Der Pegel-Block der Einstellungen erbte die MainActor-Isolation. Core Audio ruft ihn auf seinem eigenen Thread auf, und Swift 6 bricht dort ab. `@Sendable` macht ihn isolationsfrei. - [x] **Absturz beim Aufnahmestart (0.9.9)**: `installTap` las das Eingangsformat erneut, ohne es zu prüfen. Fiel das Gerät dazwischen weg, warf AVFoundation eine Obj-C-Ausnahme, die Swift nicht fangen kann. - [x] **Absturz beim Gerätewechsel im Call (0.9.11)**: Der Neustart lief mitten in der `AVAudioEngineConfigurationChange`-Meldung, die die Engine aus ihrem eigenen Thread verschickt, während sie ihre Sperren hält. Jetzt um 0,6 s aufgeschoben – das fasst zugleich die Meldungsflut zusammen, mit der Bluetooth-Kopfhörer beim Profilwechsel um sich werfen. - [x] **Tonverlust beim Mikrofonwechsel (0.9.12)** – der schwerste Fehler des Tages: Der Tap wurde mit dem Format angebracht, das `outputFormat(forBus:)` meldete. Nach einem Gerätewechsel ist das noch das Format des **alten** Geräts, und der Tap liefert danach stumm gar nichts mehr. Die Aufnahme lief weiter, die Datei wuchs nicht. Gemessen: zwölf Gerätewechsel unter laufender Aufnahme – vorher blieb die Datei bei 59,7 s stehen, jetzt wächst sie um 30 von 35 Sekunden weiter. - [x] **Unruhiges Gerät wird getauscht (0.9.12)**: Wer sich dreimal in einer Minute neu meldet, verliert jedes Mal gut eine Sekunde Ton. Earnote weicht dann auf ein stabiles Mikrofon aus und sagt es. - [x] **iCloud-Schema vollständig (0.9.10)**: Production kannte `CD_editedAt` auf `CD_LibraryNote` nicht, weil das Schema nebenbei beim Hochladen echter Daten entstand. CloudKit lehnte dadurch **jeden** Export ab (CKError 12/2006). `CloudSchemaSetup` legt über `initializeCloudKitSchema` jeden Typ mit jedem Feld an; seit dem erneuten Deploy läuft der Abgleich. - [x] **Standard-Bereich „Ohne Bereich“ (0.9.8)**: Aufnahmen müssen nicht mehr in einem Bereich landen – neu ist das die Voreinstellung. **Vorbeugend statt reaktiv (0.9.13)** – damit diese Fehlerklassen nicht wiederkommen: - [x] **Obj-C-Ausnahmen werden abgefangen**: AVFoundation meldet Audiofehler als `NSException`, und jede ungefangene beendet die App sofort – drei der vier Abstürze waren genau das. `AudioExceptions.m` macht daraus einen normalen Fehler, den der Ersatzgerät-Weg auffängt. Mit Test abgesichert. - [x] **Wächter auf den Datenfluss**: Der bisherige Wächter sah auf den *Pegel* – der bleibt aber beim letzten Wert stehen, wenn gar nichts mehr ankommt. Jetzt zählt, wann zuletzt wirklich ein Puffer eintraf; zehn Sekunden Funkstille melden sich sofort statt gar nicht. - [x] **Hinweis bei Telefonqualität**: Bluetooth-Kopfhörer fallen auf 16–24 kHz, sobald sie gleichzeitig Ton ausgeben. Earnote sagt das einmal je Aufnahme und nennt den besseren Weg. ## Phase 5 – Launch (1.0 RC → 1.0) **Name & Recht** (liegt beim Nutzer) - [ ] Markenrecherche Earnote (DPMA, EUIPO, USPTO; Klassen 9 und 42) - [ ] Domain sichern (earnote.app o. ä.), Instagram-/TikTok-Namen sichern - [x] Impressum und Datenschutzhinweis für die Website (`docs/impressum.html`, verlinkt aus beiden Sprachen) **Website** (Hauptweg zum Download) - [x] **Steht: [earnote.dev](https://earnote.dev/)** – statisch über GitHub Pages aus `docs/`, zweisprachig (`index.html` englisch, `de.html` deutsch), ohne Framework und ohne Tracking - [x] Inhalt: Was es macht · Screenshot in der jeweiligen Sprache · Download-Knopf auf das neueste Release · „bleibt auf deinem Mac“ · Voraussetzungen · FAQ · Link zu GitHub - [x] **Impressum nach § 5 TMG** als eigene Seite (`impressum.html`), aus beiden Sprachen verlinkt - [ ] Demo-Video (30–60 s): aufnehmen, Notiz erscheint, Lernzettel als PDF – für Website, Product Hunt, Social - [ ] Screenshots in Hell und Dunkel, deutsch und englisch **Verteilung** - [ ] **Direkt-Download** als Hauptweg: notarisierte DMG über GitHub Releases (läuft bereits) - [x] **Homebrew (0.9.3)**: eigener Tap [louiskl/homebrew-earnote](https://github.com/louiskl/homebrew-earnote) – `brew tap louiskl/earnote && brew trust louiskl/earnote && brew install --cask earnote`. Der offizielle `homebrew-cask` nimmt Selbsteinreichungen erst ab 225 Sternen (oder 90 Forks/Watchern) und einem mindestens 30 Tage alten Repository auf – das kommt später. - [x] **Automatische Updates (0.9.4)**: Sparkle 2.10 – einmal am Tag Appcast prüfen, Änderungen zeigen, auf Zuspruch installieren. Update-Datei EdDSA-signiert, `build_release.sh` erzeugt sie mit. - [ ] Eintragen: AlternativeTo, openalternative.co, awesome-mac, Product Hunt, Show HN, r/macapps, r/Studium - [ ] Hochschule: Fachschaften, Uni-Newsletter, Instagram/TikTok – die Zielgruppe sitzt dort, nicht auf HN **Beta** - [ ] 5–10 Kommilitonen, 1–2 Wochen, echte Vorlesungen ([Anleitung](BETA.md) liegt bereit) - [ ] Rückmeldungen einarbeiten, danach 1.0 ## Phase 6 – iPad & iPhone (1.1) **Warum erst nach 1.0:** iCloud-Sync und eine zweite Oberfläche verdoppeln die Fehlerfläche. Solange die Mac-App noch täglich wächst, würde jede Änderung zweimal anfallen. Der Kern (`EarnoteCore`) baut schon heute für iOS – das bleibt die Eintrittskarte, und der iOS-Build läuft bei jeder Änderung mit. **Reihenfolge, wenn es losgeht** 1. iCloud-Sync auf dem Mac einschalten und zwei Wochen allein damit laufen (Duplikate, Konflikte, Status) 2. iPhone als Begleit-App: nur aufnehmen und hochladen – kleiner Umfang, sofort nützlich 3. iPad eigenständig mit Whisper und lokalem Modell (M-Chip) - [x] **iCloud-Sync läuft (22.09.2026 nachgewiesen)**: Container, Berechtigungen und Profil stehen, das Schema ist in Production. Zwei Bibliotheken auf demselben Mac gleichen sich ab – eine leere Bibliothek bekam Aufnahme und Notiz aus der Cloud. Schalter bleibt vorerst als „in Erprobung“ gekennzeichnet und aus der Beta-Empfehlung heraus. - [x] **Sync-Status**: Einstellungen › Allgemein zeigt „Wird verbunden … / Gleicht ab … / Aktuell (Uhrzeit)“ bzw. den Fehlertext; jedes Ereignis steht auch im Protokoll. - [ ] Zwei Wochen Dauerlauf auf zwei Macs (Duplikate, Konflikte, Löschungen), danach Freigabe für alle - [ ] Duplikat-Bereinigung: gleiche Bereichsnamen von zwei Geräten zusammenführen - [ ] iOS-App-Target auf demselben Kern - [ ] **iPad eigenständig** (M-Chip): Whisper + lokales Modell auf dem Gerät, „Increased Memory Limit“ - [ ] **iPhone als Begleit-App**: nimmt auf, Mac verarbeitet, fertige Notiz wieder auf dem iPhone - [ ] Oberfläche für iPad und iPhone ## Phase 7 – Nach dem Launch (1.2) **Mac App Store prüfen** – erst nach 1.0, mit offenem Ausgang. Was dagegen spricht: - Die Sandbox verlangt für den Systemton (Core-Audio-Process-Tap) und für AppleScript zu Apple Notizen, Bear und Craft Ausnahmegenehmigungen, die im Review begründet werden müssen - Der Obsidian-Vault ist ein beliebiger Ordner: dafür bräuchte es „security-scoped bookmarks“ statt Pfaden - Updates außerhalb des Stores (Sparkle, eigene DMG) fallen weg; jede Fehlerbehebung wartet auf ein Review - Nutzen wäre Auffindbarkeit und Vertrauen – bei einer kostenlosen, quelloffenen App kein Geld **Kurs-Gruppen** - [ ] Bereich mit Kommilitonen teilen (iCloud-Freigabe, nur Apple-Geräte) ## Später / Ideen - Echte Sprechererkennung (Sprecher 1/2/3) statt „Ich / Andere“ - Weitere Ziele: Google Docs, OneNote, Anytype, Webhooks; Notion-Anmeldung ohne Token - Öffentlicher Link zum Teilen einer Notiz - Ältere iPads ohne M-Chip (über den Mac oder einen eigenen API-Schlüssel) - Echo-Unterdrückung bei Lautsprecher-Calls - Buy Me a Coffee / GitHub Sponsors, falls die App Zulauf bekommt --- ## Offene Entscheidungen | Frage | Empfehlung | Fällig bis | |---|---|---| | Launch-Termin | Beta ab sofort mit Kommilitonen, Launch Ende Oktober zum Semesterstart – nur wenn die Beta keine groben Fehler zeigt; sonst Anfang Januar vor der Klausurenphase | nach Phase 4c | | Start von iPad/iPhone | **Nach 1.0.** Vorher nur weiter darauf achten, dass der Kern iOS-tauglich bleibt (Build läuft mit) | nach 1.0 | | Mac App Store | **Vorerst nein.** Direkt-Download plus Homebrew deckt die Zielgruppe ab; die Sandbox würde Systemton und Export einschränken. Nach 1.0 neu bewerten | nach 1.0 | | ~~Englische Oberfläche~~ | erledigt in 0.9.1 | ✅ | | Sparkle (automatische Updates) | Erst bei nennenswerter Nutzerzahl; bis dahin reicht der Hinweis mit Download-Link | nach 1.0 | | Lokales Standardmodell | nach dem Modellvergleich mit echten Vorlesungen | Phase 4c | | Domain | erst nach der Markenrecherche kaufen | vor Phase 5 | ## Erledigte Entscheidungen (Auszug) Earnote als Name (vorbehaltlich Prüfung) · MIT & kostenlos · Zielgruppe Studierende · eigenständige Bibliothek, Export optional · WhisperKit + lokales MLX-Modell als Standard · native macOS-Oberfläche nach Design-Guidelines · SwiftData mit iCloud-tauglichem Schema · Audio wird nie synchronisiert · macOS 15 als Mindestversion · öffentliches GitHub-Repository unter `louiskl/Earnote` · Veröffentlichung als notarisierte DMG vom Mac aus, nicht über die CI (das Zertifikat bleibt lokal) --- ## iCloud-Sync einschalten – was noch fehlt Der Code ist vorbereitet (Schalter in Einstellungen › Allgemein, Container `iCloud.app.earnote.Earnote`, Rückfall auf den lokalen Speicher, wenn die Berechtigung fehlt). Was noch im Entwicklerportal passieren muss – das kann nur der Kontoinhaber: 1. **iCloud-Container anlegen**: `iCloud.app.earnote.Earnote` (Certificates, Identifiers & Profiles › Identifiers › iCloud Containers) 2. **App-ID `app.earnote.Earnote`** um die Fähigkeit **iCloud (CloudKit)** erweitern und den Container zuordnen 3. **Provisioning-Profil vom Typ „Developer ID“** mit dieser App-ID erzeugen, herunterladen und in `scripts/` ablegen; `build_release.sh` muss es als `embedded.provisionprofile` in die App kopieren 4. **Erledigt, sobald das Profil liegt:** `Earnote-iCloud.entitlements` und der Einbau des Profils in `build_release.sh` stehen schon – beides schaltet sich automatisch ein. 5. **CloudKit-Schema anlegen und nach Production übernehmen.** Eine mit Developer ID signierte App spricht die Production-Umgebung, dort lässt sich aber kein Schema anlegen. Deshalb einmalig: ```bash EARNOTE_ICLOUD_DEV_TEAM=KZJJ4FFKXJ python3 scripts/generate_xcodeproj.py open Earnote.xcodeproj # Schema: EARNOTE_INIT_CLOUD_SCHEMA=1 setzen, ⌘R – die App legt das # Schema an, schreibt es ins Protokoll und beendet sich python3 scripts/generate_xcodeproj.py # danach wieder auf den Normalfall zurück ``` Danach in der [CloudKit-Konsole](https://icloud.developer.apple.com/) den Container wählen und unter *Schema* → **Deploy Schema Changes** nach Production übernehmen. **Warum `EARNOTE_INIT_CLOUD_SCHEMA` und nicht einfach den Schalter anmachen:** Lässt man das Schema nebenbei beim Hochladen echter Daten entstehen, fehlen alle Felder, die dabei zufällig leer waren. Genau das ist am 22.09.2026 passiert – Production kannte `CD_editedAt` auf `CD_LibraryNote` nicht, und CloudKit lehnte **jeden** Export ab („Cannot create or modify field … in production schema“, CKError 12/2006). `CloudSchemaSetup` legt über `initializeCloudKitSchema` jeden Typ mit jedem Feld an. Nach jeder Schema-Änderung wiederholen. 6. Zwei Wochen allein auf zwei Macs laufen lassen (Duplikate, Konflikte, Löschungen), erst dann für Tester freigeben Ohne Schritt 1–4 bleibt der Schalter wirkungslos: Die App fällt beim Start auf den lokalen Speicher zurück und schreibt den Grund ins Protokoll. Ein Datenverlust kann dabei nicht entstehen.