Query Apple's FindMy network with Python

Hey everyone! I'm the author of FindMy.py. I'd like to use this moment to give a shout-out to some other people that deserve way more credit than me, as the project definitely would not have existed without them. If this stuff interests you then please do check them out, there is a dedicated section in the project's README (https://github.com/malmeloo/FindMy.py?tab=readme-ov-file#cre...).

If you have any questions, feel free to ask :-)

Could you please include some usage examples in the README?

There is an examples directory that covers basic usage: https://github.com/malmeloo/FindMy.py/tree/main/examples

Official docs: https://docs.mikealmel.ooo/FindMy.py/

I realize that the docs are rather empty right now; it takes a lot of time to turn my thoughts into text, which I do not really have at the moment. Contributions are welcome, of course ;-)

Congrats ! I don't have an iPhone or Mac. Can I buy an AirTag, initialize it with the help of a friend who has an iPhone, and then locate the AirTag or ring it from my PC with this Python lib?

I don't see how you would get the private key for the airtag off the iPhone without jailbreaking it. The readme of the project implies you can do this but the docs are completely lacking

Any idea why the latest version on pypa is 0.2.x. That seems like it was released a while ago.

The latest version is 0.7.5: https://pypi.org/project/FindMy/

Sorry for the lacking docs; this has just been a little side project of mine and isn't supposed to be ready for the large public yet. Hence why I'm not the original submitter :-)

You don't need a jailbroken iPhone; a Mac or hackintosh should be sufficient. Some pointers to public discussions:

- https://github.com/malmeloo/FindMy.py/issues/4

- https://github.com/malmeloo/FindMy.py/issues/31

In the long term I would like to be able to pull the shared secrets directly from the iCloud keychain without having to use a mac, but the reverse engineering efforts are not quite there yet.

I responded to your other comment, but for other people who have the same question:

https://news.ycombinator.com/item?id=42482974

Ah! I know what it is! https://github.com/malmeloo/FindMy.py/blob/main/pyproject.to...

I've Python 3.13.1, so it drops down and installs FindMy 0.2.x

Oops sorry, that's unintentional. I've fixed this in the source, the next pypi release should support 3.13.