How do I use SpringRoll?

Commands

• sr backup - A required first step. Backs up all of your icons and system resources.
• sr restore - Restores the backup's system resources.
• sr theme ThemeName - Applies the theme you selected, provided it is in /var/root/SpringRoll.
• sr smbconv ThemeName - Makes SummerBoard themes compatible with SpringRoll.

How do I use SummerBoard themes?

SummerBoard themes use a slightly different naming scheme than SpringRoll does. By default, SpringRoll includes a conversion tool to convert default application icons to the right file name. Most other icons should work just fine, with certain exceptions.

• Upload it to /var/root/SpringRoll in its own directory. (Make sure the theme folder does not contain spaces!)
• Run sr smbconv ThemeName.
• Apply the theme! sb theme ThemeName and you should be okay!

How do I package extras?

• Status Bar: You can include three status bars with each theme: StatusBar-Default.png, StatusBar-FST.png, and StatusBar-FSO.png. Default is the gray gradient in most apps, FSO is used on the home screen and in CoverFlow, FST is on the lock screen only.
• Badge: Just include a Badge.png file in your theme's directory.
• Dock: Works like in SummerBoard: Dock.png in your theme's directory.
• Sliders: For basic sliders, you have to include three files: Slider-Gray.png, Slider-Green.png, and Slider-Red.png. For those with different shapes, Slider-bkgndlock.png, Slider-textmask.png and Slider-topbarbkgnd.png will be detected and copied to the correct place when applying your theme.
• Battery: Just put your BatteryBG_n.png files in a folder called Battery inside the theme folder.

How do I name icons?

All SpringRoll icons need to named the same as the application bundle is caused. This means MobileSMS.png instead of Text.png, iMmo.png instead of Aurora Feint.png. How can you tell what the app bundle names are? Just run sr backup and it will list all application bundle names.

This is too complicated!

Try watching some videos people have made explaining how to use it, or hold off until Customize comes out.

Go back to the front page.

This script is licensed under the Creative Commons BY-NC-SA license.