README file from
GithubRoveNotes for Obsidian
Sync your RoveNotes voice recordings and handwritten notes into your Obsidian vault as markdown files — one page per recording (audio embedded inline, summary, full transcript) and one page per handwritten note (recognized markdown + summaries).
What it does
Each sync pass:
- Creates
RoveNotes/{date}_{filename}__{shortId}.mdper recording, with YAML frontmatter (rovenotes_id,rovenotes_url,date,duration_ms,filename,state). - Saves the recording's audio next to the markdown as
.oggso it plays in Reading Mode via![[...ogg]]. - Creates
RoveNotes/Notes/{date}_{filename}__{shortId}.mdper handwritten note (Boox today), with the recognized markdown, any AI summaries, and a link back to the note in RoveNotes. No audio — handwriting only. - Reconciles continuously — renames on the RoveNotes side propagate to the file, late-arriving transcripts/summaries/recognition update the same file in place, and anything you deleted from the vault gets rewritten on the next sync.
The plugin only sends read requests; nothing in your vault is pushed back to RoveNotes.
Requirements
- A RoveNotes Pro account (free tier doesn't grant API access).
- Obsidian 1.4.0+ on desktop (macOS / Windows / Linux). Mobile isn't
supported yet — the plugin declares
isDesktopOnly: true.
Install
- Obsidian → Settings → Community plugins → Browse.
- Search for RoveNotes, install, enable.
- Open the plugin's settings and click Connect to RoveNotes.
Local build (for development)
- Build:
npm install && npm run buildfrom the repo root. - Copy
dist/main.js,manifest.json, andstyles.cssinto<your-vault>/.obsidian/plugins/rovenotes-notes/. - Obsidian → Settings → Community plugins → turn off Restricted mode, refresh the installed plugins list, enable RoveNotes.
Linking the plugin to your account
- Open Settings → RoveNotes → Connect to RoveNotes.
- The plugin shows an 8-character code + a link to
app.rovenotes.com/link. - Open the link in your browser (already signed in as your RoveNotes user), paste the code, approve. Obsidian picks up the approval within a few seconds.
You can flip the integration off without disconnecting from Settings → Integrations → Obsidian on the web. Revoking the token fully ("Revoke all") requires re-linking next time.
Settings
- Vault folder — where recording files live. Default
RoveNotes. - Auto-sync interval — minutes between polls. Minimum 1, default 5.
- Sync now — runs the loop immediately (also available as a ribbon icon and command palette entry).
Support
File issues at github.com/Radiant-Maple-Studios/rovenotes-obsidian or reach out via app.rovenotes.com.
License
MIT.