Docs
Docs.
Everything you need to set up Oyma, record your first meeting, and keep it all on your Mac.
Getting started
- Getting started
Your first launch, explained: where your notes live, what the sample notes and tour show you, and the handful of shortcuts that cover daily use.
- Open an existing Obsidian vault
Point Oyma at your Obsidian vault folder. What carries over (Markdown, wikilinks, callouts, frontmatter, images) and what is left alone.
- Keyboard shortcuts on macOS
Master macOS hotkeys, command palette navigation, daily notes shortcuts, and markdown editing keys in Oyma.
- Daily note workflows and journaling
Establish dependable daily notes, time-blocking logs, interstitial journaling, and periodic reviews in your vault.
- Installation and macOS Gatekeeper
How to install Oyma on Apple silicon Macs, verify Gatekeeper signatures, and configure local storage.
- Workspace tour and layout navigation
Explore the three-column layout, ribbon tools, file tree, editor canvas, and right inspector panel in Oyma.
Notes & files
- Markdown basics
The Markdown Oyma understands, from headings and task lists to callouts, highlights, comments and footnotes, plus what still shows as plain source.
- Links, backlinks and the graph
Link notes with [[wikilinks]], change the link text, point at a heading, see what links back to a note, and explore the vault in the graph view.
- Search and the command palette
Use ⌘O to jump to notes, run commands with > and look up tags with #. Search the text of every note with ⌘⇧F, and find or replace inside a note.
- Work with tables
Tables in Oyma behave like a small spreadsheet. Move with Tab and Enter, use row and column menus, sort, and paste CSV or TSV data straight in.
- Prepare an Obsidian vault for migration
How to back up, audit links and attachments, check frontmatter, and test Markdown compatibility before moving your Obsidian vault to another app.
- Export notes to PDF, DOCX, and HTML
How to export Markdown notes to PDF documents, Word DOCX files, and standalone HTML files on your Mac with embedded styles and images.
- Callouts, highlights, and comments
How to format Obsidian-compatible callout blocks, text highlights, margin comments, and footnotes in your notes.
- File attachments and media management
Store images, PDFs, diagrams, and audio files locally in your vault with wikilink embeds and clean folder structures.
- Graph view and knowledge visualization
Navigate your vault's interactive force-directed graph, explore local note neighborhoods, filter tags, and spot orphans.
- YAML frontmatter and metadata properties
Define YAML frontmatter properties, tags, aliases, dates, and custom metadata for structured search in Oyma.
- Folder organization and the PARA method
Structure your Markdown vault using the PARA framework, Maps of Content (MOCs), and Zettelkasten slip-boxes.
- Wikilink aliases and heading deep links
Deep-link to specific note sections, create piped link aliases, and navigate block references in Oyma.
- Tags, nested taxonomies, and search
Organize vault notes with nested tags, manage tag hierarchies, and filter search queries efficiently.
- Vault backups and Git version control
Protect your local Markdown notes with Apple Time Machine, automated rsync scripts, and Git version control.
Meetings
- Record a meeting
Capture a call into any note. Start and stop recording, pause from the recording dock, let Oyma notice Zoom, Meet or Teams, and get a transcript and summary.
- Recording permissions on macOS
Which macOS permissions meeting capture needs, why call audio requires macOS 14.2 or later, what happens without them, and how to grant or reset them.
- Meeting app detection and calendar matching
How Oyma detects Zoom, Meet, Teams, Slack, and other meeting apps via CoreAudio and matches attendees from macOS Calendar.
- System audio pipeline and ScreenCaptureKit
How ScreenCaptureKit routes loopback call audio on macOS 14.2+ without virtual audio drivers or background kernel extensions.
- Calendar integration and attendee matching
Connect macOS Calendar with Oyma to automatically populate meeting titles, attendee rosters, and agenda notes.
- AI meeting summary archetypes
Explore the 5 built-in summary templates (General, 1:1, Standup, Retro, Design Review) and how optional Oyma AI uses them.
- Multilingual meeting recording and Whisper
Record and transcribe conversations in 13+ languages with automatic language detection on Apple silicon.
- Headset selection and echo cancellation
Prevent acoustic loopback, optimize microphone gain, and choose the best audio equipment for call recording.
- Offline and in-person meeting recording
Record in-person conferences, whiteboard brainstorming sessions, and disconnected discussions in airplane mode.
Transcription
- Transcription models and languages
How on-device transcription works in Oyma. Pick a speech model by size and speed, set the language, transcribe audio or video files, and avoid duplicates.
- Transcribe audio and video files on your Mac
How to transcribe existing audio and video files locally in Oyma using embedded Whisper models with zero cloud upload overhead.
- Whisper benchmarks on Apple silicon
Measured transcription speed, memory footprint, and Word Error Rate across M1, M2, M3, and M4 Macs.
- Batch audio and video transcription
How to transcribe multiple audio and video files in bulk using drag-and-drop on macOS.
- Speaker attribution and turn-taking notes
Understand dual-channel audio separation, speaker turn-taking heuristics, and assigning action item owners.
- Custom vocabulary and technical acronyms
Tune Whisper speech recognition for specialized terminology, internal codenames, and domain-specific acronyms.
- WebVTT and SRT subtitle export
Export timestamped WebVTT and SubRip subtitle tracks alongside Markdown transcripts for video editing and compliance.
- Dual-channel audio isolation mechanics
Technical mechanics of separating microphone input from system loopback into distinct tracks before Whisper inference.
AI
- Getting better meeting summaries
Pick the right template, jot sharper notes and fix the transcript so optional Oyma AI summaries come out focused in Oyma.
- Oyma AI usage and what a request carries
How a meeting transcript turns into an Oyma AI request, what controls you have over it, and how to keep a note or your whole Mac out of it.
- Ask your meeting: conversational inquiry
How conversational inquiry works over meeting notes, grounding answers in transcript timestamps and preventing hallucinations.
Privacy
- Local-only mode and privacy controls
Block every network connection with Local-only mode, understand what the optional AI feature sends, read the egress log, and turn AI off for a single note.
- Inspect network requests with the Egress log
How to audit outbound network activity in Oyma. View transparent byte counters, verify zero telemetry, and export network ledgers.
- macOS Keychain credential security
What Oyma keeps in the macOS Keychain, why it holds sign-in and calendar tokens only, and why no API keys are stored.
- Network guard verification and test suite
Audit the built-in network guard test suite, verify socket blocking in Local-only mode, and inspect egress rules.
- Air-gapped Mac deployment protocol
Setup guide for running Oyma in strictly classified, air-gapped, zero-internet enterprise environments.
- Zero telemetry and differential privacy
Explanation of zero third-party telemetry, opt-in crash metrics, lack of user identifiers, and absence of tracking SDKs.
- Data retention and permanent deletion
True file deletion mechanics on APFS/macOS, absence of cloud shadow backups, and removal of temporary audio buffers.
- GDPR and local data residency compliance
Legal and architectural alignment with GDPR, CCPA, and European data residency mandates when using on-device software.
Troubleshooting
- Troubleshooting
Fixes for silent call audio, slow or lagging transcription, summaries that fail, Oyma AI being unavailable, and how to export a diagnostics file for support.
- ScreenCaptureKit permission troubleshooting
Step-by-step resolution for macOS Screen & System Audio Recording permission loops and TCC database resets.
- Whisper model download recovery and manual cache
How to resolve interrupted Whisper model downloads, verify SHA256 checksums, and manually place cache files.
- Audio buffer underruns and dropout resolution
Diagnose CoreAudio dropouts, CPU throttling under heavy system load, and optimize audio sample buffers on macOS.
- SQLite FTS5 index rebuild and search repair
How to force a complete re-indexing of vault notes in SQLite FTS5 when full-text search results show discrepancies.
- Memory consumption and optimization
Manage unified memory allocation when transcribing multi-hour recordings with Whisper on 8GB and 16GB Macs.
- Audio device switching and troubleshooting
Handle Bluetooth disconnects, AirPods handover, USB audio interface sample rate conflicts, and fallback microphones.