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
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):
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
andnotify
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
📜 License
- MIT
- The icon
Terminal.icns
inexamples/icons
is a copy of Terminal.app's icon, which is copyrighted by Apple.
Project details
Release history Release notifications | RSS feed
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)
Built Distribution
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 01344f3fc2791ef319e206622eaee5e6d16056da235289d57641240262f0b587 |
|
MD5 | fb1ee9238cba068d88496222a0c8dc7e |
|
BLAKE2b-256 | b2378b3f4ded649473e2f1dcb32b6fb455061110fbb113311b0a840304e9f1b0 |
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | bbd43d5b522d0626df6dbcf7fd4c865679c2a9afd4bff6067bd6359503096c0a |
|
MD5 | 17058743bddba080ec682f672284e7d8 |
|
BLAKE2b-256 | a9755e3faa96d9625746cc5fa0b911afb80f2544411ec85544b9a376a6fa07c2 |