Eine lokale Anwendung für Transkripte, Workshop-Aufnahmen, Recaps, Entscheidungen und Aufgaben. Sie kann plattformübergreifend als Browser-Anwendung oder mit zusätzlichen Aufnahmefunktionen als macOS-Desktop-App betrieben werden.
Der bereinigte Entstehungsverlauf ist unter docs/CONVERSATION_HISTORY.md dokumentiert. Zugangsdaten und API-Key-Werte sind darin nicht enthalten.
| Funktion | Browser unter Windows, Linux und macOS | macOS-Desktop-App |
|---|---|---|
| Journal, Suche, Entscheidungen und Todos | Ja | Ja |
| Titel nachträglich bearbeiten und Inhalte kopieren | Ja | Ja |
| Transkript einfügen oder Datei importieren | Ja | Ja |
| OneDrive-Ordner überwachen | Ja | Ja |
| Teams-Transkripte über Microsoft Graph importieren | Ja | Browser-Modus empfohlen |
| Lokale oder optionale OpenAI-Zusammenfassung | Ja | Ja |
| Mikrofon und Systemaudio aufnehmen | Nein | Ja |
| Einzelnes Fenster auswählen und Screenshots aufnehmen | Nein | Ja |
| Lokale Whisper-Transkription und Recovery | Nein | Ja |
Die Browser-Anwendung bleibt die plattformübergreifende Journal- und Importvariante. Die Desktop-App ergänzt die Betriebssystemintegration, die ein normaler Browser nicht zuverlässig und sicher bereitstellen kann.
Voraussetzung ist Node.js 20 oder neuer. Danach:
npm install
npm startDas Journal ist anschließend ausschließlich lokal unter http://127.0.0.1:4173 erreichbar. Es wird nicht im Netzwerk veröffentlicht. Der Browser-Modus läuft unter Windows, Linux und macOS und benötigt weder Electron noch macOS.
Unter Linux setzt der native OneDrive-Ordnerdialog zenity voraus. Alternativ funktionieren das manuelle Einfügen und der Datei-Upload ohne diese Zusatzsoftware.
Zusätzliche Voraussetzungen:
- macOS 14.2 oder neuer für zuverlässige Systemaudioaufnahme
- der bereitgestellte Build ist für Apple Silicon
- einmalig etwa 574 MB freier Speicher für das Whisper-Modell
npm install
npm run desktopBeim ersten Öffnen einer Workshop-Aufnahme führt die App einen Preflight für Mikrofon, Fensteraufnahme, FFmpeg und Whisper durch. Das Transkriptionsmodell wird über Modell laden einmalig heruntergeladen und per SHA-256 geprüft.
macOS fragt beim ersten Einsatz nach:
- Mikrofon
- Bildschirm- und Systemaudioaufnahme
Nach einer nachträglichen Änderung unter Systemeinstellungen → Datenschutz & Sicherheit muss die App neu gestartet werden.
Für Speech-to-Text verwendet die Desktop-App Whisper Large v3 Turbo Q5_0 im whisper.cpp-Format:
| Eigenschaft | Wert |
|---|---|
| Modell-ID | large-v3-turbo-q5_0 |
| Datei | ggml-large-v3-turbo-q5_0.bin |
| Quelle | ggerganov/whisper.cpp auf Hugging Face |
| Downloadgröße | 574.041.195 Bytes, etwa 574 MB |
| SHA-256 | 394221709cd5ad1f40c46e6031ca61bce88931e6e088c188294c6d5a55ffa7e2 |
| Laufzeit | @fugood/whisper.node, auf Apple Silicon mit Metal-Beschleunigung |
Whisper ist hier ein spezialisiertes Sprach-zu-Text-Modell, kein allgemeines Chat-LLM. Es wird beim ersten Einrichten direkt von Hugging Face geladen, lokal gespeichert und anschließend vollständig offline ausgeführt. Der Download kann fortgesetzt werden und wird vor der Verwendung anhand von Dateigröße und SHA-256 geprüft.
Die installierte Desktop-App speichert das Modell unter:
~/Library/Application Support/meeting-journal/data/models/ggml-large-v3-turbo-q5_0.bin
Audio wird für die Transkription nicht hochgeladen. Die anschließende Zusammenfassung ist davon getrennt: Ohne API-Key verwendet das Journal eine lokale Analyse; nur bei ausdrücklich aktivierter OpenAI-Integration wird der Transkripttext an die OpenAI API gesendet.
- Workshop aufnehmen öffnen.
- Titel, Sprache und optional Teilnehmende eintragen.
- Mikrofon, Systemaudio und Fensteraufnahme passend zum Workshop auswählen.
- Das konkrete PowerPoint-, Browser-, Whiteboard- oder Meeting-Fenster wählen.
- Bestätigen, dass die Teilnehmenden informiert wurden.
- Aufnahme starten.
- Screenshots über den Button oder
⌘⇧Saufnehmen. - Beenden & transkribieren wählen.
Audio wird während der Aufnahme alle fünf Sekunden an den Desktop-Prozess übergeben und sofort auf die Platte geschrieben. Ein App-Absturz verliert daher nicht die komplette Aufnahme. Beim nächsten Start bietet die Anwendung eine Wiederherstellung an.
Sobald Transkript, Recap und Journal-Eintrag erfolgreich gespeichert wurden, löscht die App die temporären Audiodateien automatisch. Bei einer fehlgeschlagenen oder unterbrochenen Transkription bleiben sie für einen erneuten Recovery-Versuch erhalten.
Im fertigen Eintrag lassen sich Titel nachträglich ändern sowie Zusammenfassung, Entscheidungen, Aufgaben, Notizen, Transkript oder der gesamte Eintrag kopieren. recap.md und transcript.md können einzeln heruntergeladen werden. In der Desktop-App öffnet Ablageordner öffnen direkt den Session-Ordner im Finder.
Die installierte Desktop-App verwendet:
~/Library/Application Support/meeting-journal/data/
├── journal.json
├── settings.json
├── models/
└── workshops/
└── <session-id>/
├── session.json
├── screenshots/
├── transcript.json
├── transcript.md
└── recap.md
Der Ordner audio/ existiert nur während Aufnahme, Recovery und Transkription. Nach erfolgreicher Fertigstellung wird er automatisch entfernt. Screenshots, Session-Metadaten, Transkript und Recap bleiben erhalten.
Beim Löschen einer Workshop-Aufnahme im Journal werden auch deren Audio, Screenshots und abgeleitete Dateien entfernt.
Die Browser-Version speichert standardmäßig relativ zum Projekt:
./data/
├── journal.json
└── settings.json
Über MEETING_JOURNAL_DATA_DIR kann ein anderer Datenordner vorgegeben werden.
npm run pack # vollständig ad-hoc-signierte App zum lokalen Prüfen
npm run dist # vollständig ad-hoc-signierte DMG und ZIP
npm run dist:signed # Developer-ID-Build, wenn Zertifikat und Notarisierungszugang vorhanden sindDer Standard-Build signiert das gesamte App-Bundle einschließlich Electron-Helpern, Frameworks und nativen Whisper-Komponenten ad hoc. Dadurch bleibt die App kryptografisch konsistent, besitzt aber keine von Apple bestätigte Entwickleridentität.
Nach einem Browser-Download muss sie deshalb einmalig über macOS freigegeben werden:
- DMG öffnen und Workshop Journal nach Programme ziehen.
- Die App einmal starten und den Gatekeeper-Hinweis schließen.
- Systemeinstellungen → Datenschutz & Sicherheit öffnen.
- Bei der Meldung zu Workshop Journal auf Dennoch öffnen klicken.
- Die Sicherheitsabfrage bestätigen und anschließend Öffnen wählen.
Eine Meldung, die behauptet, die App sei „beschädigt“, deutet dagegen auf einen fehlerhaft oder nur teilweise signierten Build hin. Der Release-Build wird deshalb zusätzlich mit codesign --verify --deep --strict geprüft.
Auf verwalteten Firmen-Macs kann ein Konfigurationsprofil diese Benutzerfreigabe vollständig sperren. Steht unter Apps erlauben von der Hinweis Diese Einstellung wurde von einem Profil konfiguriert und zeigt der Folgedialog nur In den Papierkorb legen und Fertig, lässt die Unternehmensrichtlinie keine Ad-hoc-signierten Apps zu. In diesem Fall benötigt Workshop Journal entweder:
- eine Apple Developer ID Application-Signatur mit Notarisierung oder
- eine Freigabe/Allowlist durch die zuständige IT für die Bundle-ID
de.tobwil.workshopjournal.
Für eine warnungsfreie öffentliche Verteilung ist weiterhin ein Apple Developer ID Application-Zertifikat samt Notarisierung erforderlich. npm run dist:signed verwendet automatisch die von electron-builder unterstützten CSC_*- und APPLE_*-Umgebungsvariablen. Mikrofon- und Audiozweckbeschreibungen sind bereits in der Build-Konfiguration enthalten.
Der automatische Import verwendet eine normale Microsoft-Anmeldung direkt in der App. Es gibt kein Client-Secret und keine Microsoft-Zugangsdaten in .env. Eine einmalige App-Registrierung bleibt erforderlich, weil Microsoft Graph keine nicht registrierten Anwendungen akzeptiert.
- Im Microsoft Entra Admin Center eine App registrieren.
- Unter Authentication → Add a platform → Single-page application exakt diese Redirect-URI eintragen:
http://127.0.0.1:4173/. - Unter API permissions → Microsoft Graph → Delegated permissions hinzufügen:
User.ReadCalendars.ReadOnlineMeetings.ReadOnlineMeetingTranscript.Read.All
- Für
OnlineMeetingTranscript.Read.Alldurch einen Administrator Admin consent erteilen. - Im Teams Admin Center unter Meetings → Meeting settings → Transcript API access den Microsoft-Graph-Zugriff aktivieren. Optional die Sprecherzuordnung aktivieren.
- Im Journal Einstellungen → Microsoft Teams öffnen und einmalig die Application (Client) ID eintragen. Als Tenant funktioniert
organizationsoder die konkrete Directory/Tenant-ID.
Die Browser-App verwendet den Authorization-Code-Flow mit PKCE. Es muss und darf kein Client-Secret eingetragen werden. Nach der Anmeldung werden Kalendertermine der letzten 90 Tage geprüft, Teams-Meetings aufgelöst und verfügbare Transkripte importiert. Beim Öffnen sowie alle 15 Minuten wird automatisch synchronisiert, solange die App geöffnet ist.
Als Alternative zur Microsoft-Graph-Anmeldung kann die App einen Ordner überwachen, den die OneDrive-Desktop-App bereits lokal synchronisiert:
- Einstellungen → OneDrive-Ordner wählen.
- Ordner auswählen … anklicken und den lokalen OneDrive- oder
Recordings-/Aufzeichnungen-Ordner im nativen Systemdialog auswählen. Eine manuelle Pfadeingabe ist nicht nötig. - Überwachung aktiv einschalten und speichern.
Typische OneDrive-Pfade werden automatisch erkannt. Beim Aktivieren werden vorhandene Dateien importiert. Neue oder geänderte Dateien werden anschließend über Dateisystemereignisse und zusätzlich einmal pro Minute erkannt. Unterstützt werden .vtt, .docx, .txt, .srt, .md und .json. Identische Inhalte werden nicht doppelt importiert; eine geänderte Datei aktualisiert ihren bestehenden Journal-Eintrag.
Microsoft speichert Teams-Transkripte in OneDrive for Business beziehungsweise SharePoint. Im Teams-Rückblick können Organisatoren Transkripte als VTT oder DOCX herunterladen. Die Ordnerüberwachung sieht nur Dateien, die durch die OneDrive-App tatsächlich auf dem Computer synchronisiert oder manuell in den überwachten Ordner gelegt wurden.
Ohne API-Key arbeitet die App mit einer lokalen Heuristik. Unter Einstellungen → KI & Zusammenfassung kann ein OpenAI API-Key eingetragen, das gewünschte Modell ausgewählt und die Verbindung geprüft werden. Der Schlüssel wird serverseitig in data/settings.json mit restriktiven Dateirechten gespeichert, vom Browser nie wieder vollständig abgerufen und von Git ignoriert. Bei einem API-Fehler fällt die App automatisch auf die lokale Analyse zurück.
- Temporäre Audiodateien, Screenshots, Journal und Transkripte werden lokal im Application-Support-Ordner gespeichert.
- Nach erfolgreicher Transkription werden die Audiodateien automatisch gelöscht; bei Fehlern bleiben sie zur Wiederherstellung erhalten.
- Die Fensteraufnahme erfasst nur das explizit ausgewählte Fenster; sie wird nicht als Video gespeichert.
- Die lokale Transkription verwendet Whisper über Metal/CPU und sendet kein Audio an einen Cloud-Dienst.
- Microsoft-Tokens und Client-ID liegen nur im lokalen Browser-Speicher. Ein Client-Secret wird nicht verwendet.
- Der optionale OpenAI-Key liegt ausschließlich in der lokalen, von Git ignorierten Datei
data/settings.jsonund wird nie vollständig an den Browser zurückgegeben. - Bei aktivierter OpenAI-Zusammenfassung wird der Transkripttext zur Analyse an die OpenAI API übertragen.
- Teams-Daten werden nur gelesen. Die App schreibt nichts nach Microsoft 365 zurück.
- Die OneDrive-Ordnerüberwachung liest ausschließlich unterstützte Transkriptdateien im ausgewählten lokalen Ordner; sie verändert oder löscht dort keine Dateien.
npm test
npm run test:electron
npm run test:packagednpm test prüft die plattformunabhängigen Journal-, Import- und Storage-Funktionen. Die Electron-Tests benötigen macOS und prüfen die Desktop-Bridge, Fensterquellen sowie den paketierten Build.
Ein vollständiger macOS-Integrationstest erzeugt per System-Sprachausgabe eine deutsche Testaufnahme, transkribiert sie lokal und prüft Zeitstempel, Screenshot-Zuordnung und Journal-Eintrag:
node scripts/transcription-integration.mjs