Metadata-Version: 2.1
Name: android-notify
Version: 0.3
Summary: A Python package for sending Android notifications.
Home-page: https://github.com/Fector101/android_notify/
Author: Fabian
Author-email: fabianjoseph063@gmail.com
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: pyjnius

# Android Notify

`android_notify` is a Python module designed to simplify sending Android notifications using Kivy and Pyjnius. It supports multiple notification styles, including text, images, and inbox layouts.

## Features

- Send Android notifications with custom titles and messages.
- Support for multiple notification styles:
  - Big Text
  - Big Picture
  - Inbox
- Ability to include images in notifications.
- Compatible with Android 8.0+ (Notification Channels).
- Customizable notification channels.
- Support for large icons in notifications.

## Installation

Make sure you have the required dependencies installed:

```bash
pip install android_notify
```

## Usage

### Example Notification

```python
from android_notify.core import send_notification

# Send a basic notification
send_notification(
    title='Hello!',
    message='This is a sample notification.',
    style='big_text'
)

# Send a notification with an image
send_notification(
    title='Picture Alert!',
    message='This notification includes an image.',
    style='big_picture',
    img_path='assets/imgs/icon.png'
)

# Send a notification with inbox style
send_notification(
    title='Inbox Notification',
    message='Line 1\nLine 2\nLine 3',
    style='inbox'
)
```

### Function Reference

#### `send_notification`

- **title** (*str*): Notification title.
- **message** (*str*): Notification message body.
- **style** (*str*): Notification style (`big_text`, `big_picture`, `inbox`, `large_icon`).
- **img_path** (*str*): Path to the image (for `big_picture` or `large_icon` styles).
- **channel_id** (*str*): Notification channel ID.

#### `get_image_uri`

- Resolves the absolute URI of an image resource.
- **relative_path** (*str*): The relative path to the image.

### Advanced Usage

You can customize notification channels for different types of notifications.

```python
send_notification(
    title='Custom Channel Notification',
    message='This uses a custom notification channel.',
    channel_id='custom_channel'
)
```

## Requirements

- Python 3.x
- Kivy
- Pyjnius
- Android SDK (For building APKs)

## License

This project is licensed under the MIT License.

## Contribution

Feel free to open issues or submit pull requests for improvements!

## Author

**Fabian** - *Full-Stack Developer* 🚀

## Acknowledgments

- Thanks to the Kivy and Pyjnius communities for their support.
- Inspired by modern Android notification practices.

