Obsidian für macOS

Überblick

Das Obsidian-Plugin speichert TypeWhisper-Transkriptionen als normale Markdown-Dateien direkt in einem Ordner deines Vaults. Du kannst einzelne Notizen über ein Workflow-Action-Ziel erstellen oder mit Auto-Export jede abgeschlossene Transkription automatisch ablegen.

Version 1.2.0 speichert auch Recorder-Transkripte, einschließlich Kalender-Meetings, und Auto-Export kann Diktate auslassen. Sie benötigt TypeWhisper 1.8.0 oder neuer auf macOS. Version 1.1.0 hat konfigurierbare Notizvorlagen, zusätzliche Metadaten und Live-Sync für spätere Korrekturen im TypeWhisper-Verlauf ergänzt.

Quellen: macOS-Plugin-Code, Implementierungs-PR #1089

Der grundlegende Ablauf ist:

Diktat → optionale Workflow-Aufbereitung → Obsidian-Action oder Auto-Export → Markdown-Datei im Vault

Aufnahme → Transkript → Auto-Export → Markdown-Datei im Vault

Einrichtung

1. Öffne in TypeWhisper Einstellungen > Plugins entdecken und installiere Obsidian. Das Add-on erscheint danach in der Seitenleiste der Einstellungen, und seine Seite öffnet sich.
2. Wähle einen erkannten Vault aus. Falls er nicht in der Liste erscheint, wähle Durchsuchen … und öffne den Vault-Ordner manuell.
3. Lege optional einen Unterordner fest. Der Standard TypeWhisper speichert Notizen beispielsweise unter <Vault>/TypeWhisper/.
4. Entscheide dich zwischen einzelnen Notizen und dem Tagesnotiz-Modus.
5. Passe Dateiname, Notizvorlage, Frontmatter und Tags an.
6. Wähle anschließend, ob du gezielt über das Action-Ziel Save to Obsidian exportieren oder Auto-Export aktivieren möchtest, und ob Auto-Export Diktate, Recorder-Transkripte oder beides speichert.

Das Plugin erstellt den konfigurierten Unterordner bei Bedarf. Bei einzelnen Notizen verhindert es Überschreiben durch nummerierte Dateinamen wie Notiz 1.md, wenn ein Name bereits existiert.

Zwei Wege zum Export

Gezielter Export über einen Workflow

Verwende ein Action-Ziel, wenn nur bestimmte Diktate in Obsidian landen oder zuvor von einem LLM strukturiert werden sollen:

1. Erstelle unter Einstellungen > Workflows einen eigenen Workflow.
2. Kopiere die Workflow-Anweisung aus den Obsidian-Einstellungen oder schreibe eine eigene.
3. Wähle Save to Obsidian als Action-Ziel.
4. Weise dem Workflow einen manuellen Kurzbefehl oder passende Regeln zu.

Die mitgelieferte Anweisung bereinigt das Diktat und gibt nur Obsidian-kompatibles Markdown aus. Da der Workflow ein Action-Ziel verwendet, wird sein Ergebnis als Notiz gespeichert und nicht zusätzlich in die aktive App eingefügt. Weitere Details zu Auslösern, Regeln und Action-Zielen findest du in der Workflow-Dokumentation.

Automatischer Export

Aktiviere Auto-Export, um abgeschlossene Transkriptionen automatisch in den gewählten Vault zu schreiben. Zwei Schalter darunter legen fest, was exportiert wird:

• Diktate ist standardmäßig an und speichert jedes abgeschlossene Diktat. Das eignet sich als vollständiges Sprachjournal oder Archiv.
• Recorder-Transkripte ist standardmäßig aus und speichert jede fertige Aufnahme als eigene Notiz. Siehe Recorder- und Meeting-Transkripte.

Schalte Diktate aus und Recorder-Transkripte ein, wenn nur Meetings und Aufnahmen im Vault landen sollen. Wurde ein Diktat bereits über das Workflow-Action-Ziel exportiert, ordnet das Plugin den Abschluss der vorhandenen Notiz zu, statt durch Auto-Export eine zweite Datei anzulegen.

Dateinamen

Die Standardvorlage lautet:

{{DATE}} {{TIME}} {{APP}}

So entsteht beispielsweise 2026-08-10 17-23-52 Safari.md. Die Vorschau in den Plugin-Einstellungen zeigt den aktuellen Namen vor dem Export.

Platzhalter	Ergebnis
{{DATE}}	Datum im Format YYYY-MM-DD
{{TIME}}	Uhrzeit im dateisicheren Format HH-MM-SS
{{APP}}	Name der aktiven App, zum Beispiel Safari
{{LANGUAGE}}	Erkannte Sprache, zum Beispiel de oder en

