mirror of
https://github.com/wiseguru/ReWrite-Voice-Notes.git
synced 2026-07-22 07:49:19 +00:00
Real-time dictation (AssemblyAI/Deepgram, own provider/key/model), auto-ingest folders, record-in-background, per-invocation diarization, manage built-in templates (enable/track), local whisper.cpp auto-start/idle-stop, and dev tooling (local review + release-checklist skill). Voxtral realtime was reverse-engineered but pulled (not WebView-reachable); its adapter is kept on disk, unwired. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2.7 KiB
2.7 KiB
ReWrite (Voice Notes) wiki
ReWrite is an Obsidian plugin that captures speech (live recording or a pasted transcript), runs it through a transcription provider, cleans and structures it with an LLM, and inserts the result into your vault. You bring your own provider keys; nothing is sent to a ReWrite server. It can also run entirely on-device by pairing the plugin-managed whisper.cpp transcription with a local OpenAI-compatible LLM.
New here? Start with the Quick start. It walks you from install to your first note in a few minutes.
Contents
Getting started
- Quick start - install, populate templates, and create your first note (Daily note example).
Reference
- Settings reference - every setting in the plugin's settings tab, section by section.
- Commands and menus - the command palette, ribbon, editor and file menus, and Quick Record.
- Creating templates - the template file format and a full guide to writing your own.
- Providers - choosing and configuring transcription and LLM providers, models, diarization, context hints, and known nouns.
- Voxtral real-time (disabled) - the reverse-engineered Voxtral streaming protocol, why its browser-auth caveat keeps it disabled, and how to help.
Self-hosting
- Self-hosting: whisper.cpp - on-device transcription with the plugin-managed local whisper.cpp server.
- Self-hosting: local and remote LLMs - Ollama / llama.cpp locally or on a remote server, with model picks for low-spec hardware.
Help
- Secrets and sync - how API keys are encrypted, and how to exclude
secrets.json.nosyncfrom each sync tool. - Mobile - what behaves differently on iOS and Android.
- Troubleshooting - triage for the most common problems.
How it works at a glance
- Capture: record in Obsidian, paste a transcript, or pull text from a note. You can also reprocess an audio file already in your vault.
- Transcribe: audio goes to your configured transcription provider (skipped for text input).
- Clean and structure: the transcript is sent to your LLM with the selected template's prompt, the shared-core baseline, and any known nouns or spoken instructions.
- Insert: the result lands at your cursor, appended to the current note, or in a new note, per the template. Recorded audio is saved and linked back with an
![[...]]embed.
These docs are maintained in the wiki/ folder of the code repo and mirrored here automatically. Edit them there, not in the wiki.