An open API service indexing awesome lists of open source software.

https://github.com/homocodian/charge-guard

Charge Guard is a simple Android application that notifies users when their device's battery reaches a specified charge percentage. This helps users avoid overcharging and prolong battery life.
https://github.com/homocodian/charge-guard

android battery battery-monitor charging

Last synced: 2 months ago
JSON representation

Charge Guard is a simple Android application that notifies users when their device's battery reaches a specified charge percentage. This helps users avoid overcharging and prolong battery life.

Awesome Lists containing this project

README

          

# Charge Guard

Charge Guard is a simple Android application that notifies users when their device's battery reaches a specified charge percentage. This helps users avoid overcharging and prolong battery life.

## Features

- Set a custom charge percentage to receive a notification.
- Real-time monitoring of battery charge level.
- Intuitive user interface for setting preferences.
- Background service to monitor battery status efficiently.

## Installation

### Prerequisites

- Android device running Android 7.1 (Nougat) or later.
- Android Studio (for developers who want to build the app from source).

### Steps

1. Download the APK from the [Releases](https://github.com/homocodian/charge-guard/releases) section.
2. Enable installation from unknown sources in your device settings.
3. Install the APK and launch the app.

## Usage

1. Launch the app.
2. Configure the desired charge percentage using the intuitive slider or input field.
3. Grant the required permissions to enable notifications.
4. Start monitoring by tapping the "Start" button; stop it anytime by pressing "Stop."
5. Alternatively, utilize the Quick Settings tile for convenient access to start or stop the service.

## Permissions Required

- **Notification Access**: To display notifications.

## Development Setup

1. Clone the repository:

```bash
git clone https://github.com/homocodian/charge-guard.git
```

2. Open the project in Android Studio.

3. Sync the project with Gradle.

4. Run the app on an emulator or physical device.

## Contributing

Contributions are welcome! Follow these steps to contribute:

1. Fork the repository.
2. Create a new branch for your feature/bug fix.
3. Commit your changes with a clear message.
4. Push your branch and create a pull request.

## License

This project is licensed under the [MIT License](LICENSE).

## Support

For any issues or feature requests, please open an issue in the repository.

---

### Future Enhancements

- Vibration alerts for notifications.