caronc /apprise
Apprise - Push Notifications that work with just about every platform!
★ 17,771⑂ 700👁 75⑃ 1,010● 742▤ 69
+6
日增长
17,771
stars
700
forks
75
watchers
1,010
prs
742
issues
69
releases
README
!Apprise Logo ap·prise / verb To inform or tell (someone). To make one aware of something. Apprise allows you to send a notification to almost all of the most popular notification services available to us today such as: Telegram, Discord, Slack, Amazon SNS, Gotify, etc. One notification library to rule them all. A common and intuitive notification syntax. Supports the handling of images and attachments (_to the notification services that will accept them_). It's incredibly lightweight. Amazing response times because all messages sent asynchronously. Developers who wish to provide a notification service no longer need to research each and every one out there. They no longer need to try to adapt to the new ones that comeout thereafter. They just need to include this one library and then they can immediately gain access to almost all of the notifications services available to us today. System Administrators and DevOps who wish to send a notification now no longer need to find the right tool for the job. Everything is already wrapped and supported within the apprise command line tool (CLI) that ships with this product. Visit the Official Documentation site for more information on Apprise. How It Works Apprise provides one consistent URL format and notification interface for your apps, automation, and infrastructure. Use the CLI or core library directly, or relay through Apprise API, to deliver notifications to a very large amount of supported services. Table of Contents Supported Notifications Productivity Based Notifications SMS Notifications Desktop Notifications Email Notifications Custom Notifications Installation Command Line Usage Configuration Files File Attachments Loading Custom Notifications/Hooks Environment Variables Developer API Usage Configuration Files File Attachments Loading Custom Notifications/Hooks Persistent Storage More Supported Links and Documentation Supported Notifications The section identifies all of the services supported by this library. Check out the wiki for more information on the supported modules here. Productivity Based Notifications The table below identifies the services this tool supports and some example service URLs you need to use in order to take advantage of it. Click on any of the services listed below to get more details on how you can configure Apprise to access them. If you're having trouble constructing your own URL; try our Apprise URL Builder out. | Notification Service | Service ID | Default Port | Example Syntax | | -------------------- | ---------- | ------------ | -------------- | | AMQP | amqp:// or amqps:// | (TCP) 5672 or 5671 | amqp://hostname/queueamqp://user:pass@hostname/queue1/queue2amqps://user:pass@hostname/?exchange=alertsamqps://user:pass@hostname/?version=1.0&to=/queues/name | Apprise API | apprise:// or apprises:// | (TCP) 80 or 443 | apprise://hostname/Tokenapprise://:password@hostname/Tokenapprise:/
Top issues
#986Support Threema (Gateway)19 comments · 2023-11-01#778API for message body limits8 comments · 2022-12-06#816Feature request: Ability to see formatted/rendered preview4 comments · 2023-02-07#420Is there something like Apprise for pulling notifications?4 comments · 2021-08-08#894Windows Notifications Staying in Notification Center3 comments · 2023-06-25#1282SimpleX2 comments · 2025-02-09#699Support editing previously sent messages and/or threads2 comments · 2022-10-14#1713Synology ChatPlus 1.0.0-00776 not working with Apprise1 comments · 2026-08-28
Discussions
#1883Unique Notifications per monitor0 comments · 2026-11-10#1870pika 1.5.0 ships November 17, 2026: please try 1.5.0rc40 comments · 2026-11-03#1867Cannot send a notification to a new matrix room (room version is different)1 comments · 2026-11-02#1794Would a post about an Apprise-compatible hosted gateway be welcome here?1 comments · 2026-10-15#1790Could I help out more?1 comments · 2026-10-14#1787MS Teams: Cannot send with apprise 2.01 comments · 2026-10-13#1741Discord and botname parameter1 comments · 2026-09-22#1677Infomaniak : Unable to correctly configure1 comments · 2026-07-20
Latest release
Apprise v2.2.0 v2.2.0 2026-11-08What's Changed This release has a few bugfixes, but introuces a slew of (12) new services bringing the total supported services up to 183. The foundation of the Apprise library has now made it very easy to just scan missing service's upstream APIs and add them to our catalog. There are so many examples now to use as reference. A big kudos to @LuisFigueroaG for all of your contributions for the last 2 releases; I really appeciate it! Note: There is a security fix in this release: GHSA-cfp4-m43r-v9q4 :mega: New Notification Services Add Groundmail notification support (groundmail://)