---
id: notify-py
version: "0.3.43"
license: MIT
license_treatment: permissive
maintenance: dormant
---

# notify_py — Cross-platform desktop notification library for Python

License: permissive · Maintenance: dormant · Downloads: 383.9K/mo

## What it is and what it does

notify-py is a Python library that sends desktop notifications to the native notification system of Windows 10/11, macOS 10.10+, and Linux systems. It wraps platform-specific notification APIs (Windows Toast, macOS NSUserNotification, and Linux D-Bus/libnotify) behind a single, simple interface. You create a Notify object, set title and message properties, optionally add an icon or audio file, and call send() to display the notification.

The library supports both blocking and non-blocking notification delivery and can be used programmatically or via a CLI. It depends on loguru for logging and jeepney for Linux D-Bus communication. The package is straightforward for simple notification use cases but does not support interactive elements like buttons or user action callbacks.

Use it for:

- Alert users when a long-running script or batch job completes, with optional sound.
- Display system status updates or warnings from a background Python application.
- Notify desktop users of events from a server-side process or scheduled task.
- Send build or deployment completion notifications from CI/CD scripts.
- Provide user feedback in GUI applications without requiring a dedicated message box.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Sends cross-platform desktop notifications from Python scripts to Windows, macOS, and Linux systems with optional icons and audio.

Yes, if you need simple cross-platform desktop notifications and accept the dormant maintenance status. The package is stable, has no known vulnerabilities, and low install friction. However, if you require active maintenance, custom notification actions, or guaranteed compatibility with the latest OS versions, evaluate alternatives or plan for potential maintenance yourself.

## Install

pip install notify-py
uv add notify-py
poetry add notify-py

## Installing notify_py

Before you install: Low install friction with only two runtime dependencies (loguru and jeepney). Maintenance is dormant—last release was 800 days ago, though the repository remains active with a recent commit in July 2024 and no archived status.

License in practice: MIT license permits commercial and private use with minimal restrictions; you may use, modify, and distribute the package freely provided you include the license notice.

Quickstart:

pip install notify-py

from notifypy import Notify

notification = Notify()
notification.title = "Cool Title"
notification.message = "Even cooler message."
notification.send()

On Linux, requires libnotify to be installed on the system; jeepney provides D-Bus access for notifications.

Verify before relying:

- Whether the package works reliably on current Windows 11 and recent macOS versions given the dormant maintenance status.
- Current state of macOS custom icon support and any workarounds since the documented limitation.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: dormant
- Downloads: 383.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

desktop notifications python, cross-platform system notifications, notify windows macos linux, python notification library, send desktop alerts python, system tray notifications, application notifications, desktop-notifications, cross-platform

[View on SkillFed](https://skillfed.io/packages/notify-py) · [View on PyPI](https://pypi.org/project/notify-py/)