<div align="center"> <img alt="FindMy.py Logo" src="https://raw.githubusercontent.com/malmeloo/FindMy.py/refs/heads/main/assets/icon.png" width="500"> <h1>FindMy.py</h1> </div> <div align="center">

Query Apple's FindMy network with Python!

<h5> <a href="https://docs.mikealmel.ooo/FindMy.py"> Docs </a> <span> | </span> <a href="examples/"> Examples </a> <span> | </span> <a href="https://pypi.org/project/FindMy/"> PyPI </a> <span> | </span> <a href="https://discord.gg/EF6UCG2TF6"> Discord </a> </div>

🚀 Overview

The current "Find My-scene" is quite fragmented, with code being all over the place across multiple repositories, written by several authors. This makes it hard to integrate FindMy functionality with your project. FindMy.py aims to make it easy for you to query the location of your AirTags, iDevices and DIY tags with an easy to use Python library.

🧪 Features

[x] Cross-platform: no Mac needed
[x] Fetch and decrypt location reports
- [x] Official accessories (AirTags, iDevices, etc.)
- [x] Custom AirTags (OpenHaystack)
[x] Apple account sign-in
- [x] SMS 2FA support
- [x] Trusted Device 2FA support
[x] Scan for nearby FindMy-devices
- [x] Decode their info, such as public keys and status bytes
[x] Import or create your own accessory keys
[x] Both async and sync APIs

📥 Installation

The package can be installed from PyPi:

pip install findmy

For usage examples, see the examples directory. We are also building out a CLI. Try python -m findmy to see the current state of it. Documentation can be found here.

🤝 Contributing

Want to contribute code? That's great! For new features, please open an issue first so we can discuss.

This project uses Ruff for linting and formatting. Before opening a pull request, please ensure that your code adheres to these rules. There are pre-commit hooks included to help you with this, which you can set up as follows:

pip install uv
uv sync  # this installs ruff & pre-commit into your environment
pre-commit install

After following the above steps, your code will be linted and formatted automatically before committing it.

🧠 Derivative projects

There are several other cool projects in the FindMy space! You can check them out here.

🏅 Credits

While I designed the library, the vast majority of actual functionality is made possible by the following wonderful people and organizations:

@seemo-lab for OpenHaystack and their research;
@JJTech0130 for Pypush, providing the breakthrough necessary for getting this to work without a Mac;
@biemster for FindMy, which is the main basis of this project;
@Dadoum for pyprovision and anisette-v3-server;
@nythepegasus for GrandSlam SMS 2FA;
And probably more, so let me know! :D

FindMy.py

Install / Use

README