Für Obsidian- und Dateisystem-kompatible Namen entfernt das Plugin unzulässige Zeichen wie /, :, *, ?, ", <, >, |, [ und ].

Notizvorlagen

Die Notizvorlage bestimmt den vollständigen Markdown-Inhalt einer einzelnen Notiz. Der Standard {{TRANSCRIPT}} speichert nur das fertig verarbeitete Transkript. Du kannst Überschriften, Obsidian-Callouts, Links und Metadaten direkt in die Vorlage aufnehmen.

Platzhalter	Inhalt
{{TRANSCRIPT}}	Fertiges, gegebenenfalls durch den Workflow aufbereitetes Transkript
{{RAW_TRANSCRIPT}}	Ursprüngliches Transkript vor der Workflow-Aufbereitung
{{DATE}}	Aufnahmedatum als YYYY-MM-DD
{{TIME}}	Aufnahmezeit als HH-MM-SS
{{APP}}	Aktive App
{{LANGUAGE}}	Erkannte Sprache
{{URL}}	Aktive URL, wenn die Quell-App sie bereitstellt
{{ENGINE}}	Verwendete Transkriptions-Engine
{{MODEL}}	Verwendetes Modell, falls vorhanden
{{DURATION}}	Aufnahmedauer in Sekunden mit einer Nachkommastelle
{{WORDS}}	Anzahl der Wörter im fertigen Transkript

Nicht verfügbare optionale Metadaten werden als leerer Wert eingesetzt. Bei einem Workflow-Export können Engine, Modell und Dauer erst mit dem Abschlussereignis vorliegen; mit aktiviertem Live-Sync ergänzt das Plugin diese Daten in derselben Notiz.

Beispiele

1. Strukturierte Besprechungsnotiz

Dateiname:

{{DATE}} Meeting

Notizvorlage:

# Meeting vom {{DATE}}

{{TRANSCRIPT}}

---
Quelle: {{APP}}
Dauer: {{DURATION}} Sekunden · {{WORDS}} Wörter

Kombiniere diese Vorlage mit einem Workflow, der das Diktat in die Abschnitte Zusammenfassung, Entscheidungen und Aufgaben gliedert. Das Workflow-Ergebnis ersetzt {{TRANSCRIPT}}; {{RAW_TRANSCRIPT}} bleibt verfügbar, wenn du zusätzlich das ursprüngliche Diktat archivieren möchtest.

2. Recherche-Notiz mit Quelle

Dateiname:

{{DATE}} {{APP}} Recherche

Notizvorlage:

# Recherche

{{TRANSCRIPT}}

> [!info] Quelle
> {{URL}}

Sprache: `{{LANGUAGE}}` · Engine: `{{ENGINE}}`

Wenn die aktive App keine URL an TypeWhisper übermittelt, bleibt {{URL}} leer.

3. Fertiges und ursprüngliches Transkript vergleichen

# Überarbeitete Notiz

{{TRANSCRIPT}}

<details>
<summary>Ursprüngliches Diktat</summary>

{{RAW_TRANSCRIPT}}

</details>

Das ist nützlich, wenn ein Workflow Füllwörter entfernt oder gesprochenen Text neu strukturiert, du aber den Rohtext in derselben Datei behalten möchtest.

YAML-Frontmatter

Mit YAML-Frontmatter ergänzt das Plugin am Dateianfang Obsidian Properties. Je nach verfügbarem Kontext können Datum, App, Bundle-ID, URL, Sprache, Engine, Modell, Dauer, Wortzahl, Verarbeitungsschritte und deine Tags enthalten sein.

Beispiel:

---
date: 2026-08-10T15:23:52Z
app: "Safari"
bundleId: "com.apple.Safari"
url: "https://example.com/article"
language: "de"
engine: "parakeet"
model: "TDT"
duration: 42.5
words: 118
tags:
  - "typewhisper"
  - "recherche"
---

Tags werden in den Einstellungen kommasepariert eingegeben. Das Frontmatter steht zusätzlich vor deiner Notizvorlage; du musst es daher nicht selbst in die Vorlage schreiben.

Tagesnotiz-Modus

Im Tagesnotiz-Modus erstellt das Plugin nicht für jedes Diktat eine neue Datei. Es hängt alle Einträge an eine gemeinsame Datei an, standardmäßig YYYY-MM-DD.md.

Für neue Einträge stehen vier Anhangsformate zur Verfügung:

