GSam Battery - Root Companion

Enables full Battery statistics on KitKat based Android devices for GSam Battery Monitor.

Unfortunately, Google has removed the ability in KitKat (4.4) for non-system applications to access battery statistics. This companion app restores this function by running as a privileged system application. Root access to your device is required. GSam Battery Monitor works fine without the root companion, however this app adds additional statistics.

<b>Why Install?</b>

• If you are using GSam Battery Monitor on KitKat (4.4) or later, and the app informs you that it is unable to retrieve battery statistics, you should install this app.

<b>What does this do?</b>

• This runs as a system privileged app and provides the caller access to the Battery Statistics that - prior to Android 4.4 - used to be accessible to any normal application.

• This also provides the ability to read the content of small files to which the regular battery monitor has no access - wakelock files for example.

<b>Is Root really required in KitKat?</b>

• Unfortunately, root is required to copy this app into /system/priv-app, which allows this app to run as a privileged system application. There are other alternatives, but all of them require root.

<b>Is this safe?</b>

• Yes - the code is open source, and very simple. GSam Labs believes that any app that you install as root must be fully open source to allow you to inspect the application and ensure it doesn't do anything malicious. With that principle in mind, you can find the source here: <a href="https://www.google.com/url?q=https://www.google.com/url?q%3Dhttps://github.com/GSamLabs/GSamBatteryMonitor-RootCompanion%26sa%3DD%26usg%3DAFQjCNGc05fMoatvNYfIj7O0uRz1EFH0dA&sa=D&usg=AFQjCNHt_vmk4xEdLncuA3Fyrrk9jiFTIQ" target="_blank">https://github.com/GSamLabs/GSamBatteryMonitor-RootCompanion</a>

* NOTE: If you are unfamiliar with what 'root' means, this app is not for you.

<b>How do I install it?</b>

• Install this just like any other application from the store. Once installed, there will be a button that will copy the app to /system/priv-app, and prompt you to restart your device.

• <b>Flashable Zip:</b> You can find a flashable zip in the github repository under the RecoveryInstallImages directory (<a href="https://www.google.com/url?q=https://www.google.com/url?q%3Dhttp://goo.gl/0zcqbL%26sa%3DD%26usg%3DAFQjCNHuOG_24o5Qb9XRys20QaoYdavToA&sa=D&usg=AFQjCNETrPdgLtj5ahNSYwd7uSrk2dydBQ" target="_blank">http://goo.gl/0zcqbL</a>). Flash this in the recovery of your choice. This should work for most phones, but since the google update binary differs between devices, there is no guarantee.

• NOTE: This only works if you have root access to your device!

<b>How do I uninstall it?</b>

• Once a system app is installed, the normal uninstall procedures don't work. To uninstall this app once it is a system app, simply launch the app and click on the Uninstall button.

<b>Can I remove the icon from the launcher?</b>

• Yes - you can! Once you have the app properly installed, open the app and select the 'Remove from launcher' checkbox. If you need to open the app in the future, simply go to GSam Battery Monitor, and select the 'Launch Root Companion' menu option, or go to the Google Play Store, look up the root companion, and hit the Open button.

<b>Will I need to re-install after an Android update?</b>

• Yes - android updates will typically remove any non-stock apps from the system app-priv directory, so you will need to re-install this app after an update to Android.

<b>Will this work with other battery monitors?</b>

• Not by default - it is up to the author of the battery monitor whether they would like to leverage this tool or not. GSam Battery Monitor of course is fully supported.

<b>Help! Things don't work after installing this!</b>

• Like all root applications, some care must be taken by the device owner when installing this app. This application is free and open source. GSam Labs is not responsible for any problems, though we will try and help - simply contact us via the Support link.

<b>Credits</b>

• Thanks to stericson for providing such a great RootTools library (<a href="https://www.google.com/url?q=https://www.google.com/url?q%3Dhttp://code.google.com/p/roottools/%26sa%3DD%26usg%3DAFQjCNFYeGGMjHrkKM8LgK9vw64OYfsVVA&sa=D&usg=AFQjCNF1-ytEaCsUaFN97jY9Kxeb2fOuqA" target="_blank">http://code.google.com/p/roottools/</a>)