FindMy.py/README.md

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 new accessory keys
• Import accessory keys
• Fully async
• 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.
• Sync API wrapper
  • I realize not everyone may be comfortable using an async library; building a synchronous wrapper around the AppleAccount class would be nice.

Installation

TODO

Credits

While I designed the library, the vast majority of the 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