About

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.

Requirements

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

Installation

To install osxnotify from PyPI, issue the following command:

$ pip install osxnotify

Alternatively, you can install from the source code:

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

Usage

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.

License

osxnotify is licensed under MIT License.

Author

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.