Skip to content

iamDecode/Jello

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

50 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Jello

A wobbly windows implementation for MacOS inspired by Compiz for Linux.

Note: this is only a proof of concept, I am not actively maintaining the project. It may not always be stable, but I am open to contributions :)

jello-monterey.mp4

For a demo injected into MacOS, check out this video.

Usage

Demo app

Just open the Xcode project and build. You get a demo wobbly window, and can use this code to add the wobbly effect to any new app you're building.

Injecting into MacOS

Old instructions - Install SIMBL loader like using [mySIMBL](https://github.com/w0lfschild/mySIMBL) or [MacForge](https://www.macenhance.com/macforge). Note that you currently need to disable System Integrity Protection (SIP) in order for this to work. - Download the [latest bundle](https://github.com/iamDecode/Jello/releases), or build it yourself (see Building). - Drag bundle onto the app to enable it. - Restart apps for Jello to take effect.

Previous instructions were outdated and don’t work on recent macs (with Apple silicon) anymore. To address this, I built a highly experimental JelloInjector app (see feat/injector-app branch), that uses frida to inject into MacOS. It works on most non-apple apps I tested, but unfortunately the native Finder, Messages, Mail etc seem permanently off-limits.

To use this app you have to lower your system security which I highly advice against, but if you still want to proceed, you have to:

  • Boot into MacOS recovery mode
    • Shut down completely
    • Hold power button while turning on
    • choose “Options”
    • Login with your account
    • Select Utilities > Terminal from the menu bar
  • Disable (part of) System Integrity Protection (SIP) with csrutil enable --without debug
  • Reboot
  • Enable arm64e applications by running sudo nvram boot-args="-arm64e_preview_abi”
  • Reboot again

Building

The Xcode project contains two targets, Jello will run a sample window with wobble logic enabled, JelloInject builds a bundle that can be used with a SIMBL loader.

Contributing

Feel free to make a contribution. Please read CONTRIBUTING.md for details on the code of conduct, and the process for submitting pull requests.

License

This project is licensed under the BSD 2-Clause License - see the LICENSE file for details.

About

A wobbly windows implementation for MacOS.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors