https://github.com/n3d1117/grouppy
An iOS patch to make Mach-O binaries use the real application groups entitlements evaluated at runtime.
https://github.com/n3d1117/grouppy
dylib entitlements macho theos
Last synced: 7 months ago
JSON representation
An iOS patch to make Mach-O binaries use the real application groups entitlements evaluated at runtime.
- Host: GitHub
- URL: https://github.com/n3d1117/grouppy
- Owner: n3d1117
- License: mit
- Created: 2020-09-25T18:00:20.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2020-10-02T15:23:53.000Z (over 5 years ago)
- Last Synced: 2025-02-28T08:29:03.980Z (over 1 year ago)
- Topics: dylib, entitlements, macho, theos
- Language: Shell
- Homepage:
- Size: 15.6 KB
- Stars: 7
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Grouppy
An iOS patch to make Mach-O binaries use the real application groups entitlements evaluated at runtime.
## Requirements
* `insert_dylib` binary placed in root folder, you can find it [here](https://github.com/Tyilo/insert_dylib)
* `theos` installed on your machine, [see installation guide here](https://github.com/theos/theos/wiki/Installation)
* A decrypted iOS application you wish to patch
## Usage
* Extract the `grouppy.dylib` file from theos tweak in `grouppy` folder, either by compiling it manually, by executing `./extract_dylib_here.sh` script, or by downloading a precompiled version from the [releases](https://github.com/n3d1117/Grouppy/releases/latest) page.
* Copy `grouppy.dylib` and `CydiaSubstrate.framework` to the `Frameworks` folder of the app (in `Payload/XXX.app/`)
* Add the `Frameworks` folder to the runtime search path of the binary file:
```bash
install_name_tool -add_rpath "@executable_path/Frameworks" PATH_TO_BINARY_FILE
```
* Point the `CydiaSubstrate` path linked in `grouppy.dylib` to the `Frameworks` folder:
```bash
install_name_tool -change /Library/Frameworks/CydiaSubstrate.framework/CydiaSubstrate @rpath/CydiaSubstrate.framework/CydiaSubstrate Frameworks/grouppy.dylib
```
* Finally, run the following command to inject the library into the Mach-O binary you wish to patch:
```bash
./insert_dylib --inplace --all-yes "@executable_path/grouppy.dylib" PATH_TO_BINARY_FILE
```
* Done!
## Work with .ipa files or .app folders
If your app contains plugins, you may want to inject Grouppy into them as well, otherwise they won't be able to communicate with the main app because of the different application groups. Another script is included, `inject_grouppy.sh`, to demonstrate injecting Grouppy into all Mach-O binaries of a given `.ipa` file or `.app` folder (i.e. app binary and each plugin in the `PlugIns` folder). NOTE: the script will overwrite the original `ipa` file or `.app` folder.
Usage: `./inject_grouppy.sh PATH_TO_IPA_FILE_OR_APP_FOLDER`.
## License
MIT License. See [LICENSE](LICENSE) file for further information.