Skip to main content

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

Project description

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


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

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


  • OS X >= 10.9.4 - should work on Mountain Lion but it’s not tested,
  • Python 2.7 or 3.4,
  • libosxnotify >= 1.0,
  • Xcode and command line utilities.


To install osxnotify-cffi from PyPI, issue the following command:

$ pip install osxnotify-cffi

Alternatively, you can install from the source code:

$ git clone
$ cd osxnotify-python-cffi
$ python install


import osxnotify-cffi

osnotify-cffi.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-cffi in production.


osxnotify-cffi is licensed under MIT License.


osxnotify-cffi was written by Tomek Wójcik.

Source code and issues

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

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

Project details

Release history Release notifications

This version
History Node


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
osxnotify-cffi-1.0.tar.gz (3.5 kB) Copy SHA256 hash SHA256 Source None Jun 2, 2015

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page