README file from
GithubCordari for Obsidian
Sync your Cordari voice recordings into your Obsidian vault as markdown files — one page per recording, with the audio embedded inline, the Plaud-generated summary, and the full transcript.
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]]. - Reconciles continuously — renames on Plaud's side propagate to the file, late-arriving transcripts/summaries 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/rsteckler/cordari-cloud or reach out via app.cordari.ai.
License
MIT.