Notifier (pynotifier) is a Python library that allows you to easily send desktop notifications.
This project originally came from https://github.com/ms7m/notify-py (huge thanks), but we decided to fork this project, actively maintain it and add more features.
- Windows 10/11
- Windows 8.1 (Balloon tips)
- macOS 10 >=10.10
- Linux (libnotify)
Windows 7 | Windows 8.1 | Windows 10 | Windows 11 | Linux | macOS 10 >=10.10 |
---|---|---|---|---|---|
❓ | ✅ (Balloon tips) |
✅ (Toast notification) |
✅ (Toast notification) |
✅ (requires libnotify) |
✅ (No custom icon) |
You can install notifier with pip
pip install notifier.py
from notifier import Notifier
notifier = Notifier()
notifier.title = "Some title"
notifier.message = "Some message"
notifier.send()
from notifier import Notifier
notifier = Notifier()
notifier.title = "Some title"
notifier.message = "Some message"
notifier.icon = "path/to/icon.png" # .png is not supported under windows 8.1
notifier.send()
from notifier import Notifier
notifier = Notifier()
notifier.title = "Some title"
notifier.message = "Some message"
notifier.audio = "path/to/audio/file.wav" # we currently only support wav files
notifier.send()
from notifier import Notifier
notifier = Notifier(
default_notification_title="Function Message",
default_application_name="Great Application",
default_notification_icon="path/to/icon.png",
default_notification_audio="path/to/sound.wav"
)
def your_function():
# stuff happening here.
notifier.message = "Function Result"
notifier.send()
from notifier import Notifier
notifier = Notifier(override_windows_version_detection=True)
notifier.title = "Some title"
notifier.message = "Some message"
notifier.send()
from notifier import Notifier
notifier = Notifier(override_windows_version="8.1") # Available values: 10, 8.1
notifier.title = "Some title"
notifier.message = "Some message"
notifier.send()
- Thanks to ms7m for creating https://github.com/ms7m/notify-py
- Also thanks to jithurjacob for creating https://github.com/jithurjacob/Windows-10-Toast-Notifications (a modified version has been added to this repository to fix bugs)
- macOS does not support custom icons on the fly.. You will need to bundle a customized version of the notifier embedded with your custom icon.