Skip to content

Theos Integration

Marco Lancini edited this page Nov 25, 2016 · 3 revisions

The hooking/theos/theos_tweak is a bit different from the other modules, as it offers more execution types other than the usual run.

Configuration

First of all, this module needs a bit of configuration:

[needle][theos_tweak] > show options

  Name              Current Value  Required  Description
  ----------------  -------------  --------  -----------
  PACKAGE_NAME      ios.mwr.test   yes       Package Name [com.yourcompany.test]
  PROGRAM           VIM            yes       Select the program to use for editing files. Currently supported: VIM, NANO
  PROJECT_NAME      test           yes       Project name
  SUBSTRATE_FILTER  mwr.ios.gobby  no        MobileSubstrate Bundle filter [com.apple.springboard]
  TERMINATE_APP                    no        List of applications to terminate upon installation (space-separated) [SpringBoard]

The module has some options:

  • PACKAGE_NAME: this is the name of the .deb file that is going to be created. Once installed, you can check for its presence by typing the following in a shell: iphone:# dpkg -l
  • PROGRAM: the editor you want to use to modify the Tweak
  • PROJECT_NAME: the name of your project
  • SUBSTRATE_FILTER: the Bundle ID of your target application
  • TERMINATE_APP: a space-separated list of apps to terminate upon installation of your Tweak

Execution types

Once configured, you can do multiple things with this module. In particular:

  • [needle][theos_tweak] > run: this will create the Tweak, let you modify its content, and then install the Tweak on your device
  • [needle][theos_tweak] > view: view the content of your Tweak
  • [needle][theos_tweak] > edit: edit and reinstall the Tweak
  • [needle][theos_tweak] > install: (re)install the Tweak
  • [needle][theos_tweak] > disinstall: disinstall the Tweak