Skip to content

apprise

Alerting & Incidents

A universal notification library that lets you send alerts to almost any service (Telegram, Discord, Slack, etc.) with a single API.

Python Latest v1.11.0 · 5d ago Security brief →

Features

  • Unified syntax for sending notifications to many services
  • Supports images and attachments where the service allows them
  • Lightweight and asynchronous for fast delivery
  • CLI tool (`apprise`) for ad‑hoc notification sending

Recent releases

View all 5 releases →
No immediate action
v1.11.0 Breaking risk

Weighted tags + optional fails + retries

v1.10.0 New feature
Notable features
  • Matrix end-to-end encryption support
  • Six new services: jira:// (Opsgenie), Evolution API (WhatsApp), blink(1), Exotel, Octopush, Postmark
  • Website improvements: searchable service listings and URL Builder enhancements
Full changelog

What's Changed

The big wow factor of this release would be the huge effort put into Matrix E2EE built into Apprise without adding overhead to the plugin itself. Huge props to those that helped out. Other than that, a few more services have been added (137 supported now :rocket: ).

The official documentation website (https://appriseit.com) got a nice cleanup; the Service listings are now searchable; some nice tweaks to the URL Builder as well.

:mega: New Notification Services:

  • Opsgenie functionality ported to jira:// in https://github.com/caronc/apprise/pull/1273
  • Evolution API (WhatsApp) notification plugin by @opastorello in https://github.com/caronc/apprise/pull/1579
  • Added blink(1) support in https://github.com/caronc/apprise/pull/1578
  • Exotel Support in https://github.com/caronc/apprise/pull/782
  • Added Octopush Support in https://github.com/caronc/apprise/pull/622
  • Added Postmark support in https://github.com/caronc/apprise/pull/1590

:lady_beetle: Bugfixes

  • ntfy:// tags= changed to xtags= in https://github.com/caronc/apprise/pull/1555
    • this allows tags to work again correctly for those dependant on it; previously tags= conflicted with tags= in Apprise)
  • XMPP server hostname can differentiate to what is found in JID in https://github.com/caronc/apprise/pull/1560
  • fixed issue with mailto:// when using yahoo.com in https://github.com/caronc/apprise/pull/1561
  • Fluxer time dependant unittest assertion optimized for slower systems in https://github.com/caronc/apprise/pull/1566
  • fixed templating references impacting url generation (on https://appriseit.com) in https://github.com/caronc/apprise/pull/1582
  • fixed KeyError Exception thrown when certain emoji's specified in https://github.com/caronc/apprise/pull/1592

:bulb: Features

  • Migrate the Dot. (Quote/0) plugin from API v1 to API v2 by @HerbertGao in https://github.com/caronc/apprise/pull/1512
    • Updated Dot. plugin to better align with Apprise in https://github.com/caronc/apprise/pull/1588
  • URLs that can not be loaded are more verbose for the reasoning in https://github.com/caronc/apprise/pull/1568
  • Webex wxteams:// Bot API Support in https://github.com/caronc/apprise/pull/1567
  • fixes parse_url() -> url() -> parse_url() inconsistency in https://github.com/caronc/apprise/pull/1572
  • Pushover Delivery Group Support in https://github.com/caronc/apprise/pull/1563
  • Matrix token template cleanup in https://github.com/caronc/apprise/pull/1573
  • fcm:// add apns-push-type header for reliable iOS delivery by @AlbertoLanaro in https://github.com/caronc/apprise/pull/1577
  • Home Assistant "Service' Notification Support Added (extension to what was already there) in https://github.com/caronc/apprise/pull/1294
  • Added attachment support to Mattermost in https://github.com/caronc/apprise/pull/1583
  • :fire: Matrix E2EE Support in https://github.com/caronc/apprise/pull/1574
  • Matrix Hookshot support added in https://github.com/caronc/apprise/pull/1586
  • Mastodon supports hashtag/user references in https://github.com/caronc/apprise/pull/1587
  • PushPlus refactored to support more options in https://github.com/caronc/apprise/pull/1589
  • Inproved azure:// error handling and message responses in https://github.com/caronc/apprise/pull/1499

:heart: Life-Cycle Support

  • Update LoC badge by @github-actions[bot] in https://github.com/caronc/apprise/pull/1554
  • Memory-Optimized Plugin Management in https://github.com/caronc/apprise/pull/1557
  • Ruff linter configuration updated and applied to entire codebase in https://github.com/caronc/apprise/pull/1562
  • i18n(pt_BR): add Brazilian Portuguese translation by @opastorello in https://github.com/caronc/apprise/pull/1580
  • i18n(es): add Spanish translation by @opastorello in https://github.com/caronc/apprise/pull/1581

Installation

Apprise is available on PyPI through pip:

# Install Apprise v1.10.0 from PyPI
pip install apprise==1.10.0

New Contributors

  • @AlbertoLanaro made their first contribution in https://github.com/caronc/apprise/pull/1577
  • @opastorello made their first contribution in https://github.com/caronc/apprise/pull/1579

Full Changelog: https://github.com/caronc/apprise/compare/v1.9.9...v1.10.0

v1.9.8 New feature
Notable features
  • IRC support with ZNC bouncer
  • XMPP support restored
  • Viber Bot and Fluxer support
v1.9.7 Maintenance
Notable features
  • Config YAML tags support
  • Signal text_mode=styled formatting

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

About

Stars
16,661
Forks
602
Languages
Python Roff Shell

Install & Platforms

Install via
pip

Community & Support

Beta — feedback welcome: [email protected]