Winotify

A pure python module to show notification toast on Windows 10.

No dependencies, no requirements, all you need is PowerShell installed on your machine (which in every Windows computer have it).

Installation

Install winotify using pip

pip install winotify

Features

Notification stays in action center
Clickable notification with 5 additional buttons
Use function as a callback when clicking the notification

Usage

A simple notification with icon

from winotify import Notification

toast = Notification(app_id="windows app",
                     title="Winotify Test Toast",
                     msg="New Notification!",
                     icon=r"c:\path\to\icon.png")

toast.show()

Result:

The notification stays in the action center!

Note that the icon path must be absolute otherwise the notification will not show

Set sound of the notification

All supported audio are in the audio module

from winotify import Notification, audio

toast = Notification(...)
toast.set_audio(audio.Mail, loop=False)

Add action button

from winotify import Notification

toast = Notification(...)
toast.add_actions(label="Button text", 
                  launch="https://github.com/versa-syahptr/winotify/")

You can add up to 5 buttons each notification

CLI

winotify ^
-id myApp ^
-t "A Title" ^
-m "A message" ^
-i "c:\path\to\icon.png" ^
--audio default ^
--open-url "http://google.com" ^
--action "open github" ^
--action_url "http://github.com"

Use winotify-nc instead of winotify to hide the console window.

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

Licence

MIT