This is a fork of Cycript in which we replaced its runtime with a brand new runtime called Mjølner powered by Frida. This enables frida-cycript to run on all the platforms and architectures maintained by frida-core.
Cycript is an awesome interactive console for exploring and modifying running applications on iOS, Mac, and Android. It was created by @saurik and essentially consists of four parts:
We didn't touch any other aspects of Cycript or did so with minimal changes.
We went out of our way to avoid touching the compiler, and also left the user interface mostly untouched, only adding extra CLI switches for things like device selection. We did, however, mostly rewrite the Cydia Substrate module so existing scripts relying on this will get the portability and performance boost offered by Frida's instrumentation core.
We will be maintaining this fork and intend to stay in sync with user interface and language improvements made upstream.
WE believe the main advantage is portability, but also think you should consider:
Our runtime doesn't yet support all the features that upstream's runtime does, but we are working hard to close this gap. Please file issues if something you rely on isn't working as expected.
Yes. You should already be able to do this by running frida-server on Windows and connecting to it with Cycript on your UNIX system. (We didn't try this yet so please tell us if and how it works for you.)
We have improved frida-compile to support cylang by integrating the Cycript compiler. Sources with a .cy extension get compiled transparently, and this "just works" as long as our runtime is also included in the compiled agent.
Please see our test-suite to get an overview of what we currently support.
Install Meson and Ninja:
pip3 install meson
brew install ninja
Clone this repo:
git clone --recurse-submodules https://github.com/nowsecure/frida-cycript.git
Generate the build system:
meson build --buildtype minsize --strip
Build:
ninja -C build
Run Cycript:
./build/src/cycript
Run the test-suite:
cd test && npm install && npm run test
To build the Node.js bindings:
meson build --buildtype minsize --strip --default-library static -D enable_engine=false -D enable_console=false
ninja -C build
cd bindings/node/cylang/
npm install
Install Meson and Ninja, and clone this repo, similar to above.
To build the Node.js bindings from a MSVS Native Tools Command Prompt for VS 2017:
meson build --buildtype minsize --strip --default-library static -D enable_engine=false -D enable_console=false -D b_vscrt=mt
ninja -C build
cd bindings\node\cylang
npm install
Then to run the test-suite:
npm run test
Clone and link mojlner repository:
# build first (@see: above)
cd src
git clone git@github.com:nowsecure/mjolner.git ~/dev/mjolner
npm link ~/dev/mjolner/
npm run watch
...