README.md

Lucy

This injects a LuaJIT interpreter into SpringBoard which can be controlled using the lucy command.

You can also edit res/LucyServer.plist to make it inject wherever you want.

Goals

• Painless Objective-C integration
  • Achieved with objc.lua (still a bit painful, though)
  • TODO:
    • Implicit typecasting
    • Fix C struct support
• choose() function Achieved with Objective Beagle
  • e.g. beagle('UIWindow')
• Inject into any process

Installation

Add http://cydia.r333d.com as a Cydia repo, and install the Lucy package from there.

Building

Requirements

• Mac OS X
• LuaJIT (brew install luajit)

The commands you need to run

1: Clone aite and put it somewhere

git clone https://github.com/rweichler/aite.git

2: Clone this and put it somewhere

git clone https://github.com/rweichler/lucy.git

3: cd into this repo and run aite

cd lucy
/PATH/TO/AITE/main.lua

That creates a new file lucy.deb which you can install on your device.

Running

Injecting into SpringBoard

Go into terminal, type the lucy default command. Get Objective-C and Beagle by doing:

objc = require 'objc'
beagle = require 'beagle'