Physical Button Master Control

This page is no longer maintained. It has been migrated here.

When the screen is off/locked/on this module allows you to:
- send media play signals
- send media next/previous signals
- send volume up/down signals
- launch app shortcut actions
...with any buttons your phone might have!

And also:
- Disable original button functions
- Send a play signal when devices get plugged in
- Send signals only when selected devices are plugged in
- Set music volume when play signals are sent
- Set a media player to send the signals to or use the last used one
- Launch the selected player before sending signals

Features can be greatly customized to suit all possible needs!
Compatible with all Android versions from 4.1 'Jelly Bean' to 9.0 'Pie'.

If you want to help other people see this app in your language, feel free to contribute on Crowdin:
PBMC translation project on Crowdin

Credits:
Xposed Framework: rovo89 & Tungstwenty
Translators of the older versions: fer866, pyler, Rom, Typhus_, AHOME, w0rinal

Donations welcome! (via the donation button on XDA)

How to report problems efficiently?
- Enable the Debug log in PBMC settings
- Use PBMC functions that don't work as intended
- Export the logs from Xposed app and put them on PasteBin
- Post on the XDA thread the link along with more information about your device

Author(s): 
Xspeed
Support/Discussion URL: 
https://forum.xda-developers.com/showthread.php?t=2620777
Source code URL: 
https://github.com/XspeedPL/PhysicalButtonMod
Package: 
xeed.xposed.cbppmod
Version name: 
4.1 confusing2
Release type: 
Beta (some bugs to be expected)
Download: 
xeed.xposed.cbppmod_v65_fe29d1.apk (2.3 MB)
Number of downloads: 
1,930 in total · 1 in the last 24 hours
MD5 checksum: 
fe29d1a7bfbab41b3bf5f9ac903c1e12
Uploaded on: 
Saturday, August 31, 2019 - 05:20
Changes: 

No translations or in-app tutorial yet available!
Fixed the diagram saving issue, among other bugs
Added input method state and screen rotation condition types

Version name: 
4.1 confusing1
Release type: 
Experimental (high risk of bugs)
Download: 
xeed.xposed.cbppmod_v64_3b68c4.apk (2.34 MB)
Number of downloads: 
343 in total · 0 in the last 24 hours
MD5 checksum: 
3b68c414d0e076ff7f080f4a3107268d
Uploaded on: 
Tuesday, August 13, 2019 - 23:32
Changes: 

No translations or in-app tutorial yet available!
Compatibility up to Android 9.0 Pie
Chain conditions page overhauled to a complex and unintuitive network diagram
Implemented hooking basic key presses from media sources
Android Wear support

Version name: 
4.0 beta6
Release type: 
Stable (low risk of bugs)
Download: 
xeed.xposed.cbppmod_v58_edf3dd.apk (876.58 KB)
Number of downloads: 
65,756 in total · 2 in the last 24 hours
MD5 checksum: 
edf3dd363cf00084a14aa570a75bc59f
Uploaded on: 
Tuesday, April 26, 2016 - 15:31
Changes: 

Added an ability to map by telephony state
Possible fix for notification light problems
Fixed light duration
Restored the ability to set multiple chains of the same type with different delays
Various UI tweaks

Version name: 
4.0 beta5
Release type: 
Stable (low risk of bugs)
Download: 
xeed.xposed.cbppmod_v57_4b67ad.apk (874.93 KB)
Number of downloads: 
3,012 in total · 0 in the last 24 hours
MD5 checksum: 
4b67ad8dacb570939125898cf0946a48
Uploaded on: 
Friday, April 22, 2016 - 22:44
Changes: 

Added notification light color and duration customization
Reverted chain list management control
Fixed flashlight control
UI changes and tweaks

Version name: 
4.0 beta4 fix1
Release type: 
Stable (low risk of bugs)
Download: 
xeed.xposed.cbppmod_v56_15099b.apk (869.81 KB)
Number of downloads: 
1,761 in total · 0 in the last 24 hours
MD5 checksum: 
15099bcc7fb672dd8f291fcb6c62c48a
Uploaded on: 
Wednesday, April 20, 2016 - 21:18
Changes: 

