Skip to main content

Python library used to send toast notifications on Windows machines

Project description

Windows-Toasts


PyPI version readthedocs.io Supported Python versions Downloads codecov Code Style: Black

Windows-Toasts is a Python library used to send toast notifications on Windows machines. Check out the documentation.

Installation

Windows-Toasts supports Windows 10 and 11. While toast notifications do work on Windows 8.1 and below, Microsoft added features in Windows 10 that were never backported.

Windows-Toasts is available through PyPI:

$ python -m pip install windows-toasts

Usage

Simple usage:

>>> from windows_toasts import Toast, WindowsToaster
>>> toaster = WindowsToaster('Python')
>>> newToast = Toast()
>>> newToast.text_fields = ['Hello, world!']
>>> newToast.on_activated = lambda _: print('Toast clicked!')
>>> toaster.show_toast(newToast)

Full documentation is available at readthedocs.io

But I already saw this package three times on PyPI!

I created this library since the other Windows toast notification libraries were all but abandoned, lacked features, and were using pywin32 bindings.

Using WinRT may come with its own limitations. However, the only issue I've encountered compared to using pywin32 bindings is not being able to select the duration in seconds, but rather as short/long.

Credits

The code is adapted from mohabouje's wonderful C++ WinToasts library

Big thanks to dlech for his recently created winrt fork

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Windows-Toasts-1.1.0.tar.gz (23.6 kB view hashes)

Uploaded Source

Built Distribution

Windows_Toasts-1.1.0-py3-none-any.whl (23.4 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page