Skip to content

An easy-to-use Python library for displaying Windows 10 Toast Notifications. Improved version of win10toast and win10toast-persist to include `callback_on_click` to run a function on notification click, for example to open a URL.

License

vardecab/win10toast-click

 
 

Repository files navigation

win10toast-click

Not Maintained

As of late 2022, serious rewrite is necessary to fix problems in later Windows 10 builds and Windows 11.

You can check plyer as an alternative solution.





An easy-to-use Python library for displaying Windows 10 Toast Notifications. Improved version of win10toast and win10toast-persist to include callback_on_click to run a function on notification click, for example to open a URL.

Context

1: Original module.

2: Tweaked version with support for notifications that persist in the notification center.

This fork is an improved version of 2 ^ with callback_on_click that allows to run a function on notification click, for example to open a URL.

Installation

pip install win10toast-click

Example

# modules
import webbrowser
from win10toast_click import ToastNotifier 

# function 
page_url = 'http://example.com/'

def open_url():
    try: 
        webbrowser.open_new(page_url)
        print('Opening URL...')  
    except: 
        print('Failed to open URL. Unsupported variable type.')

# initialize 
toaster = ToastNotifier()

# showcase
toaster.show_toast(
    "Example two", # title
    "Click to open URL! >>", # message 
    icon_path=None, # 'icon_path' 
    duration=5, # for how many seconds toast should be visible; None = leave notification in Notification Center
    threaded=True, # True = run other code in parallel; False = code execution will wait till notification disappears 
    callback_on_click=open_url # click notification to run function 
    )

Release History

  • 0.1.3: A tiny clean-up.
  • 0.1.2: Prepared for distribution on Python Package Index (PyPI).
  • 0.1.1: Renamed repo.
  • 0.1: Initial release.

Versioning

Using SemVer.

License

Acknowledgements

Original modules

Stack Overflow

Packaging & distribution

Icon

Contributing

If you found a bug or want to propose a feature, feel free to visit the Issues page.

About

An easy-to-use Python library for displaying Windows 10 Toast Notifications. Improved version of win10toast and win10toast-persist to include `callback_on_click` to run a function on notification click, for example to open a URL.

Topics

Resources

License

Stars

Watchers

Forks

Languages

  • Python 100.0%