Find My Timeline

Find My Timeline v0.4.5 provides private, self-hosted location history for Apple Find My devices.

  • Tools & Utilities
Find My Timeline v0.4.5 provides private, self-hosted location history for Apple Find My devices. It stores positions locally in SQLite and presents routes, timestamps, battery levels and a chronological timeline in a responsive WebUI. Includes persistent Unraid appdata, Docker health checks and guided Apple two-factor authentication.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

40/100 Fair

Maintained
69last commit 109 days ago
Popular
144 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
108 GB minimum RAM

Availability: platform listings confirmed today, links checked 22 days ago

GitHub stars
4
Open issues
2
Last commit
2026-08-04
Latest release
v0.4.5
License
MIT
Activity
stale

Checked 7 days ago - source: GitHub (heckpiet/find-my-timeline-unraid)

Resources & Compatibility

Minimum requirements: 8 GB RAM.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Apple two-factor setup on first launch On first launch, complete the WebUI's guided Apple two-factor authentication to connect your Find My account. Positions are then recorded in a local SQLite database stored in the persistent Unraid appdata folder. source

Fetched 47 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

How do I first connect Find My Timeline to Apple Find My?

Complete the guided Apple two-factor authentication in the WebUI on first launch. The container can start without credentials and stores the Apple session and cookies in the persistent Unraid appdata folder.

Where should I look to back up location history?

Positions are stored in a local SQLite database. The database and Apple session data are kept in the persistent Unraid appdata folder.

How can I check whether the poller is running?

The app includes a Docker health check and separate liveness and readiness checks. A dedicated settings view also shows health, polling, and authentication status.

Can I change how often it polls Apple Find My?

Yes, polling intervals are configurable and the poller has visible operational status.

Will the WebUI work on a phone?

The WebUI is responsive for desktop and mobile use.

Answers sourced from github.com

Community

Collected 49 days ago - public community threads