Changed chain list item handling
Fixed flashlight action
Minor UI adjustments

Version name: 
4.0 beta4
Release type: 
Stable (low risk of bugs)
Download: 
xeed.xposed.cbppmod_v55_59b6b2.apk (868.4 KB)
Number of downloads: 
1,776 in total · 0 in the last 24 hours
MD5 checksum: 
59b6b26eee7ddc4331766fec3bafdd18
Uploaded on: 
Tuesday, April 19, 2016 - 02:06
Changes: 

Reduced app permissions
Fixed flashlight action on Marshmallow
Added unsafe keys warning
Minor UI improvements

Version name: 
4.0 beta3
Release type: 
Beta (some bugs to be expected)
Download: 
xeed.xposed.cbppmod_v51_c760a6.apk (871.34 KB)
Number of downloads: 
2,373 in total · 0 in the last 24 hours
MD5 checksum: 
c760a6371e5fa92bf4454d2b2b5e7ebe
Uploaded on: 
Monday, April 11, 2016 - 08:18
Changes: 

Added an option to blink light or play sound on action
An ability to change the in-app theme
Fixed a bug with repeating toasts
Fixed UI crashes on older devices

Version name: 
4.0 beta2
Release type: 
Beta (some bugs to be expected)
Download: 
xeed.xposed.cbppmod_v50_2d0497.apk (817.19 KB)
Number of downloads: 
1,423 in total · 0 in the last 24 hours
MD5 checksum: 
2d049782f1840d34f61e7cf97a802297
Uploaded on: 
Monday, April 4, 2016 - 00:48
Changes: 

Reworked code structure
Added an option specify music state for chains
Added an option to wake up the screen on action
Added a clear button to key testing

Version name: 
4.0 beta
Release type: 
Beta (some bugs to be expected)
Download: 
xeed.xposed.cbppmod_v48_4d015e.apk (793.85 KB)
Number of downloads: 
1,007 in total · 0 in the last 24 hours
MD5 checksum: 
4d015ef0ad22f78c504e632ae0a90462
Uploaded on: 
Thursday, March 31, 2016 - 00:48
Changes: 

Added a key testing tool for chain building
Great code cleanup
A number of bugs fixed

Version name: 
4.0 alpha6
Release type: 
Experimental (high risk of bugs)
Download: 
xeed.xposed.cbppmod_v47_b1f84d.apk (770.78 KB)
Number of downloads: 
1,333 in total · 0 in the last 24 hours
MD5 checksum: 
b1f84dc9c7700c2f63bd6cec06698bef
Uploaded on: 
Monday, March 21, 2016 - 15:07
Changes: 

Reintroduced the ability to repeat actions while holding buttons
New extra action: "switch to previous app"
Fixed weird UI glitches with rotation and crashes
Fixed issues related to ProGuard renaming
Added Google billing permission for future purposes

Version name: 
4.0 alpha5
Release type: 
Experimental (high risk of bugs)
Download: 
xeed.xposed.cbppmod_v45_43809c.apk (768.1 KB)
Number of downloads: 
990 in total · 0 in the last 24 hours
MD5 checksum: 
43809c3e1194ce4c6673c1007471dd08
Uploaded on: 
Thursday, March 10, 2016 - 04:00
Changes: 

Highly experimental! Use at your own risk!
Fixed a bug preventing media signals from being sent on Lollipop+
Improved keypress simulation action with delays
Fixed hold time measurement bug
Set up ProGuard to cut apk size almost in half

Version name: 
4.0 alpha4
Release type: 
Experimental (high risk of bugs)
Download: 
xeed.xposed.cbppmod_v44_85e306.apk (1.2 MB)
Number of downloads: 
267 in total · 0 in the last 24 hours
MD5 checksum: 
85e30678782f1025232c7e269aa81da5
Uploaded on: 
Wednesday, March 9, 2016 - 15:37
Changes: 

Highly experimental! Use at your own risk!
Added an easier way of setting up chains: 'Basic' mode
More complicated chains can still be made in 'Advanced' mode

