malmeloo/FindMy.py
Fork: 35 Star: 1212 (更新于 2024-12-23 23:00:45)
license: MIT
Language: Python .
🍏 + 🎯 + 🐍 = Everything you need to query Apple's FindMy network!
最后发布版本: v0.7.5 ( 2024-09-18 22:53:03)
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.
[!IMPORTANT] This project is currently in Alpha. While existing functionality will likely not change much, the API design is subject to change without prior warning.
You are encouraged to report any issues you can find on the issue tracker!
Features
- Cross-platform: no Mac needed
- Fetch and decrypt location reports
- Official accessories (AirTags, iDevices, etc.)
- Custom AirTags (OpenHaystack)
- Apple account sign-in
- SMS 2FA support
- Trusted Device 2FA support
- Scan for nearby FindMy-devices
- Decode their info, such as public keys and status bytes
- Import or create your own accessory keys
- Both async and sync APIs
Roadmap
- Local anisette generation (without server)
- More information: #2
Installation
The package can be installed from PyPi:
pip install findmy
For usage examples, see the examples directory. 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 poetry
poetry install --with dev # 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.
Derivative projects
There are several other cool projects based on this library! Some of them have been listed below, make sure to check them out as well.
- OfflineFindRecovery - Set of scripts to be able to precisely locate your lost MacBook via Apple's Offline Find through Bluetooth Low Energy.
- SwiftFindMy - Swift port of FindMy.py
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
最近版本更新:(数据更新于 2024-12-23 22:25:53)
2024-09-18 22:53:03 v0.7.5
2024-09-04 23:28:29 v0.7.4
2024-08-04 23:46:11 v0.7.3
2024-08-02 20:43:01 v0.7.2
2024-08-02 02:48:39 v0.7.1
2024-07-22 03:32:34 v0.7.0
2024-07-21 19:35:38 v0.6.2
2024-07-12 03:21:28 v0.6.1
2024-04-27 22:51:00 v0.6.0
2024-03-01 01:33:58 v0.5.0
主题(topics):
airtag, find-my, openhaystack
malmeloo/FindMy.py同语言 Python最近更新仓库
2024-12-24 23:43:34 home-assistant/core
2024-12-24 19:27:42 ultralytics/ultralytics
2024-12-24 07:53:44 yt-dlp/yt-dlp
2024-12-23 19:54:46 Zipstack/unstract
2024-12-22 18:18:34 LeslieLeung/heimdallr
2024-12-21 13:26:40 notepad-plus-plus/nppPluginList