Grindr
==================
A silly little library to connect to Grindr's mobile services.
## If You Work at Grindr
- Send me a message `info@isaackogan.com` for any questions/concerns.
- If you are hiring, send an e-mail. Let's chat :)!
## Table of Contents
- [Getting Started](#getting-started)
- [Licensing](#license)
- [Contributors](#contributors)
## Getting Started
1. Install the module via pip from the [PyPi](https://pypi.org/project/Grindr/) repository
```shell script
pip install Grindr
```
2. Create your first chat connection
```python
from Grindr import GrindrClient
from Grindr.events import ConnectEvent, MessageEvent
# Create the client
client: GrindrClient = GrindrClient()
# Listen to an event with a decorator!
@client.on(ConnectEvent)
async def on_connect(_: ConnectEvent):
print(f"Connected to Grindr!")
# Or, add it manually via "client.add_listener()"
async def on_message(event: MessageEvent) -> None:
if not event.type == "Text":
return
print(f"{event.senderId} -> {event.body.text}")
client.add_listener(MessageEvent, on_message)
if __name__ == '__main__':
# Run the client and block the main thread
# await client.start() to run non-blocking
client.run(
email="your@email.com",
password="your_secure_password"
)
```
### Helpful Tips
- Access all web-scraping methods with `client.web`
- Send messages with `await client.send(...)`
- Use proxies. Cloudflare WAF likes to ban IPs.
## Contributors
* **Isaac Kogan** - *Creator, Primary Maintainer, and Reverse-Engineering* - [isaackogan](https://github.com/isaackogan)
See also the full list of [contributors](https://github.com/isaackogan/Grindr/contributors) who have participated in
this project.
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
Raw data
{
"_id": null,
"home_page": "https://github.com/isaackogan/Grindr",
"name": "Grindr",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "Grindr, Grindr API, python3, api, unofficial",
"author": "Tricorder",
"author_email": "tricorder@isaackogan.com",
"download_url": "https://files.pythonhosted.org/packages/63/38/bc7b6955ea3214a87b935cb202e79b3c1d38daf65804b7471268219bc482/grindr-0.3.0.post9.tar.gz",
"platform": null,
"description": "Grindr\n==================\nA silly little library to connect to Grindr's mobile services.\n\n\n\n\n\n## If You Work at Grindr\n\n- Send me a message `info@isaackogan.com` for any questions/concerns.\n- If you are hiring, send an e-mail. Let's chat :)!\n\n\n## Table of Contents\n\n- [Getting Started](#getting-started)\n- [Licensing](#license)\n- [Contributors](#contributors)\n\n## Getting Started\n\n1. Install the module via pip from the [PyPi](https://pypi.org/project/Grindr/) repository\n\n```shell script\npip install Grindr\n```\n\n2. Create your first chat connection\n\n```python\nfrom Grindr import GrindrClient\nfrom Grindr.events import ConnectEvent, MessageEvent\n\n# Create the client\nclient: GrindrClient = GrindrClient()\n\n# Listen to an event with a decorator!\n@client.on(ConnectEvent)\nasync def on_connect(_: ConnectEvent):\n print(f\"Connected to Grindr!\")\n\n\n# Or, add it manually via \"client.add_listener()\"\nasync def on_message(event: MessageEvent) -> None:\n \n if not event.type == \"Text\":\n return\n \n print(f\"{event.senderId} -> {event.body.text}\")\n\n\nclient.add_listener(MessageEvent, on_message)\n\nif __name__ == '__main__':\n # Run the client and block the main thread\n # await client.start() to run non-blocking\n client.run(\n email=\"your@email.com\",\n password=\"your_secure_password\"\n )\n```\n\n### Helpful Tips\n\n- Access all web-scraping methods with `client.web`\n- Send messages with `await client.send(...)`\n- Use proxies. Cloudflare WAF likes to ban IPs.\n\n## Contributors\n\n* **Isaac Kogan** - *Creator, Primary Maintainer, and Reverse-Engineering* - [isaackogan](https://github.com/isaackogan)\n\nSee also the full list of [contributors](https://github.com/isaackogan/Grindr/contributors) who have participated in\nthis project.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Grindr Python Client",
"version": "0.3.0.post9",
"project_urls": {
"Homepage": "https://github.com/isaackogan/Grindr"
},
"split_keywords": [
"grindr",
" grindr api",
" python3",
" api",
" unofficial"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "9bb758ca80e8d563f6a4eb0a448666f8b1e56e0773aa600847ec3496e62be655",
"md5": "d4075c200b2479e7198dc9c2ae1a5f9b",
"sha256": "35b76704dafb447e0c936bc5b503420b4cf094e0a9b526c4b13d3dab5ae394e9"
},
"downloads": -1,
"filename": "Grindr-0.3.0.post9-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d4075c200b2479e7198dc9c2ae1a5f9b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 69421,
"upload_time": "2025-01-16T03:46:46",
"upload_time_iso_8601": "2025-01-16T03:46:46.985007Z",
"url": "https://files.pythonhosted.org/packages/9b/b7/58ca80e8d563f6a4eb0a448666f8b1e56e0773aa600847ec3496e62be655/Grindr-0.3.0.post9-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "6338bc7b6955ea3214a87b935cb202e79b3c1d38daf65804b7471268219bc482",
"md5": "523d475ccf2aa56bbba133481f70fcdc",
"sha256": "d9984dd1be95106d2d3d2d9327339a3deb89292a88fcbe9468a1bce0d46843c3"
},
"downloads": -1,
"filename": "grindr-0.3.0.post9.tar.gz",
"has_sig": false,
"md5_digest": "523d475ccf2aa56bbba133481f70fcdc",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 44485,
"upload_time": "2025-01-16T03:46:49",
"upload_time_iso_8601": "2025-01-16T03:46:49.137460Z",
"url": "https://files.pythonhosted.org/packages/63/38/bc7b6955ea3214a87b935cb202e79b3c1d38daf65804b7471268219bc482/grindr-0.3.0.post9.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-16 03:46:49",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "isaackogan",
"github_project": "Grindr",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "build",
"specs": []
},
{
"name": "python-dotenv",
"specs": []
},
{
"name": "twine",
"specs": []
},
{
"name": "setuptools",
"specs": []
}
],
"lcname": "grindr"
}
JSON
