About StatusBridge¶

What is StatusBridge all about?¶

I was missing a common easy-to-use way to display icons in SpringBoards statusbar.
UIKit has methods in UIApplication that should do the task but they tend to change
API / stop working etc.

For this reason StatusBridge was created.
It's a mobile substrate extension and allows for custom icons to be displayed by
any application without the need to hook SpringBoard or check for specific API's.

How do I use it?¶

1. The icon files you like to show

they must be sized proper and need to be placed in SpringBoards application bundle (/System/Library/CoreServices/SpringBoard.app/)

1. A file consisting of the name of your application and the icons name in placed in /var/mobile/Library/StatusBridge.

this file needs to be named in reverse-DNS order and contain the icons name (without FSO_ or extension) as the last part

For example zsrelay has an icon named 'ZSRelayInsomnia' this would result in the file
/var/mobile/Library/StatusBridge/ org.bitspin.zsrelay.ZSRelayInsomnia

After all files are in place and SpringBoard was reloaded
you can show or hide your icon by posting a notification in your app.

#include <notify.h>

/* show MyCustomIcon */
notify_post("com.myapp.MyCustomIcon.show");

/* hide MyCustomIcon */
notify_post("com.myapp.MyCustomIcon.hide");

That's about all there is about it!

Please note that StatusBridge has no way of monitoring your app! Be sure to remove icons on exit!!¶