README file from
GithubCordari for Obsidian
Sync your Cordari 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
Cordari/{date}_{filename}__{shortId}.mdper recording, with YAML frontmatter (cordari_id,cordari_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
Cordari/Notes/{date}_{filename}__{shortId}.mdper handwritten note (Boox today), with the recognized markdown, any AI summaries, and a link back to the note in Cordari. No audio — handwriting only. - Reconciles continuously — renames on the Cordari 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 Cordari.
Requirements
- A Cordari 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 Cordari, install, enable.
- Open the plugin's settings and click Connect to Cordari.
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/cordari-notes/. - Obsidian → Settings → Community plugins → turn off Restricted mode, refresh the installed plugins list, enable Cordari.
Linking the plugin to your account
- Open Settings → Cordari → Connect to Cordari.
- The plugin shows an 8-character code + a link to
app.cordari.ai/link. - Open the link in your browser (already signed in as your Cordari 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
Cordari. - 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/cordari-obsidian or reach out via app.cordari.ai.
License
MIT.