Skip to main content

No nonsense OS X notifications for Python scripts (native wrapper)

Project description

No nonsense OS X notifications for Python scripts (native wrapper).


osxnotify is a wrapper for libosxnotify. It allows Python scripts to display native OS X notifications.

This module uses a native C extension to interface libosxnotify. For CFFI-based module see osxnotify-cffi.


  • OS X >= 10.9.4 - should work on Mountain Lion but it’s not tested,
  • Python 2.7 (for Python 3.4+ see osxnotify-cffi),
  • libosxnotify >= 1.0,
  • Xcode and command line utilities.


To install osxnotify from PyPI, issue the following command:

$ pip install osxnotify

Alternatively, you can install from the source code:

$ git clone
$ cd osxnotify-python
$ python2.7 install


import osxnotify

osnotify.notify('Title', subtitle='Subtitle', informative_text='Informative text')

Issues and limitations

UTF-8 is the only supported text encoding.

Project status

This project should be considered beta. Proceed with caution if you decide to use osxnotify in production.


osxnotify is licensed under MIT License.


osxnotify was written by Tomek Wójcik.

Source code and issues

Source code is available on GitHub at: tomekwojcik/osxnotify-python.

To file issue reports and feature requests use the project’s issue tracker on GitHub.

Project details

Release history Release notifications | RSS feed

This version


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for osxnotify, version 1.0
Filename, size File type Python version Upload date Hashes
Filename, size osxnotify-1.0.tar.gz (3.9 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page