AppleScript Integration

Key Features

• URL Scheme Support - open location command
• Text Passing - Variables to URL parameters
• File Actions - Trigger on file changes
• Folder Actions - Monitor folders for content
• App Integration - Connect Statuz to other apps
• Classic Automation - Traditional Mac scripting
• System Events - Full system access
• Finder Integration - Scripts from Finder
• Mail Integration - Post from Mail.app
• Safari Integration - Share from browser
• Scheduled Execution - Calendar.app triggers
• User Action Scripts - Services menu items
• Professional Workflows - Enterprise automation

Example AppleScript

tell application "System Events"
    set theText to "Hello from AppleScript"
    set theURL to "statuz://compose?text=" & theText
    open location theURL
end tell

Batch Import (Automator/Folder Action):

on run {input, parameters}
    -- Build comma-separated list of file paths (all files in ONE post)
    set filePaths to {}
    repeat with fileAlias in input
        set end of filePaths to "file://" & (POSIX path of fileAlias)
    end repeat
    
    set AppleScript's text item delimiters to ","
    set mediaParam to filePaths as text
    set AppleScript's text item delimiters to ""
    
    tell application "System Events"
        open location "statuz://compose?media=" & mediaParam
    end tell
    
    return input
end run

Works in: Automator workflows, Quick Actions, folder actions with on run handler

Important: Don't call open in a loop - that creates multiple posts. Build a comma-separated list and open once.

Why AppleScript Users Love It

AppleScript is classic Mac automation. Statuz URL scheme enables AppleScript integration for workflows impossible in web tools. Mac automation tradition meets modern social media.

Batch vs Single File

✅ Correct (all files in ONE post):

-- Build list of file paths
set files to {"file:///path/1.jpg", "file:///path/2.jpg"}

-- Set delimiter to comma (tells AppleScript how to join the list)
set AppleScript's text item delimiters to ","

-- Convert list to comma-separated text and open
open location "statuz://compose?media=" & (files as text)

❌ Wrong (creates MULTIPLE posts):

-- Opens a new composer for EACH file
repeat with file in fileList
    tell application "Statuz" to open file
end repeat

Real-World Example: Lightroom Automation

Want to automate photo exports? Set up a folder action that automatically opens Lightroom exports in Statuz.

Complete Lightroom Setup Guide →

Pro Tips

• Batch files - use comma-separated media= parameter
• open location command for URL schemes
• Text encoding - handle special characters with do shell script "printf %s 'text' | jq -sRr @uri"
• Variable passing - dynamic content from other apps
• Folder actions - automated Lightroom/export workflows
• App integrations - connect Statuz to Mac apps
• Services menu - system-wide AppleScript services
• Calendar triggers - scheduled script execution
• Mail rules - post from email attachments
• Finder context - right-click to post file
• Classic Mac automation meets modern social media