Install Obsidian Plugin

Install the AICHE Voice plugin for Obsidian. Record voice notes directly into your vault with AI cleanup, auto-categorization, and offline queue.

3 min read
Last updated: 4/7/2026
obsidianplugininstallation

AICHE Voice works as an Obsidian plugin on desktop (Mac, Windows, Linux) and mobile (iOS, Android).

AICHE recording in Obsidian

Installation

The plugin is not yet in the Community Plugin browser (pending review). Install manually:

  1. Download main.js, manifest.json, and styles.css from the latest release
  2. Create a folder: .obsidian/plugins/aiche-voice/ in your vault
  3. Copy the three files into that folder
  4. Open Obsidian Settings > Community Plugins
  5. Toggle on "AICHE Voice"

Sign In

  1. Go to Settings > AICHE Voice
  2. Click Sign In
  3. Your browser opens aiche.app/connect-obsidian
  4. Sign in with Google
  5. The plugin auto-connects via deep link

Manual fallback: If the deep link doesn't work, copy the code from the browser page and paste it into the plugin settings.

How to Record

  1. Click the mic icon in the ribbon (left sidebar) or the status bar
  2. Speak - the status bar shows recording duration
  3. Click again to stop
  4. Text inserts into your active note

If no note is open, AICHE creates a new voice note in your configured folder (default: "Voice Notes").

Long Recordings

Recordings are segmented into 30-second chunks and transcribed as you go. The final text stitches all segments together.

Settings

In Obsidian Settings > AICHE Voice:

  • Microphone - select specific input device (with refresh button)
  • Polish text - toggle AI enhancement (grammar, punctuation cleanup)
  • Insert at cursor - on: inserts at cursor position. Off: appends to end of note
  • Voice notes folder - where new voice notes are created (default: "Voice Notes")
  • Attach audio - embed the original .webm audio file in your note
  • Organize by category - auto-sort notes into Work/Life/Ideas/Misc subfolders
  • Show notifications - toast alerts for transcription completion

Features

  • AI polish - grammar, punctuation, filler word removal
  • Auto-categorization - sorts notes into Work, Life, Ideas, Misc subfolders
  • Audio attachment - embed the recording in your note for reference
  • Offline queue - failed transcriptions are encrypted and saved locally, auto-retry on reconnect (up to 50 items, 24-hour expiry)
  • Works on mobile - the plugin runs on Obsidian's iOS and Android apps

Known Limitations

  • No real-time streaming - text appears after recording stops, not during
  • No live transcription preview while recording
  • Audio format is WebM (what the browser's MediaRecorder supports)
  • Offline queue: max 50 items, 24-hour expiry, 3 retry attempts

Common Issues

"Microphone blocked": Allow mic access in your system settings (or browser settings on mobile).

"No microphone found": Connect a mic and click the refresh button in plugin settings.

"Session expired": Disconnect and reconnect your account in plugin settings.

"Subscription required": You need an active plan. An upgrade prompt appears automatically.

Status stuck on "Processing...": Fixed in version 1.0.31+. Update the plugin.

Back to Help Center