Version name: 
4.0 alpha3
Release type: 
Experimental (high risk of bugs)
Download: 
xeed.xposed.cbppmod_v41_c4a748.apk (1.2 MB)
Number of downloads: 
482 in total · 0 in the last 24 hours
MD5 checksum: 
c4a748bcb00ba91215c2617f57e9e8d2
Uploaded on: 
Monday, March 7, 2016 - 03:06
Changes: 

Highly experimental! Use at your own risk!
Implemented long key presses
Introduced action repeats
Longer key chains don't get overridden by shorter ones
Fixed keys getting stuck in the app

Version name: 
4.0 alpha2
Release type: 
Experimental (high risk of bugs)
Download: 
xeed.xposed.cbppmod_v40_f98744.apk (1.2 MB)
Number of downloads: 
1,099 in total · 0 in the last 24 hours
MD5 checksum: 
f987449b55f2e9256b98eb9c3b720062
Uploaded on: 
Thursday, February 25, 2016 - 01:34
Changes: 

Highly experimental! Use at your own risk!
Fixed a few crash issues
Corrected dialog messages
Fixed chain sorting

Version name: 
4.0 alpha
Release type: 
Experimental (high risk of bugs)
Download: 
xeed.xposed.cbppmod_v39_10bba9.apk (1.19 MB)
Number of downloads: 
388 in total · 0 in the last 24 hours
MD5 checksum: 
10bba9db1757bc1429bd613883ea602e
Uploaded on: 
Tuesday, February 23, 2016 - 20:57
Changes: 

Highly experimental! Use at your own risk!
Complete app re-write with new key mechanism
Android Marshmallow support

Version name: 
3.1
Release type: 
Beta (some bugs to be expected)
Download: 
xeed.xposed.cbppmod_v37_2e090e.apk (968.31 KB)
Number of downloads: 
27,132 in total · 0 in the last 24 hours
MD5 checksum: 
2e090eccdce82baa26ff3e7ec1282e84
Uploaded on: 
Tuesday, March 17, 2015 - 18:14
Changes: 

Added key simulation action for mappings
Fixed original key function simulation
Fixed repeat on hold function
Visual improvements

Version name: 
3.0.4
Release type: 
Stable (low risk of bugs)
Download: 
xeed.xposed.cbppmod_v36_e1f63c.apk (964.85 KB)
Number of downloads: 
11,530 in total · 0 in the last 24 hours
MD5 checksum: 
e1f63c5abc9a870b3790caf9cff0cda9
Uploaded on: 
Saturday, March 14, 2015 - 22:51
Changes: 

Allowed separate mappings per screen state!
New Material-ish app theme
Finally fixed Plug & Play
Fixed problems with mappings while screen is on
Rewritten the original key function simulation
Increased compatibility with other modules

Version name: 
2.10.1
Release type: 
Stable (low risk of bugs)
Download: 
xeed.xposed.cbppmod_v30_bca33c.apk (353.13 KB)
Number of downloads: 
37,690 in total · 0 in the last 24 hours
MD5 checksum: 
bca33c82331435820e5a03f365a1e4f4
Uploaded on: 
Sunday, February 22, 2015 - 21:25
Changes: 

Reverted alarms to wakelocks (bugs in KK+)
Fixed the version check bug
Translations updated

Version name: 
2.10
Release type: 
Stable (low risk of bugs)
Download: 
xeed.xposed.cbppmod_v29_02d6bd.apk (354.2 KB)
Number of downloads: 
4,527 in total · 0 in the last 24 hours
MD5 checksum: 
02d6bd8ef9df13ee8f5b780cd6ed2e84
Uploaded on: 
Tuesday, February 17, 2015 - 14:17
Changes: 

Android Lollipop support
Fixed a few bugs in the Plug & Play function
Make use of alarms instead of wakelocks for better battery life
Added German translation (thanks w0rinal!)

Version name: 
2.9
Release type: 
Stable (low risk of bugs)
Download: 
xeed.xposed.cbppmod_v28_e14b68.apk (348.23 KB)
Number of downloads: 
10,532 in total · 0 in the last 24 hours
MD5 checksum: 
e14b68cab55a1fe6e61ad7b571e40136
Uploaded on: 
Saturday, January 10, 2015 - 03:57
Changes: 

