android-notify 1.61.2.dev0__tar.gz → 1.61.3__tar.gz

{android_notify-1.61.2.dev0 → android_notify-1.61.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: android-notify
-Version: 1.61.2.dev0
+Version: 1.61.3
 Summary: A Python package that simplifies creating Android notifications in Kivy and Flet apps.
 Author-email: Fabian <fector101@yahoo.com>
 License-Expression: MIT
@@ -18,7 +18,7 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Description-Content-Type: text/markdown
 Requires-Dist: pyjnius
 Provides-Extra: dev
-Requires-Dist: kivy>=2.0.0; extra == "dev"
+Requires-Dist: kivy; extra == "dev"
 
 <div align="center">
     <br>
@@ -53,6 +53,8 @@ The Android Notify package provides a simple yet comprehensive way to create and
   - Persistent notifications
   - Click handlers and callbacks
   - Cancel Notifications
+  - Use [Custom Sound](https://android-notify.vercel.app/advanced-methods#custom-sound)
+  - Vibration [section](https://android-notify.vercel.app/advanced-methods#vibration)
 
 ## Quick Start
 
@@ -80,25 +82,48 @@ In your **`buildozer.spec`** file, ensure you include the following:
 
 ```ini
 # Add pyjnius so ensure it's packaged with the build
-requirements = python3, kivy, pyjnius, android-notify==1.61.2.dev0
+requirements = python3, kivy, pyjnius, android-notify
 # Add permission for notifications
 android.permissions = POST_NOTIFICATIONS
+
+# Required dependency (write exactly as shown, no quotation marks)
+android.gradle_dependencies = androidx.core:core-ktx:1.15.0
+android.enable_androidx = True
+android.api = 35
+```
+
+</details>
+
+<details>
+<summary><b>Desktop</b></summary>
+<br/>
+
+For IDE IntelliSense Can be installed via `pip install`:
+
+```bash
+pip install android_notify
+android-notify -v
 ```
 
 </details>
 
+------
+## Installing without Androidx
+How to use without `gradle_dependencies`
+Use `android-notify==1.61.3.dev0` to install via `pip`
+
 
 <details>
 <summary><b>Flet apps:</b></summary>
 <br/>
 
-In your `pyproject.toml` file, ensure you include the following:
+ In your `pyproject.toml` file, ensure you include the following:
 
 
 ```toml
 [tool.flet.android]
 dependencies = [
-  "pyjnius","android-notify==1.61.2.dev0"
+  "pyjnius","android-notify==1.61.3.dev0"
 ]
 
 [tool.flet.android.permission]
@@ -108,7 +133,16 @@ dependencies = [
 
 </details>
 
+<details>
+<summary><b>In Kivy</b></summary>
+<br/>
+
+```ini
+# buildozer.spec
+requirements = python3, kivy, pyjnius, android-notify==1.61.3.dev0
+```
 
+</details>
 
 <details>
 
@@ -116,10 +150,10 @@ dependencies = [
 <br/>
 
 On the [pydroid 3](https://play.google.com/store/apps/details?id=ru.iiec.pydroid3) 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==1.61.2.dev0`
+- In pip section where you're asked to insert `Libary name` paste `android-notify==1.61.3.dev0`
 - Minimal working example 
 ```py
-# Testing with `android-notify==1.61.2.dev0` on pydroid
+# Testing with `android-notify==1.61.3.dev0` on pydroid
 from kivy.app import App
 from kivy.uix.boxlayout import BoxLayout
 from kivy.uix.button import Button
@@ -146,9 +180,7 @@ class AndroidNotifyDemoApp(App):
     def send_notification(self, *args):
         Notification(
             title="Hello from Android Notify",
-            message="This is a basic notification.",
-            channel_id="android_notify_demo",
-            channel_name="Android Notify Demo"
+            message="This is a basic notification."
         ).send()
 
 
@@ -159,134 +191,13 @@ if __name__ == "__main__":
 </details>
 
 
-<details>
-
-<summary><b>Desktop</b></summary>
-<br/>
-
-For IDE IntelliSense Can be installed via `pip install`:
-
-```bash
-pip install android_notify
-android-notify -v
-```
-</details>
 
 ## Documentation
-For Dev Version use
-```ini
-requirements = python3, kivy, pyjnius, https://github.com/Fector101/android_notify/archive/without-androidx.zip
-```
-
-<details>
-<summary> <b> To talk to BroadCast Listener From Buttons </b> </summary>
-
-- Make things happen without being in your app
-```python
-from android_notify import Notification
-notification = Notification(title="Receiver Notification")
-notification.addButton(text="Stop", receiver_name="CarouselReceiver", action="ACTION_STOP")
-notification.addButton(text="Skip", receiver_name="CarouselReceiver", action="ACTION_SKIP")
-```
-You can use this [wiki](https://github.com/Fector101/android_notify/wiki/How-to-Use-with-Broadcast-Listener) as a guide create a broadcast listener
-</details>
-
-<details>
-<summary> <b> To use colored text in your notifications </b> </summary>
-
-- Copy the [res](https://github.com/Fector101/android_notify/tree/main/android_notify/res) folder to your app path.  
-- Lastly in your `buildozer.spec` file  
-Add `source.include_exts = xml` and `android.add_resources = # path you pasted`
-```python
-# Use Hex Code to be Safe
-n = Notification(title="Title and Message Color", message="Testing",title_color="red")
-n.send()
-```
-
-</details>
-
-<details>
-<summary> <b>To use Custom Sounds </b> </summary>
-
-**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 
-```py
-# 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:
-
-```py
-# 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.
-</details>
-
-
-<details>
-<summary> <b> Vibrate feature</b> </summary>
-
+For Dev Version usage
 ```ini
-# buildozer.spec
-android.permissions = VIBRATE
-```
-
-```python
-Notification.createChannel(id='shake', name="Shake Passage", vibrate=True)
-
-n=Notification(title='Vibrate',channel_id='shake')
-n.setVibrate() # for less than android 8
-n.fVibrate() # To Force Vibrate (when user turned off in settings)
-n.send()
+requirements = python3, kivy, pyjnius, https://github.com/Fector101/android_notify/archive/main.zip
 ```
 
-</details>
-
-
 <details>
 <summary> <b> Add Data to Notification</b> </summary>
 
@@ -318,9 +229,19 @@ from android_notify import Notification, NotificationHandler
 
 ## ☕ Support the Project
 
-If you find this project helpful, consider buying me a coffee! 😊  
-Or Giving it a star on 🌟 [GitHub](https://github.com/Fector101/android_notify/) Your support helps maintain and improve the project.
+If you find this project helpful, your support would help me continue working on open-source projects
+[donate](https://www.buymeacoffee.com/fector101)
+
+
+## Bug Reports & Feature Requests
+
+Found a bug or have an idea for a new feature?  
+Feel free to open an issue [here](https://reference-url-citation.invalid/0)
+
+When reporting a bug, try to include:
+- Device name
+- Android version
+- Steps to reproduce the issue
+- Screenshots or logs (if possible)
 
-<a href="https://www.buymeacoffee.com/fector101" target="_blank">
-  <img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" height="60">
-</a>
+Feature suggestions are also welcome.

{android_notify-1.61.2.dev0 → android_notify-1.61.3}/README.md

@@ -31,6 +31,8 @@ The Android Notify package provides a simple yet comprehensive way to create and
   - Persistent notifications
   - Click handlers and callbacks
   - Cancel Notifications
+  - Use [Custom Sound](https://android-notify.vercel.app/advanced-methods#custom-sound)
+  - Vibration [section](https://android-notify.vercel.app/advanced-methods#vibration)
 
 ## Quick Start
 
@@ -58,25 +60,48 @@ In your **`buildozer.spec`** file, ensure you include the following:
 
 ```ini
 # Add pyjnius so ensure it's packaged with the build
-requirements = python3, kivy, pyjnius, android-notify==1.61.2.dev0
+requirements = python3, kivy, pyjnius, android-notify
 # Add permission for notifications
 android.permissions = POST_NOTIFICATIONS
+
+# Required dependency (write exactly as shown, no quotation marks)
+android.gradle_dependencies = androidx.core:core-ktx:1.15.0
+android.enable_androidx = True
+android.api = 35
+```
+
+</details>
+
+<details>
+<summary><b>Desktop</b></summary>
+<br/>
+
+For IDE IntelliSense Can be installed via `pip install`:
+
+```bash
+pip install android_notify
+android-notify -v
 ```
 
 </details>
 
+------
+## Installing without Androidx
+How to use without `gradle_dependencies`
+Use `android-notify==1.61.3.dev0` to install via `pip`
+
 
 <details>
 <summary><b>Flet apps:</b></summary>
 <br/>
 
-In your `pyproject.toml` file, ensure you include the following:
+ In your `pyproject.toml` file, ensure you include the following:
 
 
 ```toml
 [tool.flet.android]
 dependencies = [
-  "pyjnius","android-notify==1.61.2.dev0"
+  "pyjnius","android-notify==1.61.3.dev0"
 ]
 
 [tool.flet.android.permission]
@@ -86,7 +111,16 @@ dependencies = [
 
 </details>
 
+<details>
+<summary><b>In Kivy</b></summary>
+<br/>
+
+```ini
+# buildozer.spec
+requirements = python3, kivy, pyjnius, android-notify==1.61.3.dev0
+```
 
+</details>
 
 <details>
 
@@ -94,10 +128,10 @@ dependencies = [
 <br/>
 
 On the [pydroid 3](https://play.google.com/store/apps/details?id=ru.iiec.pydroid3) 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==1.61.2.dev0`
+- In pip section where you're asked to insert `Libary name` paste `android-notify==1.61.3.dev0`
 - Minimal working example 
 ```py
-# Testing with `android-notify==1.61.2.dev0` on pydroid
+# Testing with `android-notify==1.61.3.dev0` on pydroid
 from kivy.app import App
 from kivy.uix.boxlayout import BoxLayout
 from kivy.uix.button import Button
@@ -124,9 +158,7 @@ class AndroidNotifyDemoApp(App):
     def send_notification(self, *args):
         Notification(
             title="Hello from Android Notify",
-            message="This is a basic notification.",
-            channel_id="android_notify_demo",
-            channel_name="Android Notify Demo"
+            message="This is a basic notification."
         ).send()
 
 
@@ -137,134 +169,13 @@ if __name__ == "__main__":
 </details>
 
 
-<details>
-
-<summary><b>Desktop</b></summary>
-<br/>
-
-For IDE IntelliSense Can be installed via `pip install`:
-
-```bash
-pip install android_notify
-android-notify -v
-```
-</details>
 
 ## Documentation
-For Dev Version use
-```ini
-requirements = python3, kivy, pyjnius, https://github.com/Fector101/android_notify/archive/without-androidx.zip
-```
-
-<details>
-<summary> <b> To talk to BroadCast Listener From Buttons </b> </summary>
-
-- Make things happen without being in your app
-```python
-from android_notify import Notification
-notification = Notification(title="Receiver Notification")
-notification.addButton(text="Stop", receiver_name="CarouselReceiver", action="ACTION_STOP")
-notification.addButton(text="Skip", receiver_name="CarouselReceiver", action="ACTION_SKIP")
-```
-You can use this [wiki](https://github.com/Fector101/android_notify/wiki/How-to-Use-with-Broadcast-Listener) as a guide create a broadcast listener
-</details>
-
-<details>
-<summary> <b> To use colored text in your notifications </b> </summary>
-
-- Copy the [res](https://github.com/Fector101/android_notify/tree/main/android_notify/res) folder to your app path.  
-- Lastly in your `buildozer.spec` file  
-Add `source.include_exts = xml` and `android.add_resources = # path you pasted`
-```python
-# Use Hex Code to be Safe
-n = Notification(title="Title and Message Color", message="Testing",title_color="red")
-n.send()
-```
-
-</details>
-
-<details>
-<summary> <b>To use Custom Sounds </b> </summary>
-
-**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 
-```py
-# 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:
-
-```py
-# 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.
-</details>
-
-
-<details>
-<summary> <b> Vibrate feature</b> </summary>
-
+For Dev Version usage
 ```ini
-# buildozer.spec
-android.permissions = VIBRATE
-```
-
-```python
-Notification.createChannel(id='shake', name="Shake Passage", vibrate=True)
-
-n=Notification(title='Vibrate',channel_id='shake')
-n.setVibrate() # for less than android 8
-n.fVibrate() # To Force Vibrate (when user turned off in settings)
-n.send()
+requirements = python3, kivy, pyjnius, https://github.com/Fector101/android_notify/archive/main.zip
 ```
 
-</details>
-
-
 <details>
 <summary> <b> Add Data to Notification</b> </summary>
 
@@ -296,9 +207,19 @@ from android_notify import Notification, NotificationHandler
 
 ## ☕ Support the Project
 
-If you find this project helpful, consider buying me a coffee! 😊  
-Or Giving it a star on 🌟 [GitHub](https://github.com/Fector101/android_notify/) Your support helps maintain and improve the project.
+If you find this project helpful, your support would help me continue working on open-source projects
+[donate](https://www.buymeacoffee.com/fector101)
+
+
+## Bug Reports & Feature Requests
+
+Found a bug or have an idea for a new feature?  
+Feel free to open an issue [here](https://reference-url-citation.invalid/0)
+
+When reporting a bug, try to include:
+- Device name
+- Android version
+- Steps to reproduce the issue
+- Screenshots or logs (if possible)
 
-<a href="https://www.buymeacoffee.com/fector101" target="_blank">
-  <img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" height="60">
-</a>
+Feature suggestions are also welcome.

{android_notify-1.61.2.dev0 → android_notify-1.61.3}/android_notify/config.py

@@ -1,7 +1,6 @@
 import os
 
-__version__ = "1.61.2.dev0"
-
+__version__ = "1.61.3"
 
 from .internal.java_classes import autoclass, cast, NotificationManager
 from .internal.logger import logger

{android_notify-1.61.2.dev0 → android_notify-1.61.3}/android_notify/core.py

@@ -6,7 +6,7 @@ from android_notify.internal.logger import logger
 from android_notify.config import get_python_activity, on_android_platform, get_python_activity_context
 from android_notify.internal.permissions import has_notification_permission, ask_notification_permission
 from android_notify.internal.java_classes import autoclass, BuildVersion, BitmapFactory, NotificationChannel, NotificationManagerCompat, NotificationCompat, NotificationCompatBuilder, \
-    NotificationCompatBigTextStyle, NotificationCompatBigPictureStyle, NotificationCompatInboxStyle
+    NotificationCompatBigTextStyle, NotificationCompatBigPictureStyle, NotificationCompatInboxStyle, IconCompat
 
 
 
@@ -60,7 +60,6 @@ def get_image_uri(relative_path):
 
 def get_icon_object(uri):
     context = get_python_activity_context()
-    IconCompat = autoclass('android.graphics.drawable.Icon')
     bitmap = BitmapFactory.decodeStream(context.getContentResolver().openInputStream(uri))
     return IconCompat.createWithBitmap(bitmap)
 
@@ -115,7 +114,9 @@ def send_notification(
         return None
     context = get_python_activity_context()
 
-    asks_permission_if_needed(legacy=True)
+
+    asks_permission_if_needed()
+
     channel_id = channel_name.replace(' ', '_').lower().lower() if not channel_id else channel_id
     # Get notification manager
     notification_manager = context.getSystemService(context.NOTIFICATION_SERVICE)

{android_notify-1.61.2.dev0 → android_notify-1.61.3}/android_notify/internal/android.py

@@ -1,14 +1,14 @@
 """
 Android related logic
 """
-import time, os
+import time
 
 from .logger import logger
 from ..config import get_notification_manager, on_android_platform, from_service_file, on_flet_app, \
     get_python_activity_context
 from .permissions import has_notification_permission
 from .java_classes import autoclass, BuildVersion, Uri, NotificationCompat, NotificationManagerCompat, \
-    NotificationManager, Context, File
+    NotificationManager, Context
 from .an_types import Importance
 
 
@@ -98,72 +98,22 @@ def get_sound_uri(res_sound_name):
     return Uri.parse(f"android.resource://{package_name}/raw/{res_sound_name}")
 
 
-def get_sound_uri_from_path(sound_path):
-    if not on_android_platform() or not sound_path:
-        return None
-
-    if sound_path.startswith("content://") or sound_path.startswith("file://") or sound_path.startswith("android.resource://"):
-        try:
-            return Uri.parse(sound_path)
-        except Exception as e:
-            logger.exception(f"Error parsing sound URI: {sound_path}")
-            return None
-
-    # Resolve relative paths
-    abs_path = os.path.abspath(sound_path)
-    if not os.path.exists(abs_path):
-        logger.warning(f"Sound file does not exist: {sound_path} (resolved to {abs_path})")
-        return None
-
-    # Check if the file is in private storage (contains /data/)
-    if "/data/" in abs_path or not (abs_path.startswith("/storage") or abs_path.startswith("/sdcard")):
-        try:
-            context = get_python_activity_context()
-            ext_files = context.getExternalFilesDir("Notifications")
-            if ext_files:
-                ext_files_path = ext_files.getAbsolutePath()
-                dest_file = os.path.join(ext_files_path, os.path.basename(abs_path))
-
-                # Copy if destination doesn't exist or is older than the source
-                if not os.path.exists(dest_file) or os.path.getmtime(abs_path) > os.path.getmtime(dest_file):
-                    import shutil
-                    shutil.copy2(abs_path, dest_file)
-                abs_path = dest_file
-        except Exception as copy_error:
-            logger.exception(f"Failed to copy private sound file {abs_path} to external files: {copy_error}")
-
-    try:
-        java_file = File(abs_path)
-        return Uri.fromFile(java_file)
-    except Exception as e:
-        logger.exception(f"Error generating Uri from file path: {abs_path}")
-        return None
-
-
-def set_sound(builder, res_sound_name=None, sound_path=None):
+def set_sound(builder, res_sound_name):
     """
     Sets sound for devices less than android 8 (For 8+ use createChannel)
     :param builder: builder instance
     :param res_sound_name: audio file name (without .wav or .mp3) locate in res/raw/
-    :param sound_path: local file path or uri string
     """
 
     if not on_android_platform():
         return None
 
-    if BuildVersion.SDK_INT < 26:
-        sound_uri = None
-        if sound_path:
-            sound_uri = get_sound_uri_from_path(sound_path)
-        elif res_sound_name:
-            sound_uri = get_sound_uri(res_sound_name)
-
-        if sound_uri:
-            try:
-                builder.setSound(sound_uri)
-                return True
-            except Exception as failed_adding_sound_for_devices_below_android8:
-                logger.exception(failed_adding_sound_for_devices_below_android8)
+    if res_sound_name and BuildVersion.SDK_INT < 26:
+        try:
+            builder.setSound(get_sound_uri(res_sound_name))
+            return True
+        except Exception as failed_adding_sound_for_devices_below_android8:
+            logger.exception(failed_adding_sound_for_devices_below_android8)
     return None