---
name: automating-voice-memos
description: Automates Apple Voice Memos (Mac Catalyst, no dictionary) via JXA using filesystem/SQLite access and System Events UI scripting. Use when asked to "automate Voice Memos", "export voice recordings", "access Voice Memos database", or "transcribe voice memos".
allowed-tools:
  - Bash
  - Read
  - Write
---

# Automating Voice Memos (no dictionary, data+UI hybrid)

## Relationship to the macOS automation skill
- This is a standalone skill for Voice Memos automation.
- For setup help, see the `automating-mac-apps` skill for permissions (Full Disk Access, Accessibility) and the ObjC bridge basics.
- Prerequisites: Basic JXA (JavaScript for Automation) knowledge; install via macOS System Preferences > Security & Privacy.

## Core Framing
- **Catalyst App**: Voice Memos is an iOS app adapted for macOS without full macOS APIs, hence no AppleScript dictionary for automation.
- **UI-first**: Prefer UI scripting/keyboard shortcuts for exports to avoid touching the database/container.
- **Data (optional)**: Use data-layer control only if needed (ObjC + sqlite3). This requires broader permissions.
- **Permissions**: Accessibility for UI automation; Full Disk Access only if you read/write the container/DB.

## Workflow (default)
1) UI-first (no FDA): export via menu/shortcut to a folder you control.
2) Optional data path: resolve storage paths; query CloudRecordings.db (Apple epoch +978307200) only if required.
3) For UI actions (recording/export), drive the app with System Events (shortcuts preferred over clicks).
4) For editing, prefer external tools (ffmpeg) after export; avoid writing directly into the container unless you accept FDA.

## Quickstart (UI-only export; no Full Disk Access)
- Open Voice Memos and select a recording.
- Export/share UI: the Share sheet can send audio to Notes/other apps (no direct File > Export).
- Transcript copy (UI-only, no FDA):
  - Run: `osascript skills/automating-voice-memos/scripts/copy_transcript_to_file.applescript "/path/to/output.txt"`
  - Defaults: Desktop/voice-memo-transcript.txt if no arg.
  - Shows transcript (if available), selects all, copies, and writes to the target file via clipboard.

## Permissions
- **Accessibility**: System Settings > Privacy & Security > Accessibility > Enable for System Events and your automation app (Terminal/Python/Script Editor).
- **Full Disk Access**: Only if you read/write the Voice Memos container/DB directly. UI-only exports do not require FDA.
- **Verify**: For UI-only, confirm you can open the Export menu and interact with the save dialog. For data access, verify `${home}/Library/Group Containers/group.com.apple.VoiceMemos.shared/`.

## Validation Checklist
After implementing Voice Memos automation:
- [ ] Verify Accessibility permissions granted for Terminal/Script Editor
- [ ] Confirm Voice Memos app opens and responds to UI scripting
- [ ] Test transcript copy script executes without errors
- [ ] Validate output file contains expected transcript text
- [ ] For data access: verify Full Disk Access and database path exists

## Troubleshooting
- **Permission denied**: Verify Full Disk Access and Accessibility permissions.
- **Database locked**: Close Voice Memos app before querying.
- **File not found**: Check macOS version for correct storage path.
- **UI automation failures**: Ensure Voice Memos is focused and Accessibility is enabled.

## When Not to Use
- For cross-platform audio recording (use ffmpeg or platform-agnostic tools)
- When you need programmatic audio capture (use AVFoundation directly)
- For iOS Voice Memos automation (no API available)
- When Full Disk Access cannot be granted

## What to load
- Start with basics & prerequisites: `automating-voice-memos/references/voice-memos-basics.md` (setup and core concepts).
- UI automation: `automating-voice-memos/references/voice-memos-ui.md` (shortcuts, AX scripting).
- Data access (if needed): `automating-voice-memos/references/voice-memos-data.md` (storage paths, epochs, database schema).
- Recipes: `automating-voice-memos/references/voice-memos-recipes.md` (exports, transcripts, recording control).