Skip to main content

Deprecated, use aquaui instead

Project description

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.

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

Uploaded Source

Built Distribution

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

Uploaded Python 3

File details

Details for the file notipy_osx-0.0.9.tar.gz.

File metadata

  • Download URL: notipy_osx-0.0.9.tar.gz
  • Upload date:
  • Size: 5.0 kB
  • Tags: Source
  • Uploaded using 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

File hashes

Hashes for notipy_osx-0.0.9.tar.gz
Algorithm Hash digest
SHA256 01344f3fc2791ef319e206622eaee5e6d16056da235289d57641240262f0b587
MD5 fb1ee9238cba068d88496222a0c8dc7e
BLAKE2b-256 b2378b3f4ded649473e2f1dcb32b6fb455061110fbb113311b0a840304e9f1b0

See more details on using hashes here.

File details

Details for the file notipy_osx-0.0.9-py3-none-any.whl.

File metadata

  • Download URL: notipy_osx-0.0.9-py3-none-any.whl
  • Upload date:
  • Size: 8.8 kB
  • Tags: Python 3
  • Uploaded using 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

File hashes

Hashes for notipy_osx-0.0.9-py3-none-any.whl
Algorithm Hash digest
SHA256 bbd43d5b522d0626df6dbcf7fd4c865679c2a9afd4bff6067bd6359503096c0a
MD5 17058743bddba080ec682f672284e7d8
BLAKE2b-256 a9755e3faa96d9625746cc5fa0b911afb80f2544411ec85544b9a376a6fa07c2

See more details on using hashes here.

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