Free Grind

An unofficial, cross-platform Grindr client — free, libre, ad-free, tracker-free, and community-driven.

Introduction

Free Grind is a fully independent Grindr client built with Tauri and React, running the same codebase on Windows, Linux, macOS, Android, and iOS. It is not a mod or patch of the official app — it communicates directly with the Grindr API as a native client.

The goal is to provide a privacy-respecting, open, and extensible alternative to the official client, without ads, trackers, or forced upsells.

Free Grind is under active development. Stability is not always guaranteed, and some features are still in progress. See ROADMAP.md for what's planned.

Neither the maintainers nor contributors are affiliated with Grindr LLC.

Disclaimer

This project is provided with no warranty of any kind. Use at your own risk. We are not responsible for lost chats, account issues, unexpected bans, or any other problems arising from use of this software.

Free Grind does not collect personal data, display ads, or generate revenue of any kind. This project is open source — you can verify all of this yourself.

Downloads

• Download the latest stable release from the releases page.
• You can build the latest version yourself by following the Development guide below.

Features

Browse

• Nearby profile grid (cascade view)
• Profile detail modal with full stats
• Location spoofing / manual location picker
• Search profiles with filters

Chat

• Full inbox with conversation list
• Real-time messaging via WebSocket
• Text messages, image sharing, albums
• Pin, mute, and delete conversations
• Message reactions
• Inbox filters (unread, favorites, online, etc.)

Profiles

• Full profile viewer (stats, health, tribes, tags)
• Profile photo gallery
• Edit your own profile
• Manage profile photos

Privacy & Freedom

• Zero ads
• Zero trackers
• No forced upsells
• No artificial profile limits

Bugs

Warning

Please read this section before reporting bugs. Some issues are known limitations of the current development stage.

• Android / iOS: Mobile builds are functional but less tested than desktop.
• Media uploads: Binary upload support requires correct content-type handling; some edge cases may fail.
• Real-time events: Some WebSocket event types are still WIP and may not be handled.
• Profile fields: Some server-side fields are undocumented and may display incorrectly.

Tip

Bug reports and feature requests are tracked on our website: freegrind.imaoreo.dev/issues. Please check there first to see if your issue is already known before opening a new one. For community discussion, join us on Discord.

Development

Interested in contributing? Head to CONTRIBUTING.md to get started.

Local Setup

bun install

Common Commands

# Desktop (Tauri + Vite)
bun run dev

# Web only
bun run dev:web

# Android dev
bun run dev:android

# iOS dev (simulator configurable via IOS_SIMULATOR)
bun run dev:ios

# Android APK build
bun run build:android:apk

# iOS IPA build
bun run build:ios:ipa

All Tauri commands are routed through shell scripts in scripts and use Bun (bunx) instead of pnpm/nix workflows.

All contributions must be aligned with CODE_OF_CONDUCT.md.

The API reference documentation lives in docs/ and is hosted at https://freegrinddocs.imaoreo.dev/ — contributions to reverse engineering and documentation are especially valued.

FAQ & Troubleshooting

Can I get banned for using this?

Using any unofficial client technically violates Grindr's Terms of Service. The risk is low, but it exists. Use at your own discretion.

Does this work on iOS?

iOS builds are supported via Tauri but are less tested. You will need to build from source and sideload the app.

Why isn't feature X implemented yet?

Free Grind is community-driven and under active development. Check the ROADMAP.md for planned features, or open a feature request.

Where is the API documentation?

The Grindr API reference is maintained in this repo under docs/content/grindr-api/ and hosted at freegrinddocs.imaoreo.dev.

Contributing

This project is open to all kinds of contributions — code, documentation, bug reports, and reverse engineering.

• Code contributions: open a pull request on GitHub.
• Bug reports & feature requests: submit them on our website at freegrind.imaoreo.dev/issues.
• Community discussion & support: join us on Discord.

Donate

If you'd like to support the project, see FUNDING.md.

License

Personal Use Licence