From f340c6ea9239e7f40a84ac07b666b18200ea968d Mon Sep 17 00:00:00 2001 From: K Everets Date: Fri, 5 Jan 2024 09:41:53 -0500 Subject: [PATCH] Update README.md to provide end-user information The initial README.md is very development focused. This change adds a brief description of what BBS is & does, and gives the end-user the information needed to grant the necessary permissions (in the case that their device is not rooted). --- README.md | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 75d86459..d6125a60 100755 --- a/README.md +++ b/README.md @@ -1,6 +1,17 @@ *Build* [![CircleCI](https://circleci.com/gh/asksven/BetterBatteryStats/tree/master.svg?style=svg)](https://circleci.com/gh/asksven/BetterBatteryStats/tree/master) -#License +Better Battery Stats provides more in-depth battery statistics for your Android device. It can be used to find applications that cause battery drain. + +It can be used without root, though it needs special permissions. With root access those permissions can be granted automatically. Without root access, the permissions can still be granted using the `adb` tool on a laptop or desktop computer: + +``` +adb -d shell pm grant com.asksven.betterbatterystats android.permission.BATTERY_STATS +adb -d shell pm grant com.asksven.betterbatterystats android.permission.DUMP +adb -d shell pm grant com.asksven.betterbatterystats android.permission.PACKAGE_USAGE_STATS +adb -d shell settings put global hidden_api_policy 1 +``` + +# License BetterBatteryStats is an open source project unter the terms of the Apache 2.0 License. The license does not apply to the use of the names "BetterBatteryStats" and "Better Battery Stats", nor to the icon / artwork created for BetterBatteryStats. # Build