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.0.9.tar.gz (24.8 kB view hashes)

Uploaded Source

Built Distribution

Grindr-0.0.9-py3-none-any.whl (40.2 kB view hashes)

Uploaded Python 3

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