Format	Vorlage	Ergebnis
Zeitstempelabschnitt	## {{TIME}} + {{TEXT}}	Jeder Eintrag erhält eine Überschrift wie ## 17:23; Abschnitte werden durch eine horizontale Linie getrennt.
Einfach anhängen	{{TEXT}}	Fügt den fertigen Text als eigenen Absatz an.
Aufzählung	- {{TEXT}}	Fügt jeden Eintrag als Listenpunkt an.
Benutzerdefiniert	Eigene Vorlage	Unterstützt {{TEXT}}, {{TIME}}, {{DATE}}, {{APP}}, {{LANGUAGE}} und {{URL}}.

Beispiel für ein Quelljournal:

### {{TIME}} · {{APP}}

{{TEXT}}

Quelle: {{URL}}

Frontmatter wird beim Erstellen einer neuen Tagesdatei einmalig geschrieben. Eine allgemeine Tagesdatei wie {{DATE}}.md erhält bewusst keine app-spezifischen Properties; enthält ihr Dateiname {{APP}}, können diese Metadaten ergänzt werden.

Live-Sync für Verlaufskorrekturen

Verlaufsänderungen live synchronisieren ist standardmäßig aktiviert und gilt nur für einzelne Notizen. Wenn du das zugehörige Transkript später im TypeWhisper-Verlauf korrigierst, schreibt das Plugin dieselbe Markdown-Datei mit dem aktualisierten Text und den aktuellen Metadaten neu. Die Zuordnung bleibt über App- und Plugin-Neustarts erhalten.

Beachte dabei:

• Die Datei wird aus der konfigurierten Notizvorlage neu erzeugt. Manuelle Änderungen an dieser Datei in Obsidian können deshalb überschrieben werden.
• Der Tagesnotiz-Modus bleibt absichtlich append-only; Live-Sync ist dort deaktiviert, damit eine Korrektur nicht den falschen Abschnitt verändert. Speichert Auto-Export auch Recorder-Transkripte, bleibt der Schalter verfügbar und aktualisiert nur die eigenen Notizen der Aufnahmen.
• Das Plugin verfolgt höchstens die neuesten 500 Zuordnungen und entfernt Zuordnungen nach 30 Tagen.
• Aktualisiert werden nur vorhandene Markdown-Dateien innerhalb des aktuell konfigurierten Vaults. Dateien außerhalb des Vaults werden nicht verändert.

Wenn du exportierte Notizen anschließend hauptsächlich in Obsidian weiterbearbeitest, deaktiviere Live-Sync, um diese Änderungen zu schützen.

Recorder- und Meeting-Transkripte

Mit Auto-Export und Recorder-Transkripte wird jedes Transkript, das der Recorder speichert, zu einer Notiz im konfigurierten Unterordner. Das gilt für manuelle Aufnahmen, für Aufnahmen der Meeting-Automatik und für Aufnahmen, die über die API gestartet wurden.

• Kalender-Meetings übernehmen die Markdown-Datei, die der Recorder neben der Aufnahme schreibt. Ihr Frontmatter enthält Titel, Datum, Beginn und Ende, Ort, Organisator und Teilnehmer des Meetings, sodass Dataview Meetings nach Teilnehmer oder Datum auflisten kann. Mit YAML-Frontmatter ergänzt das Plugin deine Tags.
• Andere Aufnahmen verwenden deine Notizvorlage und das Frontmatter. {{APP}} steht dabei für Recorder, Datum und Uhrzeit sind der Zeitpunkt, an dem das Transkript gespeichert wurde.
• Die Notiz heißt wie die Aufnahmedatei, zum Beispiel 20261022 - Weekly sync.md.
• Aufnahmen bekommen immer eine eigene Notiz, auch im Tagesnotiz-Modus.
• Mit Live-Sync aktualisiert eine neue Transkription derselben Aufnahme ihre Notiz, statt eine zweite anzulegen.

Die Notiz enthält den Text des Transkripts ohne Sprechernamen.

Empfohlene Konfigurationen

Ziel	Einstellungen
Nur ausgewählte, aufbereitete Notizen	Auto-Export aus; eigener Workflow mit Action-Ziel Save to Obsidian; Live-Sync an
Vollständiges Transkriptionsarchiv	Auto-Export an; einzelne Notizen; Dateiname {{DATE}} {{TIME}} {{APP}}
Laufendes Sprachjournal	Auto-Export an; Tagesnotiz-Modus an; Zeitstempelabschnitt oder Aufzählung
Notizen nach dem Export manuell in Obsidian pflegen	Einzelne Notizen; Live-Sync aus
Nur Aufnahmen und Meetings, keine Diktate	Auto-Export an; Diktate aus; Recorder-Transkripte an