README file from
GithubWhisper — Speech-to-text for Obsidian
Record or upload audio, transcribe with Whisper, and optionally post-process the result with an LLM. Works on desktop and mobile.
Works with OpenAI, Groq, Azure, or any other Whisper-compatible API.
Quick Start
- Install from Settings → Community Plugins → search "Whisper"
- Add your API key in the plugin settings
- Open a note, press
Alt + Q, speak, pressAlt + Qagain
The transcription appears at your cursor.
Usage
Record — click the mic icon in the sidebar, or press Alt + Q to start/stop.
Upload — command palette → Upload audio file (mp3, mp4, m4a, wav, webm, ogg).
Right-click — right-click any audio file in your vault → Transcribe audio file.
All commands can be assigned custom hotkeys in Obsidian's hotkey settings:
- Start/stop recording (
Alt + Qby default) - Pause/resume recording
- Open recording controls
- Upload audio file
Automation
Trigger from iOS Shortcuts, Alfred, or any tool that can open URLs:
obsidian://whisper open controls
obsidian://whisper?command=start start recording
obsidian://whisper?command=stop stop and transcribe
obsidian://whisper?command=pause pause/resume
obsidian://whisper?command=cancel discard recording
Post-Processing
Enable Post-processing in settings to run transcriptions through an LLM — fix grammar, remove filler words, format as markdown, extract action items.
Supports Claude, GPT, or any OpenAI-compatible endpoint (Ollama, LM Studio, etc.).
You can also enable Auto-generate title to create descriptive filenames for your notes.
Note Templates
When Create note file is enabled, you can customize the filename and content using template variables:
| Variable | Example |
|---|---|
{{title}} |
Meeting Notes |
{{audioFile}} |
recordings/2026-04-05.webm |
{{transcription}} |
the transcribed text |
{{date}} |
2026-04-05 |
{{time}} |
14-30-00 |
{{datetime}} |
2026-04-05 14:30:00 |
Example note template:
# {{title}}
![[{{audioFile}}]]
{{transcription}}
Use ![[{{audioFile}}]] to embed audio (playable) or [[{{audioFile}}]] to link.
Manual Installation
Download manifest.json, main.js, styles.css from releases into .obsidian/plugins/whisper/ in your vault.
Contributing
Issues and PRs welcome — GitHub Issues