Skip to main content

Deprecated: use the package aquaui.











Notipy

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

Version PyPI - Downloads MIT Buy Me A Coffee

Example

Example

Example

Example

Example

Check out the code for these examples in examples/dialogs/readme_examples.py.

🚀 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

Install

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):

Example

More

  • 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 Terminal.app's icon, which is copyrighted by Apple.

Metadata

Release files for notipy-osx 0.0.9

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for notipy-osx 0.0.9
File Size Uploaded
notipy_osx-0.0.9.tar.gz 5.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for notipy-osx 0.0.9
File Interpreter ABI Platform
notipy_osx-0.0.9-py3-none-any.whl Python 3 none any Details

Total release size: 13.8 kB

Release files / notipy_osx-0.0.9.tar.gz

Download URL notipy_osx-0.0.9.tar.gz
Size 5.0 kB
Tags Source
SHA-256 checksum
How to use checksums
01344f3fc2791ef319e206622eaee5e6d16056da235289d57641240262f0b587
BLAKE2b-256 checksum
How to use checksums
b2378b3f4ded649473e2f1dcb32b6fb455061110fbb113311b0a840304e9f1b0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.1.1 pkginfo/1.5.0.1 requests/2.25.1 setuptools/47.1.1 requests-toolbelt/0.9.1 tqdm/4.46.1 CPython/3.7.6

Release files / notipy_osx-0.0.9-py3-none-any.whl

Download URL notipy_osx-0.0.9-py3-none-any.whl
Size 8.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
bbd43d5b522d0626df6dbcf7fd4c865679c2a9afd4bff6067bd6359503096c0a
BLAKE2b-256 checksum
How to use checksums
a9755e3faa96d9625746cc5fa0b911afb80f2544411ec85544b9a376a6fa07c2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.1.1 pkginfo/1.5.0.1 requests/2.25.1 setuptools/47.1.1 requests-toolbelt/0.9.1 tqdm/4.46.1 CPython/3.7.6
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page