Allowed shortcuts as actions
Killed response delays
Fix broken repeated key events
Added double previous media action

Version name: 
2.8
Release type: 
Stable (low risk of bugs)
Download: 
xeed.xposed.cbppmod_v27_2bb7c0.apk (337.63 KB)
Number of downloads: 
5,703 in total · 0 in the last 24 hours
MD5 checksum: 
2bb7c0144913120b3c53d8abcd4c2db8
Uploaded on: 
Wednesday, December 24, 2014 - 14:42
Changes: 

Increased responsiveness
Added an option to boost free memory before play signals
Added update reboot reminder
Allowed soft keys to be used (for lulz rly)
Little visual details improved

Version name: 
2.7
Release type: 
Stable (low risk of bugs)
Download: 
xeed.xposed.cbppmod_v26_4a7b00.apk (334.76 KB)
Number of downloads: 
23,273 in total · 0 in the last 24 hours
MD5 checksum: 
4a7b00db1472fa9183df7939b993229d
Uploaded on: 
Friday, September 19, 2014 - 14:01
Changes: 

Added an ability to use the last used media player from recents list
Added an option to hide the app icon from launcher
Improved debug information logging
Light code optimizations
Updated all of the translations
Added Turkish translation (thanks AHOME!)

Version name: 
2.6.3
Release type: 
Stable (low risk of bugs)
Download: 
xeed.xposed.cbppmod_v25_4e1140.apk (328.67 KB)
Number of downloads: 
7,472 in total · 0 in the last 24 hours
MD5 checksum: 
4e1140b70b32b6f2a4860827fa63393d
Uploaded on: 
Friday, August 29, 2014 - 10:52
Changes: 

Made receiver class visible in receiver selector
Updated translations
Fixed a few minor bugs

Version name: 
2.6.2
Release type: 
Stable (low risk of bugs)
Download: 
xeed.xposed.cbppmod_v24_912c4c.apk (328.03 KB)
Number of downloads: 
11,375 in total · 0 in the last 24 hours
MD5 checksum: 
912c4c96abe806c7466c4da545ef9917
Uploaded on: 
Sunday, July 27, 2014 - 04:07
Changes: 

Fixed a bug preventing Plug & Play from working

Version name: 
2.6.1
Release type: 
Stable (low risk of bugs)
Download: 
xeed.xposed.cbppmod_v23_2d4a8c.apk (328.03 KB)
Number of downloads: 
1,035 in total · 0 in the last 24 hours
MD5 checksum: 
2d4a8ce54730e87ff89eac20a6c46a00
Uploaded on: 
Saturday, July 26, 2014 - 13:38
Changes: 

Disable functionality when phone's call state isn't idle
Ability to customize repeat frequency and vibration duration per action
Ability to select certain device types for 'Plug & Play' and 'Plugged only' preferences

Version name: 
2.5.1
Release type: 
Stable (low risk of bugs)
Download: 
xeed.xposed.cbppmod_v21_daebbc.apk (283.16 KB)
Number of downloads: 
5,515 in total · 0 in the last 24 hours
MD5 checksum: 
daebbc79e82984e72bf3ecb35d67db40
Uploaded on: 
Saturday, July 12, 2014 - 15:04
Changes: 

Fixed service handling on pre-Jelly Bean (original button functions)

Version name: 
2.5
Release type: 
Stable (low risk of bugs)
Download: 
xeed.xposed.cbppmod_v20_1db99e.apk (283.14 KB)
Number of downloads: 
1,239 in total · 0 in the last 24 hours
MD5 checksum: 
1db99e452a16c9314d508eb4476034e4
Uploaded on: 
Friday, July 11, 2014 - 20:19
Changes: 

Can now work on the lockscreen or always!
Fixed the input handling bug from previous version
Code clean-up and performance improvements

Version name: 
2.4
Release type: 
Stable (low risk of bugs)
Download: 
xeed.xposed.cbppmod_v19_5728cd.apk (282.36 KB)
Number of downloads: 
862 in total · 0 in the last 24 hours
MD5 checksum: 
5728cd1722535a3887a0e398a221efb1
Uploaded on: 
Friday, July 11, 2014 - 03:30
Changes: 

