/win10toast-click

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.

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

win10toast-click

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.