About

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.

Requirements

• 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.

Installation

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

$ pip install osxnotify-cffi

Alternatively, you can install from the source code:

$ git clone https://github.com/tomekwojcik/osxnotify-python-cffi.git
$ cd osxnotify-python-cffi
$ python setup.py install

Usage

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.

License

osxnotify-cffi is licensed under MIT License.

Author

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.