Skip to content
iOS Notifications. Done right.
Failed to load latest commit information.
layout Chore: Updated package control file
mobilenukifier Use $THEOS env variable instead of symlinks
settings Bugfix: Updated non-retina settings icon size
.gitignore Added dpkg generated _ folder to gitignore
.gitmodules Fix compile issue Chore: Project wide whitespace + comments cleanup
BCZeroEdgeTextView.m Chore: Whitespace cleanup Added Kyle Adams attribution to the Readme, added the appropriate CC …
LICENSE Added Dustin Howett to the LICENSE file. The project is now licensed …
MNAlertDashboardViewController.h Bugfix: Notification count now updates correctly
MNAlertDashboardViewController.m Chore: Added table cell separators back in
MNAlertData.h Chore: Whitespace cleanup
MNAlertData.m Chore: Whitespace cleanup
MNAlertManager.h Chore: Moved method declaration to header
MNAlertManager.m Chore: Moved method declaration to header
MNAlertTableViewDataSource.h Merge branch 'dark-lockscreen-table-view'
MNAlertTableViewDataSource.m Very experimental quick reply support
MNAlertTableViewDataSourceEditable.h MobileReply and all other beta5 features implemented.
MNAlertTableViewDataSourceEditable.m Bugfix: Notification count now updates correctly
MNAlertViewController.h Bugfix: Reduced compilation warnings
MNAlertViewController.m Chore: Trying out memory management tweaks
MNLockScreenViewController.m Bugfix: Fix lockscren compatibility with SBSettings
MNMostRecentAlertShowerController.h Chore: Whitespace cleanup
MNMostRecentAlertShowerController.m Chore: Whitespace cleanup
MNPreferenceManager.h Added licenses that were missing
MNPreferenceManager.m Added licenses that were missing
MNSMSSender.h I think this SMS thing works?
MNSMSSender.m Chore: Whitespace cleanup
MNTableViewCell.m Added licenses that were missing
MNTableViewCellClear.h Added licenses that were missing
MNTableViewCellClear.m Chore: Whitespace cleanup
MNWhistleBlowerController.h Fixed duplicate sound bug for push notifications
MNWhistleBlowerController.m Fixed for Voicemail, Push, and Calendar notifications
Makefile Added functionality to pull back the most recent alert through Activator
MobileNotifier.plist Chore: Project wide whitespace + comments cleanup Bugfix: Fixed readme markdown
Tweak.xm Chore: Whitespace cleanup


iOS Notifications Done Right.

by Peter Hajas


email: peterhajas (at) gmail (dot) com

twitter: @peterhajas

UI Design and User Experience by Kyle Adams


twitter: @iamkyleadams


MobileNotifier is a complete rewrite, from the ground up, of the iOS Notification System. It strives to employ the core ideas of a well designed interface: it's accessible, discoverable, usable and as little design as possible (as Dieter Rams would say).

Due to the way the software functions, MobileNotifier requires a jailbroken iOS device running MobileSubstrate, Activator and Preference Loader. MobileNotifier will inform you of missing dependencies upon install.

MobileNotifier now includes a pretty awesome new companion app: MobileNukifier! MobileNukifier does what it sounds like - it deletes your MobileNotifier directory (/var/mobile/Library/MobileNotifier/) containing your notifications, and resprings the phone. This clears things out, and allows for easier testing once new versions are released.


Add as a Cydia source. This repository has the latest version of the project.

Project Setup

  1. Install Git from

  2. Clone the repository into a folder on your local machine. This example is written using your home folder.

    • mkdir ~/code
    • cd ~/code
    • git clone git://
  3. Initialize and pull in the necessary Git sub-modules.

    • cd ~/code/MobileNotifier
    • git submodule init
    • git submodule update

Environment Setup

MobileNotifier has only been built on Mac OS X. Theos can be installed on Mac OS X, Linux and iOS.

  1. Install Xcode. A free developer account is required in order to download it. note: MobileNotifier only compiles using iOS 4 SDK

  2. Install MacPorts

  3. Install Theos (the iOS makefile system by Dustin Howett) using this guide:

  4. Download the decompiled 3.x headers from rpetrich's fork of Kennytm in $THEOS/include/. Be sure place the frameworks at top level (i.e. $THEOS/include/Springboard).

  5. After copying the headers into $THEOS/include, you'll need to run the following command to copy some required system files not included by default.

    cp /System/Library/Frameworks/IOSurface.framework/Headers/IOSurfaceAPI.h $THEOS/include/IOSurface/.

  6. Copy libactivator.dylib to $THEOS/lib/ (you can get this off your iOS device with Activator installed)

  7. Install dpkg via MacPorts (if not already installed)

    sudo port install dpkg

  8. Install gnutar via MacPorts (if not already installed)

    sudo port install gnutar

  9. Symlink tar to gnutar by running the following command:

    ln -sf /usr/bin/gnutar /usr/bin/tar


Currently, MobileNotifier does not build without warnings. Please set the shell variable GO_EASY_ON_ME to 1 in your environment.

  1. Run make

  2. Run make package to generate a .deb.

Installation methods

  • Manual: scp the resulting .deb file to your device, and run dpkg -i thedeb.deb as root to install.
  • Automated: run make package install with the THEOS_DEVICE_IP environment variable set (example: export THEOS_DEVICE_IP=iPhone.local).


MobileNotifier is open source, and would greatly appreciate your help. Please submit any changes you'd like to see made either as GitHub pull requests, or as patchfiles emailed to me (GitHub preferred). If you'd like to contact me about helping out, email the address listed above.


MobileNotifier is open source software and licensed under the BSD license, because I enjoy readability. You can read this license in the LICENSE file included with this source tree, and at the top of every file.

MobileNotifier's images and graphical content are licensed under a separate license, the Creative Commons Attribution-NoDerivs 3.0 Unported License. Please see the included file at the root of the repository.

Please note that all images and graphical content, unless noted otherwise, are Copyright Kyle Adams 2011. You can read more about the license Kyle has on his work in the file.


MobileNotifier is the result of lots of people's help. Here's a non-exhaustive list in no particular order:

Mukkai Krishnamoorthy - - for being the faculty sponsor

Sean O' Sullivan - for his financial contributions. Thanks so much Mr. Sullivan.

Dustin Howett - - for Theos and amazing help on IRC!

Ryan Petrich - - for Activator and help on IRC

chpwn - - for his awesome tweaks and help on IRC

Aaron Ash - - for his help on IRC and invaluable advice

KennyTM - - for his decompiled headers

Jay Freeman - - for MobileSubstrate, Cydia, Cycript, Veency and countless other gifts to the community

Kyle Adams - - for his work on the user interface for the project and prerelease testing

Tim Novinger - - for his work on modernizing animations, cleaning up the interface and tons of other improvements

Marc Easen - - for implementing calendar invitation alerts

Tim Horton - - for his help with debugging and testing

Frederik Vanggaard - - for his help with debugging and testing

Sammargh - - for his help with fixing the SMS notification tones

Kristian Pennacchia - - for his work on sliding notifications

Derek Nicolas - - for his help with fixing SMS notification bugs

Something went wrong with that request. Please try again.