iMessage Notification Skill
Send iMessage notifications to your iPhone using Mac's Messages app via AppleScript. Features: Text, Images, Videos, Audio, Files, URLs (with preview)
Prerequisites
- Mac mini (or Mac) with Messages app open and signed in
- iPhone signed into the same Apple ID (iMessage)
- Apple ID: fan.xia@qq.com
Quick Usage
Simple Text Message
./scripts/send-imessage.sh "Your notification message"
# Or shortcut:
~/Document/code/clawd/notify "Hello!"
Multimedia Messages
# Text only
./scripts/send-imessage-media.sh -t "Task completed!"
# Send image
./scripts/send-imessage-media.sh -i ~/Desktop/screenshot.png
# Send video
./scripts/send-imessage-media.sh -v ~/Movies/clip.mp4
# Send audio/voice
./scripts/send-imessage-media.sh -a ~/Desktop/recording.m4a
# Send any file
./scripts/send-imessage-media.sh -f ~/Documents/report.pdf
# Send URL (displays preview)
./scripts/send-imessage-media.sh -u "https://www.apple.com"
# Combined: Text + Image
./scripts/send-imessage-media.sh -t "Check this:" -i ~/Desktop/chart.png
# Combined: Text + Link
./scripts/send-imessage-media.sh -t "Found this:" -u "https://example.com"
Shortcuts
# Quick text
cd ~/Document/code/clawd && ./notify "Hello"
# Quick multimedia
cd ~/Document/code/clawd && ./notify-media -t "Done!" -i result.png
From Clawdbot Tasks
Simple notification
# At the end of a task:
~/Document/code/clawd/notify "🎉 Build finished!"
With screenshot
# Take screenshot and send
screencapture -i ~/Desktop/result.png
~/Document/code/clawd/notify-media -t "Error occurred:" -i ~/Desktop/result.png
Task completion with file
# Generate report and notify
./generate-report.sh
~/Document/code/clawd/notify-media -t "Report ready:" -f ~/output/report.pdf
Options Reference
| Option | Description | Example |
|---|---|---|
-t, --text |
Text message | -t "Hello" |
-i, --image |
Image file | -i photo.jpg |
-v, --video |
Video file | -v clip.mp4 |
-a, --audio |
Audio file | -a voice.m4a |
-f, --file |
Any file | -f doc.pdf |
-u, --url |
URL with preview | -u "https://..." |
-r, --recipient |
Override recipient | -r "other@icloud.com" |
-h, --help |
Show help | -h |
Script Reference
- scripts/send-imessage.sh - Simple text messages
- scripts/send-imessage-media.sh - Full multimedia support