Ability to repeat action signal when holding
Ability to enable/disable vibrations per action
A fix for devices with repeating key events
Fixed Gingerbread compatibility
Updated all translations (thanks to the awesome translators!)

Version name: 
2.3
Release type: 
Stable (low risk of bugs)
Download: 
xeed.xposed.cbppmod_v18_3be91e.apk (277.85 KB)
Number of downloads: 
1,725 in total · 0 in the last 24 hours
MD5 checksum: 
3be91e7e37a43f9de707e5635b722a16
Uploaded on: 
Wednesday, July 9, 2014 - 02:36
Changes: 

Implemented triple presses and single/double press + hold mappings
An ability to log advanced debug info
An ability to set home and power button single press functions (at your own risk!)
An ability to disable original button functions ('do nothing' action)
Added French translation (thanks Rom!)

Version name: 
2.2
Release type: 
Stable (low risk of bugs)
Download: 
xeed.xposed.cbppmod_v16_26983f.apk (272.83 KB)
Number of downloads: 
4,548 in total · 0 in the last 24 hours
MD5 checksum: 
26983fdf3789fe87f521ae2dab9bab98
Uploaded on: 
Saturday, June 28, 2014 - 13:59
Changes: 

Added per-mapping delay/hold time setting
Fixed original volume button functions
Fixed single press function when hold function was set
Added Spanish translation (thanks fer866!)

Version name: 
2.1.1
Release type: 
Stable (low risk of bugs)
Download: 
xeed.xposed.cbppmod_v15_b72f53.apk (269.43 KB)
Number of downloads: 
3,101 in total · 0 in the last 24 hours
MD5 checksum: 
b72f53fcc65025bfdaf1215d796fc9b2
Uploaded on: 
Sunday, June 22, 2014 - 16:51
Changes: 

Fixed a bug that prevented original button functions from working
Re-enabled double presses for POWER and HOME keys
Re-enabled all functions for FOCUS key
Added Slovak translation (thanks pyler!)
Added Portuguese translation (thanks Typhus_!)

Version name: 
2.0
Release type: 
Stable (low risk of bugs)
Download: 
xeed.xposed.cbppmod_v13_051980.apk (263.16 KB)
Number of downloads: 
4,015 in total · 0 in the last 24 hours
MD5 checksum: 
051980be70aaac10c20c5182fdd45952
Uploaded on: 
Saturday, June 14, 2014 - 13:30
Changes: 

Almost full rewrite!
Allowed multiple keys for signals
More intuitive interface
Fixed many bugs

Version name: 
1.8
Release type: 
Stable (low risk of bugs)
Download: 
xeed.xposed.cbppmod_v12_6a0783.apk (253.64 KB)
Number of downloads: 
29,535 in total · 0 in the last 24 hours
MD5 checksum: 
6a0783af6e0e2012a9aa6c8891574438
Changes: 

Awesome new UI with tabs for devices with Android 3.0 and later
An ability to vibrate when sending signals
An option to send signals only when the headphones are plugged in

Version name: 
1.7
Release type: 
Stable (low risk of bugs)
Download: 
xeed.xposed.cbppmod_v12_74fe8a.apk (248.03 KB)
Number of downloads: 
3,538 in total · 0 in the last 24 hours
MD5 checksum: 
74fe8a0c4ff30b740d2b4e9615d81c4e
Changes: 

Added an ability to send signals only if player is already running
Added the camera focus "button" as possible key
Made the launch option only take place when the player isn't running

Version name: 
1.6.2
Release type: 
Stable (low risk of bugs)
Download: 
xeed.xposed.cbppmod_v11_a967be.apk (247.6 KB)
Number of downloads: 
711 in total · 0 in the last 24 hours
MD5 checksum: 
a967bebe727fb9477bb6d02dcbd81ee5
Changes: 

Fixed the launch intent happening regardless of the setting

Version name: 
1.6.1
Release type: 
Stable (low risk of bugs)
Download: 
xeed.xposed.cbppmod_v10_35dd47.apk (247.62 KB)
Number of downloads: 
246 in total · 0 in the last 24 hours
MD5 checksum: 
35dd47021fb909139309f4adcadfe1fa
Changes: 

