FindMy 0.2.1

Everything you need to query Apple's Find My network!

FindMy.py

The all-in-one library that provides everything you need to query Apple's FindMy network!

The current "Find My-scene" is quite fragmented, with code being all over the place across multiple repositories, written by several authors. This project aims to unify this scene, providing common building blocks for any application wishing to integrate with the Find My network.

Features

• Works without any Apple devices
• Apple Account log-in
• SMS 2FA support
• Fetch location reports
• Generate and import accessory keys
• Both async and sync API
• Modular with a high degree of manual control

Roadmap

• Trusted device 2FA
  • Work has been done, but needs testing (I don't own any Apple devices)
• Local anisette generation (without server)
  • Can be done using pyprovision, however I want to wait until Python wheels are available.

Installation

The package can be installed from PyPi:

pip install findmy

For usage examples, see the examples directory. Documentation coming soon™.

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 poetry ruff
poetry install  # this installs pre-commit into your environment
pre-commit install

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

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