https://github.com/masterdev07/adbatterystatus
Adbatterystatus is an innovative battery alarm application designed for Android that operates seamlessly on Linux and need ADB. Unlike typical apps of its kind, Adbatterystatuscan also run on Windows through WSL or Cygwin. During testing, I was impressed to find that the app features a robotic voice for notifications, enhancing user experience.
https://github.com/masterdev07/adbatterystatus
Last synced: 4 months ago
JSON representation
Adbatterystatus is an innovative battery alarm application designed for Android that operates seamlessly on Linux and need ADB. Unlike typical apps of its kind, Adbatterystatuscan also run on Windows through WSL or Cygwin. During testing, I was impressed to find that the app features a robotic voice for notifications, enhancing user experience.
- Host: GitHub
- URL: https://github.com/masterdev07/adbatterystatus
- Owner: masterDev07
- Created: 2025-02-25T23:29:54.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-12T05:09:07.000Z (about 1 year ago)
- Last Synced: 2025-03-12T06:20:24.834Z (about 1 year ago)
- Homepage:
- Size: 359 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# ADBatteryStatus 🚀
**ADBatteryStatus** is a unique battery alarm application designed for Android
that runs seamlessly on Linux and use ADB. Unlike typical battery alarm apps
that operate solely on Android devices, ADBatteryStatus offers a smooth
experience on Linux systems, making it a versatile tool for users.
## Features 🌟
- 📊 Monitor the battery percentage of Android devices.
- 🔔 Alarm notifications when the battery needs charging.
- ⚡ Alarm notifications when the battery can be unplugged.
- 💬 Message box alerts on Linux computers.
- 🎶 Audio alarms on both Linux computers and Android devices for a dual alert system.
- 🔄 Automatic switching between USB and TCP ADB server modes without manual configuration.
- 🔌 Identify the power source of the charger (USB or AC adapter).
- 👤 No root user privileges required; regular users can run the application.
- 🌐 No internet connection needed for operation.
- 🔒 Safe for the user's Linux system.
- 🌡️ Monitor Android battery temperature and notify users (available from version 1 onwards).
- 💬 Customizable quotes displayed on the Linux screen.
- 🎥 Full-screen video mode in Firefox will still display quotes and alarms.
- ⏰ Automatic crontab creation if ADBatteryStatus is not configured.
- 🔧 Enable or disable quotes and notifications through a configuration file.
- 📈 Different icons for charging and non-charging states based on battery percentage.
- 🔊 Adjustable speaker volume settings in the configuration file.
- 🤖 ADBatteryStatus can verbally announce the battery percentage to users.
- 🔕 Option to disable alarm notifications during specific hours.
## Installation 🛠️
1. **Clone the ADBatteryStatus repository**, move to the `~/Music` directory.
Then adbatterystatus directory rename to `alarm` now will be `~/Music/alarm`.
2. **Set permissions** to execute the file:
```bash
chmod +x adbatterystatus
```
3. **Configure crontab** to run ADBatteryStatus:
```bash
crontab -e
```
Add the following line to run ADBatteryStatus every 5 minutes:
```bash
*/5 * * * * ~/Music/alarm/adbatterystatus 30 98 your_ip:5555 43
```
Crontab will run ADBatteryStatus every 5 minutes. The purpose of this crontab
scriptis so that the ADBatteryStatus can provide an alarm when the android
battery needs to be charged or needs to be removed from the charger when it has
reached the maximum level of charging the android battery.
## Usage 📖
Run ADBatteryStatus using the terminal:
```bash
./adbatterystatus min_charge_level max_unplug_level ip_wifi_android:port_adb warm_temp
```
### Example Command:
```bash
./adbatterystatus 30 98 192.168.43.1:5555 43
```
## Setup and Configuration ⚙️
The `adbatterystatus` file needs to be configured to run in the Linux terminal
using the following command:
```bash
chmod +x adbatterystatus
```
This command grants execute permissions to the file. To enable audio alarms on
the Android device, two audio files—needcharged.ogg and releasecable.ogg—must be
placed in the sdcard/Download directory, such as sdcard/Download/pasangcas.ogg
and sdcard/Download/lepascas.ogg. If these files are not set up on the Android
device, it is not a problem; however, adbatterystatus will not execute audio
alerts on the Android device.
ADBatteryStatus can detect the source of the charger, whether it is from a
computer's USB port or an AC adapter connected to the power outlet. The
application will automatically identify the Android device or tablet using the
connected charger. To ensure everything runs smoothly, users need to enable the
developer options on their Android device. When the USB device is connected to
the computer, the program will utilize this connection to monitor the battery
status. Additionally, if a TCP connection is used, it can also provide alerts
when the Android device's battery needs charging.
## Requirements 📋
- `amixer`
- Desktop Environment: `xfce`
- `mpg123`
- `vorbis-tools`
## Contributing 🤝
We welcome contributions! If you have suggestions or improvements.
## License 📄
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file
for details.
## Contact 📬
For any inquiries, please reach out to [duitmoro@yahoo.com](mailto:duitmoro@yahoo.com).
---
Thank you for checking out ADBatteryStatus! We hope it enhances your Android
experience on Linux! 🎉