findmy

Automate the macOS Find My app to extract device locations from screenshots.

Updated Sep 1, 2021
One-click install
npx skills add https://github.com/unclehowell/unclehowell --skill findmy-unclehowell
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/unclehowell/unclehowell/tree/main/skills/apple/findmy
Command: npx skills add https://github.com/unclehowell/unclehowell --skill findmy-unclehowell

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Many users need to retrieve location information from Apple's Find My app but Apple provides no CLI or API, making automated or repeatable location checks difficult; this Skill automates the macOS UI, captures screenshots, and extracts device locations so you can get current positions without manual reading.

Core Features & Use Cases

  • Automates opening the Find My app and navigating between Devices and Items using AppleScript and UI events for quick lookups.
  • Captures screenshots of the Find My window and uses vision analysis to extract device names, addresses, and coordinates from the UI.
  • Supports periodic monitoring workflows for AirTag patrol routes by repeatedly capturing the UI and compiling location points.
  • Optional integration with peekaboo improves click reliability and element targeting for more stable automation.

Quick Start

Open the Find My app on macOS, capture the Find My window screenshot, and run vision_analyze on the image to extract device names and locations.

Frequently Asked Questions about findmy

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

FAQPage Schema
How do I automate Apple Find My app location tracking on macOS?

Automate Find My location tracking on macOS by using AppleScript and UI events to open the app, switch between Devices and Items tabs, capture window screenshots, and extract device locations via vision analysis.

Can I retrieve AirTag coordinates from macOS without an Apple API?

Retrieve AirTag coordinates without an Apple API by automating the macOS Find My app UI, capturing screenshots of the Items tab, and extracting addresses and coordinates from the images using vision analysis.

Does Find My automation require screen recording permission on macOS?

Find My automation requires screen recording permission for the terminal on macOS to capture the Find My window screenshots needed for extracting device locations and AirTag coordinates.

What is the best way to log periodic AirTag patrol routes automatically?

Log periodic AirTag patrol routes by repeatedly automating the Find My app to capture the UI, extracting location points from screenshots, and compiling the coordinates into a continuous monitoring workflow.

Why does macOS Find My UI automation click the wrong element?

macOS Find My UI automation may click wrong elements due to standard AppleScript targeting limits; integrating peekaboo improves click reliability and element targeting for more stable automation.