Fixed Android 4.2 incompatibility

Version name: 
1.6
Release type: 
Stable (low risk of bugs)
Download: 
xeed.xposed.cbppmod_v9_f69020.apk (247.61 KB)
Number of downloads: 
247 in total · 0 in the last 24 hours
MD5 checksum: 
f6902008585d786fcd0aaeb0bcafc983
Changes: 

Introduced the ability to select a media player to use
Added a special option to launch media player activity, in case it needs it

Version name: 
1.5
Release type: 
Stable (low risk of bugs)
Download: 
xeed.xposed.cbppmod_v8_c4cf80.apk (246.42 KB)
Number of downloads: 
917 in total · 0 in the last 24 hours
MD5 checksum: 
c4cf80904e94e5db75c5e385744d9f1b
Changes: 

Fixed Gingerbread compatibility at cost of Froyo compatibility
Reimplemented volume up/down signals
Added compatibility mode which may make this mod work with some media players

Version name: 
1.4.1
Release type: 
Stable (low risk of bugs)
Download: 
xeed.xposed.cbppmod_v7_1afd02.apk (245.95 KB)
Number of downloads: 
1,096 in total · 0 in the last 24 hours
MD5 checksum: 
1afd020821e2b8a55b6fabf1af84cd04
Changes: 

Fixed a bug preventing the original key functions from working
Fixed compatibility with newest Android 4.2+ versions

Version name: 
1.4
Release type: 
Stable (low risk of bugs)
Download: 
xeed.xposed.cbppmod_v6_179dfe.apk (246.03 KB)
Number of downloads: 
924 in total · 0 in the last 24 hours
MD5 checksum: 
179dfe716154554ac75f3d293f9e3354
Changes: 

Even greater customization overkill!
Fixed (really this time) the pre-Honeycomb devices compatibility
Bigger list of keys that can be used
Requested feature to set volume on media play signals
Requested feature to send volume up/down signals with other keys

Version name: 
1.3.1
Release type: 
Stable (low risk of bugs)
Download: 
xeed.xposed.cbppmod_v5_c09296.apk (243.53 KB)
Number of downloads: 
1,291 in total · 0 in the last 24 hours
MD5 checksum: 
c0929601bf2775b016e825dcc67a7b47
Changes: 

Allowed better visuals on newer devices in the settings activity
Fixed incorrect labels in the settings activity

Version name: 
1.3
Release type: 
Stable (low risk of bugs)
Download: 
xeed.xposed.cbppmod_v4_bab502.apk (243.43 KB)
Number of downloads: 
373 in total · 0 in the last 24 hours
MD5 checksum: 
bab502d48f0574c436de32050f9ca0ca
Changes: 

Fixed a bug that prevented next/previous signals from being sent
Added a lot of customization options to the settings activity
Allowed different keys to be used

Version name: 
1.2
Release type: 
Stable (low risk of bugs)
Download: 
xeed.xposed.cbppmod_v3_89feb2.apk (240.98 KB)
Number of downloads: 
430 in total · 0 in the last 24 hours
MD5 checksum: 
89feb2bb3356e42c62e737eda13f9749
Changes: 

Added an ability to send play media signal when headphones get connected
Added a settings activity that allows to control which features to use
Made the module compatible back to SDK level 8 ('Froyo' 2.2)

Version name: 
1.1
Release type: 
Stable (low risk of bugs)
Download: 
xeed.xposed.cbppmod_v2_c5a10b.apk (238.3 KB)
Number of downloads: 
749 in total · 0 in the last 24 hours
MD5 checksum: 
c5a10bd9d2ad8551a1e7a1ccf12acb9f
Changes: 

Added next/previous media functions for volume buttons.
New name and icon.

Version name: 
1.0
Release type: 
Stable (low risk of bugs)
Download: 
xeed.xposed.cbppmod_v1_b1b032.apk (237.9 KB)
Number of downloads: 
1,360 in total · 0 in the last 24 hours
MD5 checksum: 
b1b03269ec39f63faee1e5d935763cf4
Changes: 

Initial version with pause/play function for the camera button.