Skip to content

Commit 036697a

Browse files
authored
Update README with feature clarifications and removals
Removed outdated information and clarified features in the README.
1 parent cff8729 commit 036697a

1 file changed

Lines changed: 3 additions & 34 deletions

File tree

README.md

Lines changed: 3 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -13,30 +13,20 @@
1313
[![Crowdin](https://badges.crowdin.net/amply/localized.svg)](https://crowdin.com/project/amply)
1414
-->
1515

16-
17-
1816
> _**Amply is experimental and pre-launch. Direct control is verified on a limited set of devices — device reports and feedback are welcome!**_
1917
2018
[Amply](https://github.com/d4rken-org/amply) is an Android controller for OEM battery charge-protection modes. Its
21-
primary action temporarily allows one full charge, then restores your protective charge limit automatically — at 100%,
22-
on unplug, or at a safety timeout.
19+
primary action temporarily allows one full charge, then restores your protective charge limit automatically.
2320

2421
Features include:
2522

2623
* One-tap "charge to 100% once", then automatic restore of your protective limit
2724
* A dashboard that reports charge state honestly — verified, last-requested, or unknown
2825
* Optional "reconnect to charge to 100%" gesture at the active hardware limit
29-
* Quick Settings tile and a home-screen widget for protect / full-charge actions (upgrade)
30-
* A persisted temporary-session monitor that survives reboots
31-
* Diagnostics workflow (Shizuku) for before/after setting discovery, with redacted reports
32-
* Works without ADB/Shizuku too — a charge alarm to remind you to unplug at a chosen level, a live battery-info card, and an OEM battery-protection guide on unsupported devices
33-
* Charge history with per-charge curves — level, speed, and temperature over time (upgrade)
26+
* Quick Settings tile and a home-screen widget for protect / full-charge actions
27+
* Charge history with per-charge curves — level, speed, and temperature over time
3428
* Branded light/dark themes, optional Material You, and contrast choices
3529
* Works via `WRITE_SECURE_SETTINGS` or Shizuku
36-
* No ads, no tracking, open-source (`foss` and `gplay` flavors)
37-
38-
Charge control itself — including the temporary full charge and the reconnect gesture — is free. The items marked
39-
(upgrade) are unlocked by the paid upgrade on Google Play, or by sponsoring development in the FOSS build.
4030

4131
Currently supported for direct control:
4232

@@ -46,9 +36,6 @@ Currently supported for direct control:
4636
* Xiaomi / Redmi / POCO on HyperOS 2 (charging protection)
4737
* OnePlus / Oppo / Realme on ColorOS 15 (charging protection; requires Shizuku)
4838

49-
Other devices — other Pixels, Samsung One UI 6/7 and 9+, non-HyperOS-2 Xiaomi, and non-ColorOS-15
50-
OnePlus/Oppo/Realme — are diagnostics-only for now.
51-
5239
## Download
5340

5441
| Source | Status |
@@ -83,24 +70,6 @@ the extras above and is what funds continued development.
8370

8471
<img src="https://github.com/d4rken-org/amply/raw/main/fastlane/metadata/android/en-US/images/phoneScreenshots/1_dashboard_light.png" width="100"><img src="https://github.com/d4rken-org/amply/raw/main/fastlane/metadata/android/en-US/images/phoneScreenshots/2_full_charge_dark.png" width="100"><img src="https://github.com/d4rken-org/amply/raw/main/fastlane/metadata/android/en-US/images/phoneScreenshots/3_samsung_multimode.png" width="100"><img src="https://github.com/d4rken-org/amply/raw/main/fastlane/metadata/android/en-US/images/phoneScreenshots/4_setup_guide.png" width="100"><img src="https://github.com/d4rken-org/amply/raw/main/fastlane/metadata/android/en-US/images/phoneScreenshots/5_settings.png" width="100"><img src="https://github.com/d4rken-org/amply/raw/main/fastlane/metadata/android/en-US/images/phoneScreenshots/6_reconnect_gesture.png" width="100">
8572

86-
## Setup & access
87-
88-
Install Amply, then enable control through one access path:
89-
90-
```shell
91-
adb shell pm grant eu.darken.amply android.permission.WRITE_SECURE_SETTINGS
92-
```
93-
94-
Alternatively, start Shizuku, grant Amply access, and optionally use Amply's setup card to grant durable WSS. WSS-only
95-
control can write Pixel's hidden values but Android blocks direct third-party reads, so Amply also watches Android's
96-
public charging-hardware state; Shizuku provides exact configured-setting readback while it is running. On tested
97-
Pixels, Google's policy worker takes roughly 10–15 seconds to propagate a setting change to the charging HAL.
98-
99-
The required access path is adapter-dependent: some devices (OnePlus/Oppo/Realme on ColorOS, and LineageOS) keep their
100-
setting in a namespace that `WRITE_SECURE_SETTINGS` cannot write, so control there **requires Shizuku** — the ADB grant
101-
alone won't be enough, and the dashboard surfaces this. The relevant dashboard card guides you to the option your
102-
device needs.
103-
10473
## License
10574

10675
Amply's code is available under a GPL v3 license, this excludes:

0 commit comments

Comments
 (0)