Skip to content

Commit 6b95ec5

Browse files
authored
Merge pull request #150 from malmeloo/repo/add-assets
repo: add assets
2 parents 353ef61 + d0288eb commit 6b95ec5

5 files changed

Lines changed: 37 additions & 25 deletions

File tree

README.md

Lines changed: 34 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,32 @@
1-
# FindMy.py
2-
3-
[![](https://img.shields.io/pypi/v/FindMy)](https://pypi.org/project/FindMy/)
4-
[![](https://img.shields.io/pypi/dm/FindMy)](#)
5-
[![](https://img.shields.io/github/license/malmeloo/FindMy.py)](LICENSE.md)
6-
[![](https://img.shields.io/pypi/pyversions/FindMy)](#)
7-
8-
<details>
9-
<summary>Star History</summary>
10-
<a href="https://news.ycombinator.com/item?id=42479233"><img src="https://api.star-history.com/svg?repos=malmeloo/FindMy.py&type=Date" /></a>
11-
</details>
12-
13-
The all-in-one library that provides everything you need
14-
to query Apple's FindMy network!
15-
1+
<div align="center">
2+
<img alt="FindMy.py Logo" src="assets/icon.png" width="500">
3+
<h1>FindMy.py</h1>
4+
</div>
5+
6+
<div align="center">
7+
8+
_Query Apple's FindMy network with Python!_
9+
10+
<h5>
11+
<a href="https://docs.mikealmel.ooo/FindMy.py">
12+
Docs
13+
</a>
14+
<span> | </span>
15+
<a href="examples/">
16+
Examples
17+
</a>
18+
<span> | </span>
19+
<a href="https://pypi.org/project/FindMy/">
20+
PyPI
21+
</a>
22+
<span> | </span>
23+
<a href="issues/">
24+
Issue Tracker
25+
</a>
26+
</h5>
27+
</div>
28+
29+
## 🚀 Overview
1630
The current "Find My-scene" is quite fragmented, with code
1731
being all over the place across multiple repositories,
1832
written by [several authors](#Credits). This project aims to
@@ -27,7 +41,7 @@ application wishing to integrate with the Find My network.
2741
> You are encouraged to report any issues you can find on the
2842
> [issue tracker](https://github.com/malmeloo/FindMy.py/issues/)!
2943
30-
### Features
44+
## 🧪 Features
3145

3246
- [x] Cross-platform: no Mac needed
3347
- [x] Fetch and decrypt location reports
@@ -41,12 +55,7 @@ application wishing to integrate with the Find My network.
4155
- [x] Import or create your own accessory keys
4256
- [x] Both async and sync APIs
4357

44-
### Roadmap
45-
46-
- [ ] Local anisette generation (without server)
47-
- More information: [#2](https://github.com/malmeloo/FindMy.py/issues/2)
48-
49-
## Installation
58+
## 📥 Installation
5059

5160
The package can be installed from [PyPi](https://pypi.org/project/findmy/):
5261

@@ -58,7 +67,7 @@ For usage examples, see the [examples](examples) directory.
5867
We are also building out a CLI. Try `python -m findmy` to see the current state of it.
5968
Documentation can be found [here](http://docs.mikealmel.ooo/FindMy.py/).
6069

61-
## Contributing
70+
## 🤝 Contributing
6271

6372
Want to contribute code? That's great! For new features, please open an
6473
[issue](https://github.com/malmeloo/FindMy.py/issues) first so we can discuss.
@@ -76,7 +85,7 @@ pre-commit install
7685
After following the above steps, your code will be linted and formatted automatically
7786
before committing it.
7887

79-
## Derivative projects
88+
## 🧠 Derivative projects
8089

8190
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.
8291

@@ -87,7 +96,7 @@ There are several other cool projects based on this library! Some of them have b
8796
* [OpenTagViewer](https://github.com/parawanderer/OpenTagViewer) - Android App to locate your AirTags.
8897
* [Find My Dad](https://github.com/NickCrews/findmydad) - Geofencing application for AirTags using Google Sheets and SMS.
8998

90-
## Credits
99+
## 🏅 Credits
91100

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

assets/banner.png

2.41 MB
Loading

assets/icon.gox

21.4 KB
Binary file not shown.

assets/icon.png

260 KB
Loading

pyproject.toml

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -80,6 +80,9 @@ ignore = [
8080
"D", # documentation
8181
]
8282

83+
[tool.setuptools]
84+
py-modules = ["findmy"]
85+
8386
[build-system]
8487
requires = ["setuptools", "setuptools-scm"]
8588
build-backend = "setuptools.build_meta"

0 commit comments

Comments
 (0)