Giter VIP home page Giter VIP logo

cylinder's Introduction

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.

cylinder's People

Contributors

rweichler avatar noahd avatar bensge avatar frudelir avatar

Watchers

James Cloos avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.