Home

Awesome

ntfy

ntfy.sh | Send push notifications to your phone or desktop via PUT/POST

Release Go Reference Tests Go Report Card codecov Discord Matrix Matrix space Healthcheck Gitpod

ntfy (pronounced "notify") is a simple HTTP-based pub-sub notification service. With ntfy, you can send notifications to your phone or desktop via scripts from any computer, without having to sign up or pay any fees. If you'd like to run your own instance of the service, you can easily do so since ntfy is open source.

You can access the free version of ntfy at ntfy.sh. There is also an open-source Android app available on Google Play or F-Droid, as well as an open source iOS app available on the App Store.

<p> <img src=".github/images/screenshot-curl.png" height="180"> <img src=".github/images/screenshot-web-detail.png" height="180"> <img src=".github/images/screenshot-phone-main.jpg" height="180"> <img src=".github/images/screenshot-phone-detail.jpg" height="180"> <img src=".github/images/screenshot-phone-notification.jpg" height="180"> </p>

ntfy Pro 💸 🎉

I now offer paid plans for ntfy.sh if you don't want to self-host, or you want to support the development of ntfy (→ Purchase via web app). You can buy a plan for as low as $5/month. You can also donate via GitHub Sponsors, and Liberapay. I would be very humbled by your sponsorship. ❤️

Documentation

Getting started | Android/iOS | API | Install / Self-hosting | Building

Chat/forum

There are a few ways to get in touch with me and/or the rest of the community. Feel free to use any of these methods. Whatever works best for you:

Announcements/beta testers

For announcements of new releases and cutting-edge beta versions, please subscribe to the ntfy.sh/announcements topic. If you'd like to test the iOS app, join TestFlight. For Android betas, join Discord/Matrix (I'll eventually make a testing channel in Google Play).

Contributing

I welcome any contributions. Just create a PR or an issue. For larger features/ideas, please reach out on Discord/Matrix first to see if I'd accept them. To contribute code, check out the build instructions for the server and the Android app. Or, if you'd like to help translate 🇩🇪 🇺🇸 🇧🇬, you can start immediately in Hosted Weblate.

<a href="https://hosted.weblate.org/engage/ntfy/"> <img src="https://hosted.weblate.org/widgets/ntfy/-/multi-blue.svg" alt="Translation status" /> </a>

Sponsors

I have just very recently started accepting donations via GitHub Sponsors, and Liberapay. I would be humbled if you helped me carry the server and developer account costs. Even small donations are very much appreciated. A big fat Thank You to the folks who have sponsored ntfy in the past, or are still sponsoring ntfy:

<a href="https://github.com/neutralinsomniac"><img src="https://github.com/neutralinsomniac.png" width="40px" /></a> <a href="https://github.com/aspyct"><img src="https://github.com/aspyct.png" width="40px" /></a> <a href="https://github.com/nickexyz"><img src="https://github.com/nickexyz.png" width="40px" /></a> <a href="https://github.com/qcasey"><img src="https://github.com/qcasey.png" width="40px" /></a> <a href="https://github.com/mckay115"><img src="https://github.com/mckay115.png" width="40px" /></a> <a href="https://github.com/Salamafet"><img src="https://github.com/Salamafet.png" width="40px" /></a> <a href="https://github.com/codinghipster"><img src="https://github.com/codinghipster.png" width="40px" /></a> <a href="https://github.com/HinFort"><img src="https://github.com/HinFort.png" width="40px" /></a> <a href="https://github.com/Lexevolution"><img src="https://github.com/Lexevolution.png" width="40px" /></a> <a href="https://github.com/johnnyip"><img src="https://github.com/johnnyip.png" width="40px" /></a> <a href="https://github.com/JonDerThan"><img src="https://github.com/JonDerThan.png" width="40px" /></a> <a href="https://github.com/12nick12"><img src="https://github.com/12nick12.png" width="40px" /></a> <a href="https://github.com/eanplatter"><img src="https://github.com/eanplatter.png" width="40px" /></a> <a href="https://github.com/fnoelscher"><img src="https://github.com/fnoelscher.png" width="40px" /></a> <a href="https://github.com/bnorick"><img src="https://github.com/bnorick.png" width="40px" /></a> <a href="https://github.com/snh"><img src="https://github.com/snh.png" width="40px" /></a> <a href="https://github.com/hen-x"><img src="https://github.com/hen-x.png" width="40px" /></a> <a href="https://github.com/JamieGoodson"><img src="https://github.com/JamieGoodson.png" width="40px" /></a> <a href="https://github.com/cremesk"><img src="https://github.com/cremesk.png" width="40px" /></a> <a href="https://github.com/dangowans"><img src="https://github.com/dangowans.png" width="40px" /></a> <a href="https://github.com/mnault"><img src="https://github.com/mnault.png" width="40px" /></a> <a href="https://github.com/nwithan8"><img src="https://github.com/nwithan8.png" width="40px" /></a> <a href="https://github.com/peterleiser"><img src="https://github.com/peterleiser.png" width="40px" /></a> <a href="https://github.com/portothree"><img src="https://github.com/portothree.png" width="40px" /></a> <a href="https://github.com/finngreig"><img src="https://github.com/finngreig.png" width="40px" /></a> <a href="https://github.com/skrollme"><img src="https://github.com/skrollme.png" width="40px" /></a> <a href="https://github.com/gergepalfi"><img src="https://github.com/gergepalfi.png" width="40px" /></a> <a href="https://github.com/tonyakwei"><img src="https://github.com/tonyakwei.png" width="40px" /></a> <a href="https://github.com/crosbyh"><img src="https://github.com/crosbyh.png" width="40px" /></a> <a href="https://github.com/mdlnr"><img src="https://github.com/mdlnr.png" width="40px" /></a> <a href="https://github.com/p-samuel"><img src="https://github.com/p-samuel.png" width="40px" /></a> <a href="https://github.com/zugaldia"><img src="https://github.com/zugaldia.png" width="40px" /></a> <a href="https://github.com/NathanSweet"><img src="https://github.com/NathanSweet.png" width="40px" /></a> <a href="https://github.com/msdeibel"><img src="https://github.com/msdeibel.png" width="40px" /></a> <a href="https://github.com/ksurl"><img src="https://github.com/ksurl.png" width="40px" /></a> <a href="https://github.com/CodingTimeDEV"><img src="https://github.com/CodingTimeDEV.png" width="40px" /></a> <a href="https://github.com/Terrormixer3000"><img src="https://github.com/Terrormixer3000.png" width="40px" /></a> <a href="https://github.com/voroskoi"><img src="https://github.com/voroskoi.png" width="40px" /></a> <a href="https://github.com/Nickwasused"><img src="https://github.com/Nickwasused.png" width="40px" /></a> <a href="https://github.com/bahur142"><img src="https://github.com/bahur142.png" width="40px" /></a> <a href="https://github.com/vinhdizzo"><img src="https://github.com/vinhdizzo.png" width="40px" /></a> <a href="https://github.com/Ge0rg3"><img src="https://github.com/Ge0rg3.png" width="40px" /></a> <a href="https://github.com/biopsin"><img src="https://github.com/biopsin.png" width="40px" /></a> <a href="https://github.com/thebino"><img src="https://github.com/thebino.png" width="40px" /></a> <a href="https://github.com/sky4055"><img src="https://github.com/sky4055.png" width="40px" /></a> <a href="https://github.com/julianlam"><img src="https://github.com/julianlam.png" width="40px" /></a> <a href="https://github.com/andreapx"><img src="https://github.com/andreapx.png" width="40px" /></a> <a href="https://github.com/billycao"><img src="https://github.com/billycao.png" width="40px" /></a> <a href="https://github.com/zoic21"><img src="https://github.com/zoic21.png" width="40px" /></a> <a href="https://github.com/IanKulin"><img src="https://github.com/IanKulin.png" width="40px" /></a> <a href="https://github.com/Joachim256"><img src="https://github.com/Joachim256.png" width="40px" /></a> <a href="https://github.com/overtone1000"><img src="https://github.com/overtone1000.png" width="40px" /></a> <a href="https://github.com/oakd"><img src="https://github.com/oakd.png" width="40px" /></a> <a href="https://github.com/KucharczykL"><img src="https://github.com/KucharczykL.png" width="40px" /></a> <a href="https://github.com/hansbickhofe"><img src="https://github.com/hansbickhofe.png" width="40px" /></a> <a href="https://github.com/caseodilla"><img src="https://github.com/caseodilla.png" width="40px" /></a> <a href="https://github.com/0xAF"><img src="https://github.com/0xAF.png" width="40px" /></a> <a href="https://github.com/soonoo"><img src="https://github.com/soonoo.png" width="40px" /></a> <a href="https://github.com/nichu42"><img src="https://github.com/nichu42.png" width="40px" /></a> <a href="https://github.com/samliebow"><img src="https://github.com/samliebow.png" width="40px" /></a> <a href="https://github.com/johman10"><img src="https://github.com/johman10.png" width="40px" /></a> <a href="https://github.com/R-Gld"><img src="https://github.com/R-Gld.png" width="40px" /></a> <a href="https://github.com/FingerlessGlov3s"><img src="https://github.com/FingerlessGlov3s.png" width="40px" /></a> <a href="https://github.com/Twisterado"><img src="https://github.com/Twisterado.png" width="40px" /></a> <a href="https://github.com/ScrumpyJack"><img src="https://github.com/ScrumpyJack.png" width="40px" /></a> <a href="https://github.com/andrejarrell"><img src="https://github.com/andrejarrell.png" width="40px" /></a> <a href="https://github.com/oaustegard"><img src="https://github.com/oaustegard.png" width="40px" /></a> <a href="https://github.com/CreativeWarlock"><img src="https://github.com/CreativeWarlock.png" width="40px" /></a> <a href="https://github.com/darkdragon-001"><img src="https://github.com/darkdragon-001.png" width="40px" /></a> <a href="https://github.com/jonathan-kosgei"><img src="https://github.com/jonathan-kosgei.png" width="40px" /></a> <a href="https://github.com/KevinWang15"><img src="https://github.com/KevinWang15.png" width="40px" /></a> <a href="https://github.com/darkmattercoder"><img src="https://github.com/darkmattercoder.png" width="40px" /></a> <a href="https://github.com/bmcgonag"><img src="https://github.com/bmcgonag.png" width="40px" /></a> <a href="https://github.com/skorokithakis"><img src="https://github.com/skorokithakis.png" width="40px" /></a> <a href="https://github.com/eenturk"><img src="https://github.com/eenturk.png" width="40px" /></a> <a href="https://github.com/spirossi"><img src="https://github.com/spirossi.png" width="40px" /></a> <a href="https://github.com/teomarcdhio"><img src="https://github.com/teomarcdhio.png" width="40px" /></a> <a href="https://github.com/MarcMichalsky"><img src="https://github.com/MarcMichalsky.png" width="40px" /></a> <a href="https://github.com/LuckVintage"><img src="https://github.com/LuckVintage.png" width="40px" /></a> <a href="https://github.com/spartan"><img src="https://github.com/spartan.png" width="40px" /></a> <a href="https://github.com/alexandzors"><img src="https://github.com/alexandzors.png" width="40px" /></a> <a href="https://github.com/dkramer95"><img src="https://github.com/dkramer95.png" width="40px" /></a> <a href="https://github.com/YezGotIt"><img src="https://github.com/YezGotIt.png" width="40px" /></a> <a href="https://github.com/thomasskou"><img src="https://github.com/thomasskou.png" width="40px" /></a> <a href="https://github.com/surfernv"><img src="https://github.com/surfernv.png" width="40px" /></a> <a href="https://github.com/richardleach"><img src="https://github.com/richardleach.png" width="40px" /></a> <a href="https://github.com/bear"><img src="https://github.com/bear.png" width="40px" /></a> <a href="https://github.com/cminter"><img src="https://github.com/cminter.png" width="40px" /></a> <a href="https://github.com/bahur142"><img src="https://github.com/bahur142.png" width="40px" /></a> <a href="https://github.com/pgwiebes"><img src="https://github.com/pgwiebes.png" width="40px" /></a> <a href="https://github.com/ralhei"><img src="https://github.com/ralhei.png" width="40px" /></a> <a href="https://github.com/TechMDW"><img src="https://github.com/TechMDW.png" width="40px" /></a> <a href="https://github.com/ubipo"><img src="https://github.com/ubipo.png" width="40px" /></a> <a href="https://github.com/tka85"><img src="https://github.com/tka85.png" width="40px" /></a> <a href="https://github.com/beekeeb"><img src="https://github.com/beekeeb.png" width="40px" /></a> <a href="https://github.com/Emiliaaah"><img src="https://github.com/Emiliaaah.png" width="40px" /></a> <a href="https://github.com/zark0s"><img src="https://github.com/zark0s.png" width="40px" /></a> <a href="https://github.com/tomershvueli"><img src="https://github.com/tomershvueli.png" width="40px" /></a> <a href="https://github.com/CataIana"><img src="https://github.com/CataIana.png" width="40px" /></a> <a href="https://github.com/ajay-actuary"><img src="https://github.com/ajay-actuary.png" width="40px" /></a> <a href="https://github.com/mursec"><img src="https://github.com/mursec.png" width="40px" /></a> <a href="https://github.com/FrameXX"><img src="https://github.com/FrameXX.png" width="40px" /></a> <a href="https://github.com/vovayartsev"><img src="https://github.com/vovayartsev.png" width="40px" /></a> <a href="https://github.com/dwain-lab"><img src="https://github.com/dwain-lab.png" width="40px" /></a> <a href="https://github.com/brookmg"><img src="https://github.com/brookmg.png" width="40px" /></a> <a href="https://github.com/siebej"><img src="https://github.com/siebej.png" width="40px" /></a> <a href="https://github.com/rxsantos"><img src="https://github.com/rxsantos.png" width="40px" /></a> <a href="https://github.com/hermannx5"><img src="https://github.com/hermannx5.png" width="40px" /></a> <a href="https://github.com/rwxd"><img src="https://github.com/rwxd.png" width="40px" /></a> <a href="https://github.com/Integral-Tech"><img src="https://github.com/Integral-Tech.png" width="40px" /></a> <a href="https://github.com/TheTomik1"><img src="https://github.com/TheTomik1.png" width="40px" /></a> <a href="https://github.com/dav23r"><img src="https://github.com/dav23r.png" width="40px" /></a> <a href="https://github.com/stannynuytkens"><img src="https://github.com/stannynuytkens.png" width="40px" /></a> <a href="https://github.com/danbartram"><img src="https://github.com/danbartram.png" width="40px" /></a> <a href="https://github.com/arthurgleckler"><img src="https://github.com/arthurgleckler.png" width="40px" /></a> <a href="https://github.com/tomroth04"><img src="https://github.com/tomroth04.png" width="40px" /></a> <a href="https://github.com/Circenn5130"><img src="https://github.com/Circenn5130.png" width="40px" /></a> <a href="https://github.com/jceloria"><img src="https://github.com/jceloria.png" width="40px" /></a> <a href="https://github.com/afunworm"><img src="https://github.com/afunworm.png" width="40px" /></a> <a href="https://github.com/PTR-inc"><img src="https://github.com/PTR-inc.png" width="40px" /></a> <a href="https://github.com/spudooli"><img src="https://github.com/spudooli.png" width="40px" /></a> <a href="https://github.com/IMarkoMC"><img src="https://github.com/IMarkoMC.png" width="40px" /></a> <a href="https://github.com/rubund"><img src="https://github.com/rubund.png" width="40px" /></a> <a href="https://github.com/Riolku"><img src="https://github.com/Riolku.png" width="40px" /></a> <a href="https://github.com/arnbrhm"><img src="https://github.com/arnbrhm.png" width="40px" /></a> <a href="https://github.com/herzkerl"><img src="https://github.com/herzkerl.png" width="40px" /></a> <a href="https://github.com/0x45796164"><img src="https://github.com/0x45796164.png" width="40px" /></a> <a href="https://github.com/madchr1st"><img src="https://github.com/madchr1st.png" width="40px" /></a> <a href="https://github.com/avalentic"><img src="https://github.com/avalentic.png" width="40px" /></a> <a href="https://github.com/TheCraiggers"><img src="https://github.com/TheCraiggers.png" width="40px" /></a> <a href="https://github.com/sheetd"><img src="https://github.com/sheetd.png" width="40px" /></a> <a href="https://github.com/dlt-green"><img src="https://github.com/dlt-green.png" width="40px" /></a> <a href="https://github.com/suhlig"><img src="https://github.com/suhlig.png" width="40px" /></a> <a href="https://github.com/Proximus888"><img src="https://github.com/Proximus888.png" width="40px" /></a> <a href="https://github.com/wielandp"><img src="https://github.com/wielandp.png" width="40px" /></a> <a href="https://github.com/chxseh"><img src="https://github.com/chxseh.png" width="40px" /></a> <a href="https://github.com/user8446"><img src="https://github.com/user8446.png" width="40px" /></a> <a href="https://github.com/cdf-eagles"><img src="https://github.com/cdf-eagles.png" width="40px" /></a>

I'd also like to thank JetBrains for their awesome IntelliJ IDEA, and DigitalOcean (referral link) for supporting the project:

<a href="https://m.do.co/c/442b929528db"><img src="https://opensource.nyc3.cdn.digitaloceanspaces.com/attribution/assets/SVG/DO_Logo_horizontal_blue.svg" width="201px"></a>

Code of Conduct

We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, caste, color, religion, or sexual identity and orientation.

We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community.

Please be sure to read the complete Code of Conduct.

License

Made with ❤️ by Philipp C. Heckel.
The project is dual licensed under the Apache License 2.0 and the GPLv2 License.

Third-party libraries and resources: