findmy

Tracks Apple devices and AirTags via Find My app using AppleScript and screen capture.

Updated Jun 15, 2026
One-click install
npx skills add https://github.com/faramirezs/talking_printer --skill findmy-faramirezs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/faramirezs/talking_printer/tree/main/hermes-agent/skills/apple/findmy
Command: npx skills add https://github.com/faramirezs/talking_printer --skill findmy-faramirezs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Find My has no CLI or API, so this Skill enables tracking Apple devices and AirTags on macOS by using AppleScript to open Find My and screen capture to read locations.

Core Features & Use Cases

  • AppleScript + Screenshot: Open Find My, switch to the appropriate tab, and capture the screen to read device locations.
  • Peekaboo UI Automation (Optional): If installed, use Peekaboo for more reliable UI automation of Find My.
  • Time-based Tracking: Periodically capture location data to observe movement or patrol routes for AirTags.

Quick Start

Open the Find My app, ensure you are signed in, and begin monitoring a device or AirTag by capturing periodic screenshots for location analysis.

Frequently Asked Questions about findmy

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I track AirTag location on macOS without a CLI?

You can track AirTag location on macOS by using AppleScript to open the Find My app and screen capture to read the map data. This bypasses the lack of an official API by automating the native UI to periodically capture screenshots for location analysis.

Can I automate Find My app location monitoring using screen capture?

Yes, you can automate Find My app location monitoring using screen capture and AppleScript. The automation opens the application, switches to the correct tab, and takes periodic screenshots to observe device movement or patrol routes over time without requiring command-line access.

Do I need peekaboo for UI automation of the Find My app?

You do not need peekaboo for UI automation of the Find My app, but installing it provides more reliable interaction. The baseline requirement is macOS with screen recording permission, while AppleScript handles standard interaction without it.

What are the limitations of using screenshot-based location tracking for Apple devices?

The main limitation of screenshot-based location tracking is that it relies on reading visual screen captures rather than direct API data. You must keep the Find My app open, maintain active screen recording permissions, and interpret visual map data instead of raw coordinates.

How does AppleScript interact with the Find My app to verify device presence?

AppleScript interacts with the Find My app to verify device presence by programmatically launching the application and switching to the appropriate tab. It then triggers screen capture to read the current device locations visually when a direct CLI or API is unavailable.