Skip to content

Aransh/cylinder

 
 

Repository files navigation

Cylinder

Latest version: 1.0.3

Here's the changelog.

Here's the deb.

wat???

This is a jailbreak tweak that lets you animate your icons when you swipe pages on the SpringBoard.

The kicker about this one is two things:

  1. Combining multiple effects
  2. Effects are written in Lua

This allows for unprecedented flexibility. Users do not have to depend on the developer to add new icon effects, as they can just code them in Lua with a simple text editor and copy to them to the phone. The existing scripts can also serve to help newbies start making their own scripts if they so desire.

If you want more, check out /r/cylinder!

If you want to make your own effects, check out any of the 53 scripts that are bundled with Cylinder. If you need more in-depth documentation you can check out EXAMPLE.lua as well. Once you've made your own effect, make a folder with your name in /Library/Cylinder on your phone (like /Library/Cylinder/rweichler), drop your scripts in, and it should appear in settings. You don't even have to respring! This allows for rapid testing.

Compatible with iOS 4, 5, 6, 7 and 8.

##.deb files

If you don't feel like building this, here's a .deb of the latest stable build.

And... here's a deb of the latest UNSTABLE build.

Setup

Prerequisites

  • Mac OS X, Linux or jailbroken iOS
  • Perl (for Logos. This project does not use Theos! And Logos is included already.)
  • Xcode (or, clang/make and a copy of the iPhone SDK >= iOS 4)

First, clone the repository and cd into it

git clone https://github.com/rweichler/cylinder.git
cd cylinder

Then, init the submodules:

git submodule update --init

For those who don't have Xcode installed

Open config.mk and edit the line that says SDK= to reflect where your copy of the iPhone SDK is.

DHowett has been nice enough to host them for us here: http://iphone.howett.net/sdks/

Just download one of those (must be >= iOS 4, and preferably >= 7 for 64-bit support), unzip it somewhere, delete the original .tar.gz and paste wherever you unzipped it after the SDK= in the config.mk.

Building

If you just want a .deb, run this:

make package

If you want it to install on your device, run this:

make install IPHONE_IP=iphone_wifi_ip_here

You need OpenSSH installed in order for the installation to work.

Pull request policy

Pull requests are only for changes and improvements to the core framework. Not custom Lua scripts.

Feel free to post them to /r/cylinder. Once this is on BigBoss there will also be an easy way for you to submit your scripts there too.

License

GNU GPL, unless otherwise stated in the files themselves.

Packages

No packages published

Languages

  • C 66.5%
  • Objective-C 11.4%
  • Perl 8.3%
  • Lua 7.7%
  • C++ 3.2%
  • Makefile 1.5%
  • Other 1.4%