cadewey / Wireless-Charging-Xposed

An Xposed Framework module that allows you to customize how your device behaves when placed on/removed from a wireless charger.

##Wireless Charging Xposed

Android 4.2.2 added a notification sound that plays whenever a device is placed on a wireless charger, but provided no way to disable it. Wireless Charging Xposed is a module for the Xposed Framework that aims to add a bit more flexibility in how your phone notifies you when you begin wireless charging.

##How it works

The commit to AOSP that added the notification sound can be found here. Essentially, this module hooks into the playWirelessChargingStartedSound() and shouldWakeUpWhenPluggedOrUnpluggedLocked() methods, then performs actions based on the user's preferences, including:

1. Returns without doing anything at all (complete silence)
2. Performs 2 short vibrations in quick succession
3. Invokes the original method, playing the default notification sound as normal OR
4. Plays a custom-selected notification sound
5. Wakes the display when wireless charging begins or ends

The exact behavior is left up to the user, and can be any combination of the above (3 and 4 are mutually exclusive).

##Building the module

Wireless Charging Xposed was built in Eclipse, and doesn't contain the necessary project definitions for Android Studio currently. They may be added at a later date, though there are no immediate plans to support Android Studio, at least not until it is "stable".

Along with Eclipse, you'll need the standard ADT plugin and the Android 4.2.2 platform framework/APIs.

With that done, you'll then need two things in order to build this module:

1. This repository; clone it somewhere and import it into your Eclipse workspace.
2. A copy of the XposedLibrary codebase. Again clone this and import it into your Eclipse workspace. Make sure it is set to build as a library, and make the module's project reference it.

With those two sets of code set up, you should be able to build, deploy, and debug via Eclipse.

##Binary downloads and support

Binaries will not be hosted on GitHub, but can be obtained from other locations instead:

1. The associated XDA thread
2. The Xposed Module Repository (also accessible via the Xposed Installer on your device)
3. Google Play - this version is $0.99 USD (a "donate" version). The free releases do not have advertising, so payment is not required for full functionality.

##License

Wireless Charging Xposed is released under version 3 of the GNU General Public License (GPLv3).