Developers

Automate Birdify
the Mac way.

Birdify integrates with the macOS automation ecosystem through AppleScript, URL schemes, and Apple Shortcuts so you can wire it into existing workflows.

AppleScript

Birdify is designed for a scripting dictionary so you can control reading, dictation, transcription, and related workflows from Script Editor or other automation tools.

Command names and parameters must be confirmed against the shipped scripting dictionary.

tell application "Birdify"
  -- Read the selected text in the frontmost app
  read selection

  -- Start dictation into the active text field
  start dictation

  -- Transcribe a file
  transcribe file POSIX file "/path/to/recording.m4a"
end tell

URL Scheme

Trigger Birdify workflows via a birdify:// URL from Terminal, Raycast, Alfred, or another launcher.

Confirm birdify:// registration and supported actions in the shipping build.

# Read clipboard text aloud
open "birdify://read?source=clipboard"

# Transcribe a local file
open "birdify://transcribe?file=/path/to/audio.m4a"

# Start dictation
open "birdify://dictate"

# Open Studio
open "birdify://studio"

Apple Shortcuts

Native Shortcuts actions are intended to ship with the app so you can chain Birdify into broader macOS automations.

Exact action names may differ in the shipping version.

Shortcut: "Read selection aloud"
  1. Get Clipboard
  2. Birdify: Read Text
     Voice: System Default

Shortcut: "Transcribe recording"
  1. Record Audio
  2. Birdify: Transcribe
  3. Copy to Clipboard