Skip to main content

Grindr Python Client

Project description

Grindr

A silly little library to connect to Grindr's mobile services.

Stars Forks Issues

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

  1. Install the module via pip from the PyPi repository
pip install Grindr
  1. Create your first chat connection
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

See also the full list of contributors who have participated in this project.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

grindr-0.1.6.tar.gz (25.7 kB view details)

Uploaded Source

Built Distribution

Grindr-0.1.6-py3-none-any.whl (41.4 kB view details)

Uploaded Python 3

File details

Details for the file grindr-0.1.6.tar.gz.

File metadata

  • Download URL: grindr-0.1.6.tar.gz
  • Upload date:
  • Size: 25.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.0 CPython/3.12.0

File hashes

Hashes for grindr-0.1.6.tar.gz
Algorithm Hash digest
SHA256 86a24233fcad02691087f1f410cc336c423be2ed5a2bcf0f694a2954c95383d9
MD5 c83bd015c983585e8db9e3ff92aa5fe8
BLAKE2b-256 4d1b2ca9fc847eccb8bdc78393be390705235434684120998011844f1829c9ed

See more details on using hashes here.

File details

Details for the file Grindr-0.1.6-py3-none-any.whl.

File metadata

  • Download URL: Grindr-0.1.6-py3-none-any.whl
  • Upload date:
  • Size: 41.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.0 CPython/3.12.0

File hashes

Hashes for Grindr-0.1.6-py3-none-any.whl
Algorithm Hash digest
SHA256 02cefe91fa6cdf1cf916ca1eb0f5987d0957385d295e6291176d9386a7568102
MD5 ca9135fa4843f86884f2d353060fc75c
BLAKE2b-256 f18ef6df0a573347296feb3a750d8abc72d9487987d13a0e8941e4e060d4d2ee

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page