/pync

Python wrapper for Mac OS 10.8 Notification Center

Primary LanguagePythonOtherNOASSERTION

pync

PyPI - License PyPI GitHub issues GitHub pull requests GitHub forks GitHub stars

A simple Python wrapper around the terminal-notifier command-line tool (version 2.0.0), which allows you to send User Notifications to the Notification Center on Mac OS X 10.10, or higher.

Screenshot

Installation

pip install pync

or

pip install git+https://github.com/SeTeM/pync.git

or

git clone git://github.com/SeTeM/pync.git
cd pync
python setup.py install

Usage

For full information on all the options, see the tool’s README.

Examples:

Using the notify function

import pync

pync.notify('Hello World')
pync.notify('Hello World', title='Python')
pync.notify('Hello World', group=os.getpid())
pync.notify('Hello World', activate='com.apple.Safari')
pync.notify('Hello World', open='http://github.com/')
pync.notify('Hello World', execute='say "OMG"')
pync.notify('Hello World', appIcon='https://assets-cdn.github.com/images/modules/logos_page/Octocat.png')

pync.remove_notifications(os.getpid())

pync.list_notifications(os.getpid())

Using the notifier object

from pync import Notifier

Notifier.notify('Hello World')
Notifier.notify('Hello World', title='Python')
Notifier.notify('Hello World', group=os.getpid())
Notifier.notify('Hello World', activate='com.apple.Safari')
Notifier.notify('Hello World', open='http://github.com/')
Notifier.notify('Hello World', execute='say "OMG"')
Notifier.notify('Hello World', appIcon='https://assets-cdn.github.com/images/modules/logos_page/Octocat.png')

Notifier.remove(os.getpid())

Notifier.list(os.getpid())

License

All the works are available under the MIT license. Except for ‘Terminal.icns’, which is a copy of Apple’s Terminal.app icon and as such is copyright of Apple.

See LICENSE for details.