Android-Notify

Android Notify is a Python library for effortlessly creating and managing Android notifications in Kivy and Flet apps.

Supports various styles and ensures seamless integration, customization and Pythonic APIs.

Features

Multiple Notification Styles: Support for various notification styles including:
- Simple text notifications
- Progress bar notifications (determinate and indeterminate)
- Large icon notifications
- Big picture notifications
- Combined image styles
- Custom notification Icon - images section
- Big text notifications
- Inbox-style notifications
- Colored texts and Icons
Rich Functionality:
- Add action Buttons with custom callbacks - Buttons section
- Update notification content dynamically
- Manage progress bars with fine-grained control
- Custom notification channels for Android 8.0+ (Creating and Deleting)
- Silent notifications
- Persistent notifications
- Click handlers and callbacks
- Cancel Notifications
- Use Custom Sound
- Vibration section

Quick Start

from android_notify import Notification

# Simple notification
Notification(
    title="Hello",
    message="This is a basic notification."
).send()

Sample Image:
basic notification img sample

Installation

Kivy apps:

In your buildozer.spec file, ensure you include the following:

# Add requirements list
requirements = python3, kivy, pyjnius, android-notify
# Add permission for notifications
android.permissions = POST_NOTIFICATIONS

Flet apps:

In your pyproject.toml file, ensure you include the following:

[tool.flet.android]
dependencies = [
  "pyjnius", "android-notify"
]

[tool.flet.android.permission]
"android.permission.POST_NOTIFICATIONS" = true

example of complete flet pyproject.toml

On Pydroid 3

On the pydroid 3 mobile app for running python code you can test some features.

In pip section where you're asked to insert Libary name paste android-notify
Minimal working example

from kivy.app import App
from kivy.uix.boxlayout import BoxLayout
from kivy.uix.button import Button
from android_notify import Notification, NotificationHandler


class AndroidNotifyDemoApp(App):
    def build(self):
        layout = BoxLayout(orientation='vertical', spacing=10, padding=20)
        layout.add_widget(Button(
            text="Ask Notification Permission",
            on_release=self.request_permission
        ))
        layout.add_widget(Button(
            text="Send Notification",
            on_release=self.send_notification
        ))
        return layout

    def request_permission(self, *args):
        NotificationHandler.asks_permission()

    def send_notification(self, *args):
        Notification(
            title="Hello from Android Notify",
            message="This is a basic notification."
        ).send()


if __name__ == "__main__":
    AndroidNotifyDemoApp().run()

Desktop

For IDE IntelliSense Can be installed via pip install:

pip install android_notify
android-notify -v

For Agents

Full Api Reference: https://android-notify.vercel.app/api/android-notify-v1.61-api.md

Common Methods

For full visit documentation for more examples and advanced usage.

For Images

Source can be local file paths or complete URLs execpt setSmallIcon which only accepts local png files.

setBigPicture - shows below when user clicks drop button
setLargeIcon - appears at right side of notification content
setSmallIcon - changes app icon to a custom png
setColor - changes app icon backgroud Color

For online images URL should with https:// and you need internet permission android.permissions = INTERNET in buildozer.spec or pyproject.toml

from android_notify import Notification

notification = Notification(
    title='Picture Alert!',
    message='This notification uses setLargelcon and setBig Picture method.'
)
notification.setBigPicture("imgs/photo.png")
notification.setLargeIcon("imgs/profile.png")
notification.send()

Sample Image:
basic notification img sample

from android_notify import Notification

notification = Notification(
    title='Custom Icon and Color',
    message='This notification uses setColor and setSmallIcon.'
)
notification.setColor("red")
notification.setSmallIcon("love.png")
notification.send()

Sample Image:
basic notification img sample

For ProgressBar

updateProgressBar(current_value, message, title) - update progress in real-time
showInfiniteProgressBar - shows an infinite progress animation.
removeProgressBar(message, show_on_update=True, title) - Cleanly remove the progress bar.

from android_notify import Notification
from kivy.clock import Clock

progress = 0

notification = Notification(
    title="Downloading...", message="0% downloaded",
    progress_current_value=0, progress_max_value=100
)
notification.send()

def update_progress(dt):
    global progress
    progress = min(progress + 10, 100)
    
    if progress==100:
        notification.removeProgressBar(title="File Downloaded", message="super_large_file.zip")
    elif progress >= 80:
        notification.showInfiniteProgressBar()
    else:
        notification.updateProgressBar(progress, f"{progress}% downloaded")

    return progress < 100  # Ends loop when reaching 100%

Clock.schedule_interval(update_progress, 3)

progressbar img sample

For texts

addLine - adds a line to the notification, useful for inbox style
setSubText - sets a smaller text that appears at the side of app name
setBigText - sets a longer text that appears when the notification is expanded
updateTitle - updates the title text of the notification
updateMessage - updates the main message text of the notification

from android_notify import Notification

notification = Notification(
    title="5 New mails from Frank",
    message="Check them out",
)
notification.setSubText("FabianCodes")
notification.setLargeIcon("imgs/profile.png")
notification.addLine("Re: Planning")
notification.addLine("Delivery on its way")
notification.addLine("Follow-up")
notification.send()

inbox-subtext img sample

Documentation

For full documentation, examples, and advanced usage, API reference visit the documentation

For Dev Version usage

requirements = python3, kivy, pyjnius, https://github.com/Fector101/android_notify/archive/main.zip

Dev Features docs

To use Custom Sounds

Option 1: Audio files bundled in res/raw

Put audio files in res/raw folder,
Then from buildozer.spec point to res folder android.add_resources = res
and includes it's format source.include_exts = wav.

Lastly From the code

