Grapefruit: Runtime Application Instruments for iOS

Get Started

Dependencies

Grapefruit requires node.js to be installed. If you can't install the frida-node dependency, please check out the troubleshooting section to choose another version of NodeJS.

Setup frida on your iOS device: https://www.frida.re/docs/ios/

Start Cydia and add Frida’s repository by going to Manage -> Sources -> Edit -> Add and enter https://build.frida.re. You should now be able to find and install the Frida package which lets Frida inject JavaScript into apps running on your iOS device. This happens over USB, so you will need to have your USB cable handy, though there’s no need to plug it in just yet.

Setup

Grapefruit is not on npm as igf! Interprets as iGrapefruit or maybe iOS Graphical Frida

npm install -g igf

Now you have the grapefruit cli as igf:

~ igf --help

Usage: igf [options]

Options:
  -h, --host <string>  hostname (default: "127.0.0.1")
  -p, --port <number>  port of the server side (default: 31337)
  --help               display help for command

Default URL for the web UI is http://localhost:31337

Security Warning

At this moment, grapefruit has no authentication. It's possible to use it to inject arbitrary code to your iPhone for anyone that has the access to the web UI. Please limit it to localhost as much as possible. Contribution welcomed.

For Development

Git clone:

git clone --recurse-submodules https://github.com/ChiChou/Grapefruit

Install dependencies:

• tmux (or Windows Terminal on Windows)

Install npm packages:

npm install

Start development server:

npm run dev

Default webpack url is http://localhost:8080

Troubleshooting

• How do I decide which version of nodejs to use?
• Frida CRITICAL: No such interface re.frida.HostSession*

Discord Group

If you have experienced anything wrong or want to suggest new features, please join my Discord channel! https://discord.gg/pwutZNx

Roadmap

https://github.com/ChiChou/Grapefruit/projects/1