Skip to content

Latest commit

 

History

History
50 lines (40 loc) · 1.6 KB

README.md

File metadata and controls

50 lines (40 loc) · 1.6 KB

Airtag-to-GPX

This is a script that fetches the locations of airtags from the local cache of the FindMy.app and creates *.gpx files from them.

It's useful for tracking the history of an airtag's locations.

(Credits go to henrik242 for inspiring this.)

Prerequisite

  • a Mac computer (sorry Linux & other OS do not work) =(
  • jq
  • your terminal app (e.g. iTerm2) or /usr/sbin/cron has FullDisk access

Prepare

  • If not already done, make the script executable: 
    $ chmod +x <PATH-TO-REPO>/airtag-to-gpx.sh
  • The Find My.app must be running & remain open for regular updates of the local cache.

Usage

# generate gpx of all airtags
$ ./airtag-to-gpx.sh

# generate gpx of a specific airtag
$ ./airtag-to-gpx.sh <AIRTAG-NAME>
# e.g.
$ ./airtag-to-gpx.sh Wallet

The script runs only once and is meant to be used with a cronjob (or something similar). For testing you can run it indefinitely like this:

# runs every minute
$ while true; do ./airtag-to-gpx.sh; echo -n "."; sleep 60; done

Environment variables

OUTPUT_DIR

  • default: $HOME/Desktop/airtag-gpx
  • Place where the gpx are saved to
  • Contains final gpx files (merged from all days)

TMP_DIR

  • default: $HOME/Desktop/airtag-gpx/tmp-data/
  • Working directory
  • Contains daily gpx files and other files

Known Issues

  1. Airtag names with whitespaces break the jq query
    • Can be mitigated by renaming airtags to something w/o whithespaces