API Reference

Integration points for developers. HTTP endpoints, URL schemes, and programmatic access to Talkie.

This page is a preview — details may change as development continues.

Interested in this feature? Leave your email and we'll reach out when it's ready.

TalkieServer HTTP Endpoints

TalkieServer runs locally on your Mac and exposes HTTP endpoints for iOS connectivity and local integrations. By default, it listens on localhost:8765.

When paired with Tailscale, the same endpoints are accessible from your iPhone using your Mac's Tailscale IP address.

Health Check

GET/health

Check if TalkieServer is running and get version info.

{ "status": "ok", "version": "1.0.0" }

Pairing

GET/pair

Returns pairing information displayed as a QR code in Talkie settings.

{ "publicKey": "...", "ip": "100.x.x.x", "port": 8765 }

POST/pair/confirm

Confirms pairing from iOS device. Requires the shared secret from QR code.

Memos

POST/memos

Upload a voice memo from iOS. Accepts multipart form data with audio file.

GET/memos

List recent memos for iOS sync. Returns last 50 memos by default.

{ "memos": [{ "id": "...", "title": "...", "createdAt": "..." }] }

GET/memos/:id

Get a specific memo by ID, including transcript and audio URL.

URL Schemes

Talkie registers URL schemes for deep linking and automation. Use these from Shortcuts, Alfred, Raycast, or any app that supports opening URLs.

Supported URL Schemes

talkie://                       # Open Talkie
talkie://record                 # Start recording immediately
talkie://stop                   # Stop current recording
talkie://memo/{id}              # Open a specific memo
talkie://settings               # Open settings window
talkie://settings/iphone        # Open iPhone sync settings
talkie://workflow/{id}          # Run a workflow manually

Example from Terminal:

# Start a recording
open "talkie://record"

# Open a specific memo
open "talkie://memo/abc-123-def"

AppleScript

Talkie is fully scriptable via AppleScript. This enables integration with Alfred, Keyboard Maestro, Raycast, and other automation tools.

Available Commands

• start recording — Begin a new voice recording
• stop recording — Stop and save current recording
• get memos — Returns list of recent memos
• get transcript of memo id "..." — Get transcript text

Example: Record for 10 seconds

tell application "Talkie"
    start recording
    delay 10
    stop recording
end tell

Example: Get latest transcript

tell application "Talkie"
    set recentMemos to get memos
    set latestMemo to item 1 of recentMemos
    set transcriptText to transcript of latestMemo
    return transcriptText
end tell

Shortcuts Integration

Talkie exposes actions to the Shortcuts app for building voice-driven automations.

Available Shortcut Actions

Start RecordingBegin a new voice recording
Stop RecordingStop and process current recording
Get Recent MemosReturns list of recent memos
Run WorkflowExecute a workflow by name

Combine with Siri: "Hey Siri, run my 'Quick Note' shortcut" to trigger voice recording hands-free.

PreviousWorkflows

NextExtensibility