# Create a custom notification channel with a unique sound resource for android 8+
Notification.createChannel(
    id="weird_sound_tester",
    name="Weird Sound Tester",
    description="A test channel for custom sounds from the res/raw folder.",
    res_sound_name="sneeze" # file name without .wav or .mp3
)

# Send a notification through the created channel
n=Notification(
    title="Custom Sound Notification",
    message="This tests playback of a custom sound (sneeze.wav) stored in res/raw.",
    channel_id="weird_sound_tester" # important tells notification to use right channel
)
n.setSound("sneeze")# for android 7 below 
n.send()

Option 2: Local file path or URI (sound_path)

You can use a local audio file, a content://, file://, or android.resource:// URI directly:

# Using a local file path
Notification.createChannel(
    id="local_sound",
    name="Local Sound",
    sound_path="/storage/emulated/0/Download/alert.mp3"
)

# Using a content URI (e.g., from media store)
Notification.createChannel(
    id="uri_sound",
    name="URI Sound",
    sound_path="content://media/external/audio/media/123"
)

# Send notification with custom sound path
n = Notification(
    title="Custom Sound",
    message="Playing from local path",
    channel_id="local_sound"
)
n.setSound(sound_path="/storage/emulated/0/Download/alert.mp3")
n.send()

Private files (e.g., in app's data/ directory) are automatically copied to external storage before playing.

Add Data to Notification

NotificationHandler.data_object returns a dict of data in the clicked notification
setData can also be called after send to change data_object stored
Use name if value is constant Notification(name="change page")

from android_notify import Notification, NotificationHandler

    def build(self):
        notification = Notification(title="Hello")
        notification.setData({"next wallpaper path": "test.jpg"})
        notification.send()

    def on_start(self):
        notification_data = NotificationHandler.data_object  # {"next wallpaper path": "test.jpg",...}
        print(notifcation_data)

    def on_resume(self):
        notification_data = NotificationHandler.data_object  # {"next wallpaper path": "test.jpg",...}
        print(notifcation_data)

How to control popups

from android_notify import Notification
import time

notification = Notification(
    title="Processing...",
    message="Starting task"
)

notification.send()
time.sleep(10)

# show heads-up when updated
notification.setOnlyAlertOnce(False)

notification.updateTitle("Processing Complete!")
notification.updateMessage("Task finished successfully")

☕ Support the Project

If you find this project helpful, consider buying me a coffee! 😊
Or Giving it a star on 🌟 GitHub Your support helps maintain and improve the project.

Bug Reports & Feature Requests

Found a bug or have an idea for a new feature?
Feel free to open an issue here

When reporting a bug, try to include:

Device name
Android version
Steps to reproduce the issue
Screenshots or logs (if possible)

Feature suggestions are also welcome.

Development Status
- 5 - Production/Stable
Intended Audience
- Developers
Operating System
- Android
Programming Language
- Python :: 3
Topic
- Software Development :: Libraries :: Python Modules

Metadata

Development Status
- 5 - Production/Stable
Intended Audience
- Developers
Operating System
- Android
Programming Language
- Python :: 3
Topic
- Software Development :: Libraries :: Python Modules

Release files for android-notify 1.61.8

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

Source distribution (sdist)

Source distribution for android-notify 1.61.8
File	Size	Uploaded
android_notify-1.61.8.tar.gz	115.2 kB	Sep 18, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for android-notify 1.61.8
File	Interpreter	ABI	Platform	Reset
android_notify-1.61.8-py3-none-any.whl 128.4 kB Sep 18, 2026	Python 3	none	any	Details

Total release size: 243.7 kB

Release files / android_notify-1.61.8.tar.gz

Download URL	android_notify-1.61.8.tar.gz
Size	115.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`713b826474e8dd6b87310788534abc0c1fa9bce75c935c88028ce39ff70ff222`
BLAKE2b-256 checksum How to use checksums	`c46c2965cc52bdd0452376739bdd4630c27056ed22a55f71e8a20ed0f78ba887`
Upload date	Sep 18, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Fector101/android_notify
Publishing commit: github.com/Fector101/android_notify/tree/b7c19f00259f17ee4f4fce17eb10b5606a633844

Workflow

Publishing configuration: github.com/Fector101/android_notify/blob/b7c19f00259f17ee4f4fce17eb10b5606a633844/.github/workflows/publish.yml
Publishing logs: github.com/Fector101/android_notify/actions/runs/35404393295/attempts/1

Artifact

Subject: android_notify-1.61.8.tar.gz
SHA-256 checksum: 713b826474e8dd6b87310788534abc0c1fa9bce75c935c88028ce39ff70ff222 Verifying attestations

Release files / android_notify-1.61.8-py3-none-any.whl

Download URL	android_notify-1.61.8-py3-none-any.whl
Size	128.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`34e209b880c4ba15683d8aefe75dcf5b3aadf9d47dd86a358df4b20f14f14933`
BLAKE2b-256 checksum How to use checksums	`4a4c049e806420a359be560de17361219fccd0d16efc09f70da2b3907dd100d4`
Upload date	Sep 18, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Fector101/android_notify
Publishing commit: github.com/Fector101/android_notify/tree/b7c19f00259f17ee4f4fce17eb10b5606a633844

Workflow

Publishing configuration: github.com/Fector101/android_notify/blob/b7c19f00259f17ee4f4fce17eb10b5606a633844/.github/workflows/publish.yml
Publishing logs: github.com/Fector101/android_notify/actions/runs/35404393295/attempts/1

Artifact

Subject: android_notify-1.61.8-py3-none-any.whl
SHA-256 checksum: 34e209b880c4ba15683d8aefe75dcf5b3aadf9d47dd86a358df4b20f14f14933 Verifying attestations