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

  • Display native dialogs
    • Add buttons
    • Text input (including hidden/password fields)
    • Callbacks (get button pressed and text enterd)
    • Customize icons
  • Display native notifications
    • Customize title, subtitle, and information text
    • Cusomize icon
    • Schedule a notification (using delay)
    • Fallback to AppleScript notifications if PyObjC doesn't work
    • Callbacks (button pressed, reply text, ...) (please see this answer)
  • Display choice prompts
  • 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.

Source Distribution

notipy_osx-0.0.9.tar.gz (5.0 kB view hashes)

Uploaded Source

Built Distribution

notipy_osx-0.0.9-py3-none-any.whl (8.8 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page