Echostrata, for Obsidian

Record. Transcribe. Locally.
Record your microphone and your Mac's system audio directly within the note you're writing.
Get a transcript, a summary and action items. Nothing leaves your Mac.

Why Echostrata

Meeting tools upload your conversations to someone else's servers. Echostrata doesn't.

• Mic + system audio. Captures your voice and what your Mac plays: Zoom, Teams, Meet, a browser tab, a video.
• Directly within Obsidian. Click record in a note. The audio, transcript and summary land in that same note.
• Knows who spoke. Your mic and the system audio are recorded on separate channels, so lines are labelled Me and Others without any speaker-recognition model.
• Summaries that fit the conversation. A local model writes a title, summary and to-do checkboxes. Six built-in summary templates cover meetings, 1:1s, client calls, lectures, user interviews and voice memos — or define your own custom templates with a name, purpose and prompt.
• Nothing leaves your Mac. Transcription runs on whisper.cpp, summaries on Ollama. No account, no API key, no subscription, no cloud.

What you get in your note

![[Recording 2026-10-20 10.31.05.m4a]]

> [!abstract] Q4 roadmap sync
> The team agreed on the Q4 order: search first, then sharing. Beta date confirmed.
>
> **Key points**
> - Search ships before sharing
> - Beta locked for November 14
>
> **Action items**
> - [ ] Draft the launch checklist
> - [ ] Share the beta build with the team

> [!quote]- Transcript · 24:13 · Me / Others
> `00:00` **Me:** Let's lock the Q4 roadmap today.
>
> `00:07` **Others:** Search ships first, then sharing.

The transcript is folded by default so the summary stays on top.

Features

Requirements

• macOS 13 Ventura or later for built-in system-audio capture. Older macOS versions can use BlackHole instead.
• Obsidian 1.5.7+, desktop.
• Homebrew, used to install whisper.cpp.
• Xcode Command Line Tools, used to build the small system-audio helper once. They're already installed if you have Homebrew.
• Ollama, optional, for summaries.
• About 0.6 GB of disk for the default speech model, plus 2.6 GB if you add qwen3:4b for summaries.

Installation

Manual

1. Download main.js, manifest.json and styles.css from the latest release.
2. Copy them into <your vault>/.obsidian/plugins/echostrata/.
3. In Obsidian, go to Settings → Community plugins and enable Echostrata.

With BRAT

1. Install the BRAT community plugin.
2. BRAT → Add beta plugin → paste this repository's URL.

Setup (about 5 minutes, no terminal)

The setup assistant opens the first time you enable the plugin. You can reopen it any time from Settings → Echostrata → Open setup. Each row turns green when it's ready:

First recording: macOS asks to allow Obsidian under Privacy & Security → Screen & System Audio Recording. Allow it, then quit and reopen Obsidian. The permission only takes effect after a restart.

Check it works: play a video, then click Settings → Echostrata → Test system audio. You should see ✅ and a level reading.

Usage

1. Open a note and put your cursor where the recording should go.
2. Click the 🎙 button in the note header, or run Echostrata: Start / stop recording in current note.
3. Talk, join your call, play your video. Use Pause or Discard from the floating bar if you need to.
4. Click Stop. Transcription starts right away, and the note fills in when it's done.

Processing time is roughly 1 minute per 20 minutes of audio, plus a few seconds for the summary.

Commands

Assign hotkeys in Settings → Hotkeys → search "Echostrata".

Summary templates

Custom templates are created in Settings → Summary → Custom templates → Add template. Give it a name, an optional "use for" description, and a prompt. The prompt receives the transcript and must ask the model to return structured JSON — the schema is appended automatically. Custom templates appear in the Record with template… picker and the per-note frontmatter alongside the built-in ones.

The template is chosen in this order, most specific first:

1. Record with template… (command palette), for one recording.
2. The note's echostrata-template property, for notes that are always the same type:

   ---
   echostrata-template: client-call
   ---
   

   Valid values: meeting, one-on-one, client-call, lecture, user-interview, voice-memo, plus the slugified ID of any custom template you've created (e.g. custom-weekly-standup).
3. Settings → Summary template (default: Meeting).

qwen3:4b handles every template. qwen3:8b gives noticeably better Client call and User interview results. If the model returns invalid JSON, Echostrata retries once. If that fails too, the transcript is still written, without a summary.

Settings

Speech models

Privacy

Echostrata is built so that everything that should stay private, stays private.

