apprise: Send Notifications Across Many Services

Overview

Apprise provides a common interface for sending notifications to many third-party and self-hosted services. Instead of implementing a separate integration for each destination, applications and scripts can use service URLs through the Python library or the apprise command-line tool.

It is useful when notifications need to reach different platforms, or when a team wants to manage destinations in configuration files and route messages by tags. The project also supports attachments and custom notification hooks. See the official documentation and supported services for details.

Key Features

• Send notifications through a shared Python API or CLI.
• Configure destinations using service-specific URLs.
• Connect to a broad range of notification, SMS, email, desktop, and custom HTTP services.
• Load YAML or text configuration files, including remote configuration sources.
• Organize destinations with tags and target selected groups.
• Include local or remote file attachments where the destination supports them.
• Extend the tool with custom notification hooks.

Use Cases

• Developers can add notifications to applications without writing a separate client for each supported service.
• System administrators can send alerts from shell scripts and scheduled tasks using the CLI.
• DevOps teams can route operational alerts to different services or groups using configuration files and tags.
• Teams can use one notification workflow across chat, email, SMS, and push destinations, subject to each service's capabilities.

Project Facts

• Language: Python
• License: BSD-2-Clause
• Stars: 17.5k
• Forks: 672
• Topics: alerts, apprise, framework, notification-api, notification-hub, notification-service, notifications, notifier, notify, push-notifications, python
• Archived: false

Getting Started

Install from PyPI:

pip install apprise

For usage examples, configuration options, and supported service URLs, see the README and official documentation.

Alternatives

• ntfy: ntfy is a specific HTTP-based publish-subscribe service, while Apprise sends alerts through a shared interface to many notification services.
• Mailroom: Mailroom is a Go framework for routing application events to notification transports, while Apprise is a Python library and CLI for sending alerts.

Considerations

• Service coverage does not guarantee identical capabilities across destinations. Attachments and message behavior depend on the receiving service.
• Sending messages requires valid credentials and configuration for the selected services. Treat service URLs and configuration files as sensitive when they contain secrets.
• The repository describes asynchronous message sending, but delivery still depends on the availability and limits of external services.
• Apprise is licensed under BSD-2-Clause. Review that license and the terms of any notification providers you use.