Whisper

April 6, 2026 · View on GitHub

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, press Alt + Q again

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 + Q by 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

Buy me a coffee · @nikdanilov_