From 85b2a674aeb0019217c401ff79e1b1378e943dc4 Mon Sep 17 00:00:00 2001 From: Philipp Heckel Date: Sat, 20 Aug 2022 22:22:18 -0400 Subject: [PATCH] WIP: Integrations page with links to projects --- docs/integrations.md | 66 ++++++++++++++++++++++++++++++++++++++++++++ mkdocs.yml | 1 + 2 files changed, 67 insertions(+) create mode 100644 docs/integrations.md diff --git a/docs/integrations.md b/docs/integrations.md new file mode 100644 index 00000000..8ad81e1e --- /dev/null +++ b/docs/integrations.md @@ -0,0 +1,66 @@ +# Integrations + community projects + +There are quite a few projects that work with ntfy, integrate ntfy, or have been built around ntfy. It's super exciting to see what you guys have come up with. Feel free to [create a pull request on GitHub](https://github.com/binwiederhier/ntfy/issues) to add your own project here. + +## Public ntfy servers + +| URL | Country | +|-----------------------------------------------|:---------:| +| [ntfy.sh](https://ntfy.sh/) (*Official*) | ๐Ÿ‡บ๐Ÿ‡ธ | +| [ntfy.tedomum.net](https://ntfy.tedomum.net/) | ๐Ÿ‡ซ๐Ÿ‡ท ๐Ÿ‡ช๐Ÿ‡บ | +| [ntfy.jae.fi](https://ntfy.jae.fi/) | ๐Ÿ‡ซ๐Ÿ‡ฎ ๐Ÿ‡ช๐Ÿ‡บ | + +## Apps that support ntfy (via [UnifiedPush](https://unifiedpush.org/users/apps/)) +- [Tusky](https://tusky.app/) (Fediverse client) +- [Fedilab](https://fedilab.app/) (Fediverse client) +- [Element](https://f-droid.org/packages/im.vector.app/) (Matrix client) +- [SchildiChat](https://schildi.chat/android/) (Matrix client) +- [FindMyDevice](https://gitlab.com/Nulide/findmydevice/) +- [Tox Push Message App](https://github.com/zoff99/tox_push_msg_app) + +## Official integrations + +- [Apprise](https://github.com/caronc/apprise/wiki/Notify_ntfy) +- [Robusta](https://docs.robusta.dev/master/catalog/sinks/webhook.html) - open source platform for Kubernetes troubleshooting +- [borgmatic](https://torsion.org/borgmatic/docs/how-to/monitor-your-backups/#third-party-monitoring-services) - configuration-driven backup software for servers and workstations + +## Libraries + +- [ntfy-php-library](https://github.com/VerifiedJoseph/ntfy-php-library) - PHP library for sending messages using a ntfy server +- [ntfy-notifier](https://github.com/DAcodedBEAT/ntfy-notifier) - Symfony Notifier integration for ntfy +- [ntfpy](https://github.com/Nevalicjus/ntfpy) - Python API Wrapper for ntfy.sh +- [pyntfy](https://github.com/DP44/pyntfy) - A Python module for interacting with ntfy notifications +- [vntfy](https://github.com/lmangani/vntfy) - Barebone V client for ntfy +- [ntfy-middleman](https://github.com/nachotp/ntfy-middleman) - Wraps APIs and send notifications using ntfy.sh on schedule (Python) + +## CLIs and graphical user interfaces + +- [ntfy.sh.sh](https://github.com/mininmobile/ntfy.sh.sh) - Run scripts on ntfy.sh events +- [ntfy Desktop client](https://github.com/mininmobile/ntfy-desktop) - Cross-platform desktop application for ntfy +- [ntfy svelte front-end](https://github.com/novatorem/Ntfy) - Front-end built with svelte +- [wio-ntfy-ticker](https://github.com/nachotp/wio-ntfy-ticker) - Ticker display for a ntfy.sh topic +- [ntfysh-windows](https://github.com/lucas-bortoli/ntfysh-windows) - A ntfy client for Windows Desktop +- [ntfyr](https://github.com/haxwithaxe/ntfyr) - A simple commandline tool to send notifications to ntfy + +## Scripts and other things + +- [Grafana-to-ntfy](https://github.com/kittyandrew/grafana-to-ntfy) - Grafana-to-ntfy alerts channel (Rust) +- [ntfy-long-zsh-command](https://github.com/robfox92/ntfy-long-zsh-command) - Notifies you once a long-running command completes (zsh) +- [ntfy-shellscripts](https://github.com/nickexyz/ntfy-shellscripts) - A few scripts for the ntfy project (Shell) +- [QuickStatus](https://github.com/corneliusroot/QuickStatus) - A shell script to alert to any immediate problems upon login (Shell) +- [ntfy.el](https://github.com/shombando/ntfy) - Send notifications from Emacs (Emacs) +- [backup-projects](https://gist.github.com/anthonyaxenov/826ba65abbabd5b00196bc3e6af76002) - Stupidly simple backup script for own projects (Shell) +- [grav-plugin-whistleblower](https://github.com/Himmlisch-Studios/grav-plugin-whistleblower) - Grav CMS plugin to get notifications via ntfy (PHP) +- [ntfy-server-status](https://github.com/filip2cz/ntfy-server-status) - Checking if server is online and reporting through ntfy (C) +- [borg-based backup](https://github.com/davidhi7/backup) - Simple borg-based backup script with notifications based on ntfy.sh or Discord webhooks (Python/Shell) + +## Blog + forum posts + +- [4 cool new projects to try in Copr](https://fedoramagazine.org/4-cool-new-projects-to-try-in-copr-for-august-2022/) - 8/2022 +- [Easy notifications from R](https://sometimesir.com/posts/easy-notifications-from-r/) - 6/2022 +- [ๆ— ้œ€ๆณจๅ†Œ็š„้€š็ŸฅๆœๅŠกntfy](https://wbsu2003.4everland.app/2022/05/30/%E6%97%A0%E9%9C%80%E6%B3%A8%E5%86%8C%E7%9A%84%E9%80%9A%E7%9F%A5%E6%9C%8D%E5%8A%A1ntfy/) - 5/2022 +- [Updated review post (Jan-Lukas Else)](https://jlelse.blog/thoughts/2022/04/ntfy) - 4/2022 +- [Lemmy post (Jakob)](https://lemmy.eus/post/15541) - 1/2022 +- [Short ntfy review (Jan-Lukas Else)](https://jlelse.blog/links/2021/12/ntfy-sh) - 12/2021 +- [Free MacroDroid webhook alternative (FrameXX)](https://www.macrodroidforum.com/index.php?threads/ntfy-sh-free-macrodroid-webhook-alternative.1505/) - 12/2021 +- [ntfy otro sistema de notificaciones pub-sub simple basado en HTTP](https://ugeek.github.io/blog/post/2021-11-05-ntfy-sh-otro-sistema-de-notificaciones-pub-sub-simple-basado-en-http.html) - 11/2021 diff --git a/mkdocs.yml b/mkdocs.yml index 4398d4ec..5a13edee 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -85,6 +85,7 @@ nav: - "Other things": - "FAQs": faq.md - "Examples": examples.md + - "Integrations + projects": integrations.md - "Release notes": releases.md - "Deprecation notices": deprecations.md - "Emojis ๐Ÿฅณ ๐ŸŽ‰": emojis.md