Introducing Theme Aggregator


Theme Aggregator is a tool for customizing themes on a jailbroken iDevice (iPhone, iPad, iPod Touch) and is written entirely in python (with a pygtk GUI frontend).

Theme Aggregator lets you customize several components of a theme, including creating your own theme using bits and pieces from other themes.  You can also choose pictures and images from your own computer to use as wallpaper or lockscreen background images.

You must be jailbroken to use this app.  There are lot of guides for jailbreaking your particular iDevice and iOS version.  Check iClarified and iPhone Dev Blog for more information on jailbreaking your iDevice.


Things you can customize:

  • ICONS! – pick an application, such as Safari or Facebook, and the app will show you all the variations of that icon you have amongst all your themes. (Ex. click on Facebook and see all the Facebook icons you have to choose from so you can pick the one you’d like to use.)
  • SpringBoard Strings – here you can customize text used all over the GUI, such as the ‘slide to unlock’ text, or the Answer call button text.  321 different strings you can customize to your heart’s content.
  • SpringBoard Wallpaper – what image do you want displayed behind the icons?
  • Lockscreen Battery Charger – pick which battery-charging theme you’d like displayed when the iDevice is being charged
  • Lockscreen Background – when not being charged, what image would you like displayed on your lockscreen?


In addition to these customizations, you can also use the app the copy your Themes directory from your iDevice to your computer.  And with the click of a button you can transfer your customized theme back to your iDevice.

The app will ask if you want to respring to activate changes to the theme.  The only reason to say yes is if the theme you’re transferring over is already selected inside Winterboard.  Otherwise, just say No and then go into Winterboard and set the new theme as active (tap on it so it has a check-mark next to it, then go back a screen and click on “respring” in the upper left corner)

If you’d like a more comprehensive and feature-packed solution for backing up your iDevice, please check out my other project BackMeUp.  With BackMeUp you can completely back up and restore your iDevice (and your whole computer) using profiles that allow you to set up a profile for each iDevice to really be able to customize your backups.


* most screens have a Help button to explain the options in that window

To get started just:

  1. Load the app (obvious first choice)
  2. Go to Settings and set the local theme directory and IP of your iDevice.
  3. If you haven’t already downloaded a copy of your Themes directory to your computer, do so now by clicking on Transfer and then “Refresh Local Theme Dir from iDevice
  4. Click on Themes to select an active them.  This is the theme you want to work with.  Clicking Save will save changes to the active theme.
  5. From here you’re off to customize as you see fit.  You can look at Icons and Themes on the left and drag and drop down to the bottom of the app to add an icon to the active theme.
  6. If you need a closer look at the icons, just click on the Magnify button up top and the icons will double in size.  Click it again to reset their size.

I Encourage Feedback – tell me what doesn’t work, what doesn’t work the best way, and what the program SHOULD be doing.  I’ve pretty much run out of ideas for features to add, so I need the open source community to chip in with some ideas.  You suggest, we all benefit.  Comments, concerns, complaint, requests, etc…all welcomed!  Feedback = better app!

I use all the programs I write so that gives me a chance to iron out bugs and usability tweaks BEFORE going live with a new release.  If I missed something though, don’t hesitate to email me and let me know.

See the included README.txt file for contact information as well as release notes, etc.


About goombah88

Scripter trying to make life easier for everyone. "I've got a script for that!"
This entry was posted in Theme Aggregator and tagged , , , , , , , , , , , , , , , , , . Bookmark the permalink.

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google+ photo

You are commenting using your Google+ account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )


Connecting to %s