aiontfy

Asynchronous client library for the ntfy pub-sub notification service

PyPI - Downloads

📖 Documentation

Full Documentation: https://tr4nt0r.github.io/aiontfy
Source Code: https://github.com/tr4nt0r/aiontfy

📦 Installation

You can install aiontfy via pip:

pip install aiontfy

🚀 Usage

Basic Examples

"""Publish to a ntfy topic."""

import asyncio

from aiohttp import ClientSession

from aiontfy import Message, Ntfy


async def main() -> None:
    async with ClientSession() as session:

        ntfy = Ntfy("https://ntfy.sh", session)

        message = Message(
            topic="aiontfy",
            title="Hello",
            message="World",
            click="https://example.com/",
            delay="10s",
            priority=3,
            tags=["octopus"],
        )
        print(await ntfy.publish(message))

asyncio.run(main())

"""Subscribe to ntfy topics."""

import asyncio

from aiohttp import ClientSession

from aiontfy import Event, Notification, Ntfy


def callback(message: Notification) -> None:
    """Process notifications callback function."""
    if message.event is Event.MESSAGE:
        print(message.to_dict())


async def main() -> None:
    async with ClientSession() as session:
        ntfy = Ntfy("https://ntfy.sh", session)

        await ntfy.subscribe(
            ["aiontfy", "test"],  # Subscribe to multiple topics
            callback,
            priority=[3, 4, 5],  # Only subscribe to priority >= 3
        )


asyncio.run(main())

For more advanced usage, refer to the documentation.

🛠 Contributing

Contributions are welcome! To contribute:

Fork the repository.
Create a new branch.
Make your changes and commit them.
Submit a pull request.

Make sure to follow the contributing guidelines.

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

❤️ Support

If you find this project useful, consider buying me a coffee ☕ or sponsoring me on GitHub!

Metadata

Release files for aiontfy 0.8.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aiontfy 0.8.2
File	Size	Uploaded
aiontfy-0.8.2.tar.gz	26.6 kB	Mar 29, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for aiontfy 0.8.2
File	Interpreter	ABI	Platform	Reset
aiontfy-0.8.2-py3-none-any.whl 15.4 kB Mar 29, 2026	Python 3	none	any	Details

Total release size: 42.0 kB

Release files / aiontfy-0.8.2.tar.gz

Download URL	aiontfy-0.8.2.tar.gz
Size	26.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`f3a9d4cb75aec994b60b0d4ffe89b715d943468e30838dc8c2e6c1ec4880171c`
BLAKE2b-256 checksum How to use checksums	`d824ef12ee891a2247770860f9a04361922e9171f00a4af830d9bd420a026b39`
Upload date	Mar 29, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`Hatch/1.16.5 cpython/3.12.3 HTTPX/0.28.1`

Release files / aiontfy-0.8.2-py3-none-any.whl

Download URL	aiontfy-0.8.2-py3-none-any.whl
Size	15.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`27616f9b5f27d48f19dea60c7713de43eae587e7e4ffc5b06bbb143a74562ddf`
BLAKE2b-256 checksum How to use checksums	`a666f36f84c65db750bcd0d58e111ec74fa78dc9e35c9df1143752e4e7846f4c`
Upload date	Mar 29, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`Hatch/1.16.5 cpython/3.12.3 HTTPX/0.28.1`