Skip to content
Snippets Groups Projects
Select Git revision
  • main default
1 result
Compare
user avatar
mautrix-imessage integration
EthanRDoesMC authored
bb2c6c69
History
user avatar bb2c6c69
History
Name Last commit Last update
BeeperAppIcon.xcassets
Frameworks
Resources
brooklyn.xcodeproj
layout/DEBIAN
packages
rubicon
xchighlight
.gitignore
BLAppDelegate.h
BLAppDelegate.m
BLMautrixTask.h
BLMautrixTask.m
BLNewChatViewController.h
BLNewChatViewController.m
BLRootViewController.h
BLRootViewController.m
BrooklynBridge.h
BrooklynBridge.m
ChatKit.h
ChatViewController.h
ChatViewController.m
IMCore.h
LogViewController.h
LogViewController.m
Makefile
MessageBuilder.h
MessageBuilder.m
NSTask.h
README.md
SendMessageController.h
SendMessageController.m
control
ent.plist
main.m
nibbuild.sh
setuptheos.sh
README.md

imessage-api-ios a.k.a. Brooklyn

iMessage API and runtime inspection tool for iOS

Components

Rubicon

"The die is cast."

Crosses Apple's last river between IMCore and the rest of the system.

BrooklynBridge

The underlying API. Probably doesn't need to be .xm -- will look at that. Sparse for now, but will have many methods very soon

Brooklyn.app

iMessage runtime inspection tool. Also api testing grounds.

Build

macOS

Xcode

  1. Set up theos.
  2. Open brooklyn.xcodeproj.
  3. Go to the brooklyn target, then click Build Settings
  4. Change THEOS_DEVICE_IP to the Bonjour or IP address of the targeted device.
  5. Change THEOS to your full theos path. No cheating with ~. Do the same in the Makefile. This step won't be needed in the future.
  6. Open a terminal and type ssh-copy-id root@, followed by the address you set in Step 4. The default password for iOS is alpine. (If it gives an error, run ssh-keygen and spam enter, then try again.)
  7. Connect a device to Xcode, select brooklyn>(device) in the tab bar, and click Run!

Optional code highlighting, autocomplete, error checking:

  1. Set the build target to xchighlight>Any iOS Device (armv7, arm64) in the tab bar.
  2. Press Command-B.
  3. When this is done building, set the target back to brooklyn>(device).
  4. Every time you add a source file, go to the brooklyn xcodeproj in Xcode, click the xchighlight target, click Build Phases, and add it to the appropriate phase.

make

  1. Set up theos.
  2. Open the makefile.
  3. At the top, add: export THEOS_DEVICE_IP = , followed by your device's Bonjour or IP address.
  4. Open a terminal to the brooklyn folder.
  5. Run ssh-copy-id root@, followed by the address from Step 3. The default password is alpine. (If it gives an error, run ssh-keygen and spam enter, then try again.)
  6. Run make clean do.

Notes

If you make changes to .xib files, make sure to commit the built .nib files in the Resources folder as well. That way, other platforms can build without Xcode. This will not be a requirement in the future.

Linux / Windows

I'll add these instructions soon. I don't have theos set up on Windows. I also don't have a Linux install yet. For shame, I know, for shame! :P