An open API service indexing awesome lists of open source software.

https://github.com/R0rt1z2/GrindrPlus

Xposed Module that unlocks and adds unique features to the Grindr app
https://github.com/R0rt1z2/GrindrPlus

Last synced: 13 days ago
JSON representation

Xposed Module that unlocks and adds unique features to the Grindr app

Awesome Lists containing this project

README

        


Grindr Plus Icon


Build
Total downloads
Discord
Telegram


Grindr Plus


Grindr Plus is an Xposed Module that unlocks and adds unique features to the Grindr app, enhancing user experience.

## Introduction
This repository contains a completely rewritten version of [ElJaviLuki's original mod](https://github.com/ElJaviLuki/GrindrPlus), rebuilt from the ground up. It introduces new features, ensures compatibility with the latest Grindr versions, and offers improved performance and functionality.

As the title of the repo suggests, this mod is designed to enhance the user experience, but please note that it’s under active development, so stability is not always guaranteed.

Neither I ([@R0rt1z2](https://github.com/R0rt1z2)) nor any contributors listed here are affiliated with Grindr LLC. For any important inquiries related to this repository, feel free to reach out to me directly at [email protected].

Use this mod at your own discretion, and be aware that future updates may introduce changes or require further adjustments.

## Disclaimer
This mod is provided for free with no warranty of any kind. Use at your own risk! We are not responsible for lost chats, user data, unexpected bans or any other problems incurred from the use of this module.

This mod does not collect any personal data nor does it display ads of any kind. No earnings are generated or collected from the use of this software. This project is open source so you can check all these facts by your own!

## Downloads
* You can download the latest stable release by visiting the [releases page](https://github.com/R0rt1z2/GrindrPlus/releases).
* You can grab the most recent CI build from the [actions section](https://github.com/R0rt1z2/GrindrPlus/actions) or join our [Telegram CI channel](https://t.me/GrindrPlus).

## Features

Chat

- `Built-in command console (see /help)`
- `Start video calls in new chats`
- `Prevent others from seeing chat indicators`
- `Remove any message, no matter how old it is`

Media

- `Unlimited expiring photos`
- `View all albums you've received`
- `Ability to take screenshots`

Global

- `Ability to see ban details`
- `Ability to spoof Android ID`
- `Removed most analytics`
- `Unlock developer special features`
- `Built-in mod settings to manage hooks`
- `Disable forced app updates (extend mod lifespan)`

Profiles

- `Body mass index (BMI)`
- `Indicator for boosted users`
- `Ability to copy profile ID`
- `More accurate distance`
- `Hidden (server) profile fields`
- `More accurate online status`
- `Customize favorites layout`

Location

- `Quick teleporting`
- `Location spoofing`
- `Save and manage locations`

Premium

- `Unlimited cascade view`
- `Unlocked "Explore Mode"`
- `Advanced search filters`
- `ZERO third-party ads`
- `Saved chat phrases`
- `Disable boosting upsells`
- `Hide your own views`
- `Incognito mode`

## Bugs
* Incognito mode is kinda buggy (it turns off after a little while).
* On non LSPosed installs (no root), Google Login and Maps inside Grindr require a workaround (see the FAQ section).

## Installation
> [!WARNING]
> _Each Grindr Plus release supports only a specific Grindr app version and quite possibly will not work with any other.
_

GrindrPlus supports both **LSPosed** and **LSPatch**, though the latter comes with additional bugs, which are documented in the bugs section.

Each installation method is completely different and comes with its own challenges, so make sure to read the guide carefully and thoroughly. Open the dropdown for the method you plan to use to continue with the installation.

No root

**Prerequisites:**
- No Grindr installed on device

**Process:**
1. Download & Install the GrindrPlus module APK (check the [downloads](https://github.com/R0rt1z2/GrindrPlus?tab=readme-ov-file#downloads) section of this `README`).
2. If the Grindr app is installed, uninstall it. **Make sure it's also gone from Secure Folder, Second Space or Private Space**.
3. Open the new "Grindr Plus" app and click on the "Install" button (bottom left).
4. Wait for the versions to load (if loading seems stuck, force close app & retry).
5. Select your preferred version (we recommend using latest).
6. Click on the "Install" button.
7. Wait for the installation to complete. Duration will depend on connection speed and phone's specs.
8. When prompted, install the newly generated Grindr app.
9. The app might crash multiple times during the first launches. This is normal, just keep relaunching it.
10. If the installation fails, retry it multiple times before asking for support.


Root (LSPosed)

> **Make sure you're using [JingMatrix's fork of LSPosed](https://github.com/R0rt1z2/LSMirror/raw/refs/heads/main/LSPosed-v1.10.1-7167-zygisk-release.zip)!**

**Requirements:**
- Rooted using `Magisk` or `KernelSU`
- `LSPosed` installed and fully functional

**Process:**
1. Install the GrindrPlus module APK (check the [downloads](https://github.com/R0rt1z2/GrindrPlus?tab=readme-ov-file#downloads) section of this `README`)
2. Download the latest Grindr app [from Play Store](https://play.google.com/store/apps/details?id=com.grindrapp.android&hl=en) or use [SAI](https://github.com/Aefyr/SAI/releases) to install [bundles from APKMirror](https://www.apkmirror.com/apk/grindr-llc/grindr-gay-chat-meet-date/)
3. Turn on the module in `LSPosed` and make sure Grindr is in scope
4. Open Grindr and check if Mod Settings are at the top of Grindr settings

## FAQ & Troubleshooting

How do I login with Google?

- If you're not using LSPosed you might have noticed that the Google Login button doesn't work. This is because the original signature of the application is invalidated when using LSPatch, which causes all functions related to Google Services (GMS) to not work properly.
- In order to fix that, you have to:
1. Uninstall the patched Grindr app.
2. Reinstall the original Grindr app (either from the Play Store or the official APK).
3. Reboot your device (this is optional, but **HIGHLY RECOMMENDED**).
4. Log in using your Google account.
5. Uninstall the original Grindr app.
6. Install the app again with GrindrPlus.
7. Open the patched app and log in with Google **within 10 minutes**. If you wait too long, **the login will fail**.
8. You should now be able to log in successfully using Google.
- NOTE: **You'll need to repeat this process every time you want to log in with Google**.

Maps not loading on LSPatch version?

- For LSPatch users, the Maps functionality in Grindr won't work properly due to signature validation issues. To fix this, you'll need to set up a custom Google Maps API key.
- Here's how to set up a Google Maps API Key:
1. Go to the Google Cloud Console at https://console.cloud.google.com/. You may need to log in with your Google account if you're not already.
2. Select or create a new Google Cloud project to associate your API key with. If creating a new project, give it a name and ID. What you call the project is not important. Wait a few seconds for the project to be created.
3. Make sure your new project is selected in the top dropdown menu, then open the navigation sidebar and go to "APIs & Services" > "Credentials".
4. On the Credentials page, click "+ Create Credentials" and choose "API key" from the dropdown.
5. Your new API key will be displayed. Click "Close" to return to the Credentials list. You should see your key listed under "API Keys".
6. Click "Edit API key" to set up restrictions. You can give it a name, choose which websites or IP addresses can use it, and set an expiration date. For use with GrindrPlus, you should not set restrictions.
7. Copy your API key and add it into the Grindr Plus settings for the Maps API Key.
8. Use the install button in Grindr Plus to setup Grindr and the Maps API key.
- NOTE: **You may be prompted for credit card details by Google, even though use of the Maps API is part of their 'free tier'.**

My Grindr app suddenly stops / crashes when the module is installed!

- Make sure you're using a good LSPatch/LSPosed version (official are broken on latest Android versions). Consider switching to [JingMatrix's fork](https://github.com/JingMatrix) if you haven't already.
- Check if the module supports the app version. Grindr has lots of obfuscated symbols that change in each app update and the module couldn't work (or couldn't work properly).

I've updated to newer Android version and LSPosed/LSPatch stopped working!

- The development of LSPosed/LSPatch is currently frozen and that is why, no new updates have been released to support new Android versions. Make sure you're using [JingMatrix's fork](https://github.com/JingMatrix), which works with latest updates.

I can't see profiles, whenever I open them they're blank!

- This most likely means you're using an AdBlocker (e.g. AdAway). Disable it or whitelist `cdn.cookielaw.org`.

I'm using LSPatch and I can't login with Google!

- As mentioned above, when using LSPatch the original signature of the application is invalidated which causes all functions related to Google Services (GMS) to not work properly.

Can I get banned with this?

- [Obviously](https://www.grindr.com/terms-of-service), however, the risk is very low, and there have been no reported cases of bans related to using this mod.

Where can I download the latest stable build?

- https://github.com/R0rt1z2/GrindrPlus/releases

Can I suggest a new feature?

- Feel free to, but keep in mind that every feature, no matter how small, has a lot of work behind it, so please be patient and understand that sometimes it is impossible to implement certain things due to the nature of how LSPosed works.
- Make sure to use our feature requests template, otherwise your inquiry will be ignored.

I'm having issues on GrapheneOS!

- Uninstall Google Play "trio" (framework, services, store) in "apps" app and reinstall them again. They break all the time so it's a good idea to reload them. Don't worry, you won't have to login again to Google.
- Make sure to turn **ON** the exploit protection compatibility mode in "App Info" of Grindr, GrindrPlus and Google Play "trio". Just tap and hold onto the app icon to go there. When it comes to Google services you can do so from "apps" app.
- While doing the step above make sure to give Google Play services permissions to access location all the time and sensors.
- In Settings -> Apps -> Sandboxed Google Play, turn off the option "Reroute location requests to OS".

## Acknowledgments
Big part of the credit goes to [ElJaviLuki](https://github.com/ElJaviLuki/GrindrPlus), the creator of the original idea and mod — this project wouldn’t exist without his initial work.

This project relies on several third-party libraries, and we extend our gratitude to their authors for their valuable contributions. For a complete list of these dependencies, please refer to the [dependencies](https://github.com/R0rt1z2/GrindrPlus/blob/master/app/build.gradle.kts#L67-L79) section of the `build.gradle.kts` file.

Parts of the manager were coded with the help of [Vendetta's Manager](https://github.com/vendetta-mod/VendettaManager).

I would also like to give special recognition to [@rhunk](https://github.com/rhunk) and the other developers of [SE](https://github.com/rhunk/SnapEnhance). Their work has been very useful for this mod, and some portions of their code have been used here.

## Contributing
This project is open to any kind of contribution. Feel free to [open a pull request](https://github.com/R0rt1z2/GrindrPlus/pulls) or [submit an issue](https://github.com/R0rt1z2/GrindrPlus/issues)! [Discussions section](https://github.com/R0rt1z2/GrindrPlus/discussions) also available!

## Donations
I don't usually ask for donations, but if you really want to support me, you can do so by sending me a coffee!

[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/r0rt1z2)

[![PayPal](https://cdn.rawgit.com/twolfson/paypal-github-button/1.0.0/dist/button.svg)](https://www.paypal.me/R0rt1z2/)

## Related resources
- [Official XDA thread](https://forum.xda-developers.com/t/mod-xposed-new-grindr-plus.4461857/#post-87076193)
- [Downloads for Grindr (APKMirror)](https://www.apkmirror.com/apk/grindr-llc/grindr-gay-chat-meet-date)
- [JingMatrix's LSPosed fork](https://github.com/JingMatrix/LSPosed)
- [JingMatrix's LSPatch fork](https://github.com/JingMatrix/LSPatch)

## License
This project is distributed under the GPL-3.0 License. For more information, simply refer to the [LICENSE](https://github.com/R0rt1z2/GrindrPlus/blob/master/LICENSE) file. Please note that the [`old_base`](https://github.com/R0rt1z2/GrindrPlus/tree/old_base) branch is not subjected to any license, as the original author did not assign or attribute one.

As an open source project, you're free to inspire yourself from this code. However, please **DON'T copy it and release it as your own (kanging)**. Give the proper credit and reference to the [original project](https://github.com/R0rt1z2/GrindrPlus) and its [contributors](https://github.com/R0rt1z2/GrindrPlus/graphs/contributors).