iOS Notifications. Done right.
Failed to load latest commit information.
layout Chore: Updated package control file Jun 30, 2011
mobilenukifier Use $THEOS env variable instead of symlinks Feb 4, 2011
BCZeroEdgeTextView.m Chore: Whitespace cleanup Jun 7, 2011
LICENSE Added Dustin Howett to the LICENSE file. The project is now licensed … May 26, 2011
MNAlertDashboardViewController.h Bugfix: Notification count now updates correctly Jun 7, 2011
MNAlertDashboardViewController.m Chore: Added table cell separators back in Jun 14, 2011
MNAlertData.h Chore: Whitespace cleanup Jun 1, 2011
MNAlertData.m Chore: Whitespace cleanup Jun 1, 2011
MNAlertManager.m Chore: Moved method declaration to header Jun 15, 2011
MNAlertTableViewDataSource.h Merge branch 'dark-lockscreen-table-view' May 10, 2011
MNAlertTableViewDataSource.m Very experimental quick reply support May 25, 2011
MNAlertTableViewDataSourceEditable.m Bugfix: Notification count now updates correctly Jun 7, 2011
MNAlertViewController.h Bugfix: Reduced compilation warnings Jun 15, 2011
MNAlertViewController.m Chore: Trying out memory management tweaks Jun 15, 2011
MNLockScreenViewController.h Chore: List disabled during unlock attempt Jun 6, 2011
MNLockScreenViewController.m Bugfix: Fix lockscren compatibility with SBSettings Jun 15, 2011
MNMostRecentAlertShowerController.h Chore: Whitespace cleanup Jun 1, 2011
MNMostRecentAlertShowerController.m Chore: Whitespace cleanup Jun 1, 2011
MNPreferenceManager.h Added licenses that were missing May 24, 2011
MNPreferenceManager.m Added licenses that were missing May 24, 2011
MNSMSSender.h I think this SMS thing works? May 24, 2011
MNTableViewCell.h Added licenses that were missing May 24, 2011
MNTableViewCell.m Added licenses that were missing May 24, 2011
MNTableViewCellClear.h Added licenses that were missing May 24, 2011
MNTableViewCellClear.m Chore: Whitespace cleanup Jun 1, 2011
MNWhistleBlowerController.h Fixed duplicate sound bug for push notifications May 14, 2011
Makefile Added functionality to pull back the most recent alert through Activator May 29, 2011
MobileNotifier.plist Chore: Project wide whitespace + comments cleanup May 7, 2011
Tweak.xm Chore: Whitespace cleanup Jun 7, 2011


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