Skip to main content

Deprecated, use aquaui instead

Project description

Deprecated: use the package aquaui.


Python packge to display native customizable Mac OS dialogs and notifications with ease

Version PyPI - Downloads MIT Buy Me A Coffee






Check out the code for these examples in examples/dialogs/

🚀 Features

  • <input type="checkbox" checked="" disabled="" /> Display native dialogs
    • <input type="checkbox" checked="" disabled="" /> Add buttons
    • <input type="checkbox" checked="" disabled="" /> Text input (including hidden/password fields)
    • <input type="checkbox" checked="" disabled="" /> Callbacks (get button pressed and text enterd)
    • <input type="checkbox" checked="" disabled="" /> Customize icons
  • <input type="checkbox" checked="" disabled="" /> Display native notifications
    • <input type="checkbox" checked="" disabled="" /> Customize title, subtitle, and information text
    • <input type="checkbox" checked="" disabled="" /> Cusomize icon
    • <input type="checkbox" checked="" disabled="" /> Schedule a notification (using delay)
    • <input type="checkbox" checked="" disabled="" /> Fallback to AppleScript notifications if PyObjC doesn't work
    • <input type="checkbox" disabled="" /> Callbacks (button pressed, reply text, ...) (please see this answer)
  • <input type="checkbox" checked="" disabled="" /> Display choice prompts
  • <input type="checkbox" checked="" disabled="" /> Display color select prompts

🛠 Quick start


pip3 install notipy-osx
pip3 install pyobjc

Display a dialog

from notipy_osx import dialog_prompt

dialog_prompt(text='This is a basic dialog')

Show a notification

from notipy_osx import notify

notify(title='New Notifiation')
# if pyobjc notifications do not work, notifications will still be shown with osascript

If notifications do not work, ensure that you allow notifications from both Python and Script Editor (AppleScript):



  • Choice prompt (choose from a list of items)
  • Display a color picker

Next steps

  • View the guide for a full understanding of all the parameters for the display_dialog and notify functions
  • See the examples
  • View (and star) the GitHub repository

📕 View the rest of the documentation here

😱 Issues and limitations

  • No callbacks for notifications (please see this answer)
  • PyObjC notifications do not work on all Mac OS devices (possible issue), although a fallback has been set
  • Only for Mac OS

♥️ Support

If you liked this project, consider supporting by

  • ⭐️ Starring the repository
  • 🎒 Checking out my other projects
  • ☕️ Buying me coffee

📜 License

  • MIT
  • The icon Terminal.icns in examples/icons is a copy of's icon, which is copyrighted by Apple.

Project details

Download files

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

Files for notipy-osx, version 0.0.9
Filename, size File type Python version Upload date Hashes
Filename, size notipy_osx-0.0.9-py3-none-any.whl (8.8 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size notipy_osx-0.0.9.tar.gz (5.0 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page