Add-ons receive transcript events — live lines as they're spoken, sessions starting and stopping, finished transcripts — and send them wherever you need: OBS, a text file, a webhook, Word, Discord, a database or your smart home.
The Add-ons window lists every built-in and installed add-on, with its settings and a live log.
Each add-on shows its own options. Click Save settings — enabled add-ons start automatically next time too.
Open add-ons folder opens %LOCALAPPDATA%\WhisperDesk\addons\. Copy an add-on's DLL there and restart WhisperDesk.
No downloads, no code. These three ship inside WhisperDesk and are ready to switch on.
Runs a small web server on your PC (localhost only) for OBS Browser Sources. Three looks: a darkcipher0x terminal, a stacked chat with coloured names, and classic subtitles.
| Port | 7890 Open http://localhost:7890/ for previews and copyable URLs |
|---|---|
| File lines | false true = also send lines from the Files tab |
Writes live lines to a text file as they happen. "Latest" keeps only the last few lines — perfect for OBS Text (GDI+) → Read from file. "Append" keeps the whole session log.
| File path | Documents\WhisperDesk live captions.txt |
|---|---|
| Mode | latest or append |
| Lines | 2 kept in latest mode |
| Speaker | true include speaker name |
POSTs each transcript line and finished transcript as JSON to any URL — connect Zapier, n8n, Home Assistant, a Discord bot or your own server.
| URL | e.g. https://example.com/hooks/whisperdesk |
|---|---|
| Lines | true send each line |
| Saved | true send finished transcripts |
| Live only | true lines from live sessions only |
The server only listens on localhost, so nothing is reachable from other computers.
| Terminal | http://localhost:7890/overlay?theme=terminal |
|---|---|
| Chat | http://localhost:7890/overlay?theme=chat |
| Classic | http://localhost:7890/overlay |
| lines | Lines shown default 2 |
|---|---|
| size | Font size in px default 42 |
| speaker | Show names 1 or 0 |
| color | Text colour (hex) default ffffff |
| bg | Background, hex with alpha default 00000099 |
| font | CSS font family |
| align | left · center · right |
| /events | Server-Sent Events stream line and session events |
|---|---|
| /api/lines | JSON array of the current live session |
Free downloads. Like WhisperDesk itself, these aren't code-signed yet — see the install guide. All source is on the Source Code page.
Every time a transcript is finished or saved, writes it as a Word document (.rtf — opens in Word, LibreOffice and WordPad) with bold speaker names and timestamps. Also a great starting point for your own add-on.
| Export folder | Documents\WhisperDesk Word exports |
|---|---|
| Open | false open in Word after export |
Everything you need to build an add-on: the WhisperDesk.Addons.dll contract with XML docs, the SDK README and the full source of the Word export sample project.
Only install add-ons you trust. An add-on is a .NET library that runs inside WhisperDesk with the same permissions as the app. Install add-ons from this site or from developers you know, and prefer ones whose source code you can read.
Implement one interface in a .NET 8 class library. WhisperDesk finds every public class implementing IWhisperDeskAddon with a parameterless constructor.
using WhisperDesk.Addons; public sealed class MyAddon : IWhisperDeskAddon { IAddonHost? _host; public string Id => "yourname.my-addon"; public string Name => "My add-on"; public string Description => "What it does."; public string Author => "Your name"; public IReadOnlyList<AddonOption> Options { get; } = new[] { new AddonOption("target", "Where to send", "default value", "Help text"), }; public void Start(IAddonHost host) { _host = host; host.LineAdded += (s, e) => host.Log($"{e.Speaker}: {e.Text}"); } public void Stop() { /* unsubscribe, close */ } }
| LineAdded | Every new line — live as spoken, files when finished SessionId, IsLive, Timestamp, Start, End, Text, Speaker, Sex, Language, IsEdited |
|---|---|
| SessionStarted / Stopped | A live session or file starts or ends SessionId, IsLive, Source, Timestamp |
| TranscriptSaved | A file finished, an edit was saved, or a recording went into the library Title, Source, Folder, PlainText, Lines |
| LineEdited | A user corrected a line, with a required reason OldText, NewText, Reason, User, At |
Also: GetOption(key), Log(message), DataFolder and AppVersion. Exceptions in your handlers are caught and logged, so a buggy add-on can't crash WhisperDesk — but hand slow work off to your own task.
Create a .NET 8 class library and reference WhisperDesk.Addons.dll with Private=false (see the sample .csproj).
Copy your DLL and its dependencies — but not WhisperDesk.Addons.dll — into %LOCALAPPDATA%\WhisperDesk\addons\.
Restart WhisperDesk, open File → Add-ons, tick your add-on, fill in its settings and click Save settings.