• Recording happens inside Obsidian. Audio files are saved in your vault, next to your notes.
• Transcription runs on your Mac with whisper.cpp. No audio is uploaded anywhere.
• Summaries run on your Mac with Ollama, which listens on 127.0.0.1 by default. Your transcript never goes to a remote AI service.
• No telemetry. No analytics, no account, no API keys.
• Temporary files (separate mic, system and mixed WAV tracks) are written to your system's temp folder and deleted when processing finishes.

The only network traffic is the one-time setup downloads you trigger yourself:

• whisper.cpp, via Homebrew (brew.sh) — triggered when you click Install in the setup assistant;
• the speech model, from Hugging Face (huggingface.co) — triggered when you click Download in the setup assistant;
• Ollama models, from the Ollama registry (ollama.com) — triggered when you click Download in the setup assistant.

These requests go to brew.sh and ollama.com. No request is ever made without you explicitly clicking a setup button. After setup, Echostrata works fully offline.

If you point Ollama URL to a remote server, transcripts will be sent there for summarising. Keep the default 127.0.0.1 to stay fully local.

System access disclosure

Echostrata is desktop-only and, to do its job locally, goes beyond Obsidian's vault API. It uses two powerful Node.js/Electron capabilities that Obsidian's plugin review flags. Here is exactly what they are used for, and nothing else:

Filesystem access (Node.js fs, os, path)

The recording itself (.m4a) and the note text are written through Obsidian's vault API, not fs.

Shell execution (Node.js child_process)

Programs are started directly with an argument list, never through a shell string, and none of this runs until you start recording, transcribing or setup. The only program you can choose yourself is the whisper.cpp binary path.

Network

External domains contacted by Echostrata:

All three are user-initiated one-time actions. No request happens automatically or in the background.

Runtime: the plugin makes HTTP requests to the Ollama URL you configure (default 127.0.0.1 — local only) to list and query installed models. If you change the URL to a remote host, requests to that host will include your transcripts.

Release integrity

Release assets (main.js, manifest.json, styles.css) are built by GitHub Actions from a tagged commit with npm ci, and carry GitHub build-provenance attestations. Verify a download with gh attestation verify main.js --repo SeneKela/echostrata-for-obsidian.

How it works

Microphone ──────────┐
                     ├─► Web Audio graph ──► MediaRecorder ──► Recording.m4a (your vault)
System audio ────────┘         │
(ScreenCaptureKit helper       └─► AudioWorklet: 48 kHz → 16 kHz, level meters
 or BlackHole)                          │
                                        └─► mic.wav · system.wav · mix.wav (temp, streamed to disk)

Stop ─► whisper.cpp on mic.wav + system.wav ─► merged by timestamp ─► Me / Others paragraphs
     ─► Ollama (JSON, chosen template) ─► structured summary ─► written into the note

• System audio: a tiny Swift program using Apple's ScreenCaptureKit captures what the Mac plays and streams it to the plugin. It's compiled on your Mac from source bundled in the plugin, so there's no prebuilt binary to trust.
• Note updates: the in-note placeholder is marked with invisible Obsidian comments (%%…%%), so it's updated in place and the markers are removed once the final content is written.

Troubleshooting

Building from source

git clone https://github.com/SeneKela/echostrata-for-obsidian
cd echostrata-for-obsidian
npm install
npm run build   # → main.js
npm run dev     # watch mode

Then copy main.js, manifest.json and styles.css into your vault's plugin folder.

Project layout:

src/
  main.ts           plugin entry, commands, recording lifecycle
  recorder.ts       Web Audio graph, AudioWorklet, MediaRecorder
  native-audio.ts   ScreenCaptureKit helper (Swift source, build, stream)
  devices.ts        microphone / loopback device detection
  session.ts        recording session + processing job (save → transcribe → summarise)
  transcriber.ts    whisper.cpp runner, models, paragraphs
  summarizer.ts     Ollama models and chat requests
  templates.ts      summary templates: prompts and note rendering
  template-modal.ts "Record with template…" picker
  note.ts           in-note block insert / update / remove
  ui.ts             header button, floating bar, ribbon, status bar
  setup.ts          setup assistant
  settings.ts       settings tab
  resampler.ts      streaming 48 → 16 kHz resampler
  wav.ts            streaming WAV writer
styles.css          Figma-style UI

Roadmap

• Custom summary prompts and templates
• Live transcript while recording

Credits

• Inspired by Lecture Transcriber by AbyssLotus.
• Speech recognition: whisper.cpp by Georgi Gerganov, using OpenAI's Whisper models.
• Local language models: Ollama.
• Optional loopback driver: BlackHole by Existential Audio.

License

MIT © Martin Burkel