SBCustomIcon is a MobileSubstrate-based extension that allows iPhone applications to easily change their icon in SpringBoard.
- Jailbroken iPhone or iPod touch (OS 2.0 to 3.1.2)
SBCustomIcon adds the following methods to the UIApplication class for customizing the app icon:
YESif the application currently has a custom icon,
sets the app's icon to customIcon
sets the app's icon to the file at customIconPath, that should be a PNG file
removes the custom icon for the application, turning it back to the default
The app will also need the following keys in it's
- SBWillUseCustomIcon (boolean)
YESif your application uses SBCustomIcon functionality
- SBCustomIconIsPersistent (boolean)
By default, the icon turns back to normal when the app terminates. If you want it to persist, add this key and set it to
You can determine if SBCustomIcon is available before calling any of its methods with the
SBCustomIconAvailable macro, or check if the methods exists with
respondsToSelector:. Like that your application can work even if the extension isn't installed.
To use SBCustomIcon in your project, include this header file:
#import <UIKit/UIKit.h> #import <objc/runtime.h> #define SBCustomIconAvailable (class_respondsToSelector(objc_getClass("UIApplication"), @selector(hasCustomIcon))) @interface UIApplication (SBCustomIcon) - (BOOL)hasCustomIcon; - (BOOL)setCustomIcon:(UIImage*)customIcon; - (BOOL)setCustomIconFile:(NSString*)customIconPath; - (void)removeCustomIcon; @end
You can find SBCustomIcon in the BigBoss & Planet-iPhones repository in Cydia, or download the deb here and install it manually:
|SBCustomIcon||sbcustomicon-1.0.deb (13 KiB)|| SHA1
This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE.
You are free to use the functionality of SBCustomIcon in your own software.
The source code is provided as reference, but distribution of modified versions
is not allowed, since it could create conflicts.
- You can check out the source code from subversion:
svn checkout svn:/
- Or browse and download it with WebSVN: