This post has several sections:
* Brief description of the mod, background
* General mod information
* History for the change
* TrueSmart specific hints
Remap/add buttons on the TS: Assign keys or actions to key long press/click for single/double/triple buttons, including button combinations.
The TS only has two HW buttons. Both are mapped in such a way that they cannot be used by apps.
To use apps in cold and wet conditions, we need HW buttons in the apps.
Gestures like shake etc can to some extent be used, but sensors eat battery and are not as precise as buttons.
It is possible (with root) to change mapping of buttons to they can be used in apps, but that do not increase number of buttons (Home and Power is still needed somehow too).
I had expected that key combinations to be configurable in the default ROM, so combinations of key presses can be translated to Android standard buttons.
The button configuration can however be achieved in the Xposed Framework that injects hooks at a very low level in the operating system. I looked at some of the modules that provides button mapping, but they were not as complete as I would wish, so I adapted an existing module.
The Xposed Additions module modifications is not specific to the TrueSmart, but it is likely primarily interesting for the TrueSmart.
General mod information
Requirements:
* root
* backups recommended
Xposed Framework installation instructions:
http://forum.xda-developers.com/showthread.php?t=1574401¨
Note: Xposed is included with Lokifish Mars EnSec patch.
Xposed-additions mod:
http://web.comhem.se/gerhardo/ts/XPosedAdditionsGB.apk
This has Pro features temporary unlocked
Xposed-additions thread on xda:
http://forum.xda-developers.com/showthread.php?t=2294274
This mod will hopefully be merged to mainline by dk_zero-cool, until then the changes should be discussed here.
Source on GitHub:
https://github.com/gerhardol/xposed-additions
Planned:
* Custom key: I would like to use any key (especially more than available in Screen off). (workaround is to add any key, then edit shared_prefs)
Other:
This modification is signed with other keys than the original mod, so you have to uninstall the original mod to install this mod. Actually, you may even have to uninstall this mod if the test keys are replaced with standard keys.
The long-long press handling requires a little training to get used to. You probably do not want to have for example kill application and Camera on the same long press and Click too. I have Back on click and Home on long press and it works fine with about a second to get Home (and you get home from Recent apps too).
Note: This module could have conflicts if used together with the GravityBox module, that adds many other useful functions like pie menu. (GravityBox also have HW mapping functionality, but that was hard to adapt to the TS needs). I had some occasional problems with mapping Volume buttons on the phone I tested with. If this is a permanent problem, the modules must be integrated tighter.
History for the mod
See the original thread for details of the changes to the original module
2015-03-09: 3.5.2.1
* Synced with 3.5.2: Should work with Lollipop with enforced SELinux (this build is not tested in Lollipop though).
2015-02-22: 3.5.0.2
* App shortcuts did not work in 2.5.0.1
2015-02-21: 3.5.0.1
* Lollipop compatible, based on original module conversion.
Note: you will have to recreate the App Shortcuts after upgrading. The original author used the app shortcuts implementation, but store the data slightly differently, I aligned to that.
2015-01-31: 3.4.1.11
* Key mapping with app conditions: Add configuration to use default (screen) condition if no action set for a key click/press and repetitions combination. This makes it possible to handle app conditions as overlay to screen on.
2015-01-05: 3.4.1.10
* Only handle key conditions that matches. This module does not handle keys and key combinations that are not configured. However, previously it handled (possibly with default handling) keys also if there were no conditions that matched. This could for instance occur if a key only had onscreen condition, the module handled the key also in offscreen. Another example if a key had an app specific condition only.
2015-01-02 3.4.1.9
* Invoked keys: Do not delay first down until up or long-long timeout. No big difference as (most) action first when up/timeout anyway, but for instance Volume mapped to longpress gave problem to change just one step.
* Allow Camera, Back remap also when screen off. May be remapped in apps, even if keys make no sense by themselves
* Only run default action for secondary in a combo, ignore default action for primary key. Order could be maintained anyway when aborted and default Long-press would give alternating longpress for both, the behavior was inconsistent.
2014-12-29 3.4.1.8
* Unconfigured keys did not execute default handling, which affected feedback for some situations (configured keys still require handling).
* Callcode configuration was not overriding default action
*Do not turnon screen for (especially default) keys, can cause wakeup problems
2014-12-28 3.4.1.7
* Support for app shortcuts
2014-12-28 3.4.1.6
* Unconfigured keys was not always executing other steps when dispatched
2014-12-28 3.4.1.5
* Handling of wakeup keys (screen off) other than Power
* Gingerbread corrections (still untested)
* Combo: Always ignore primary key
2014-12-23 3.4.1.4
* The key/combo handling is updated. When a new key is pressed, check if there is any action for the key. If there are no actions for a single key, delay only if there are combo events configured for the key configuration. Just zip through unconfigured keys.
- When a new down key is pressed, the module checks if a combo is configured if there are an ongoing event
- Primary combo keys no longer requires explicit configuration (check unconfigured primary key).
* Easier to perform combo key actions, previously all action had to be done in the first long press timeout.
* Preserve the original key event when default invoking. Default invoking for keys with "meta" state should work better.
* If primary key in a combo is released, end the combo directly as if secondary is released. This changes the behavior of this mod, to be the same as the original version.
* Modified banner for Pro version.
This is a a relative large change to the state handling for keys, especially for combo keys. The changes should simplify maintenance of the "long-long press" handling.
Note especially that this is untested on Gingerbread. I have no GB devices, unless there are confirmations that it is working or there are simple changes, I plan to drop GB support.
2014-11-30 3.4.1.3
* Extend Pro license without time limit, but kept banner "Get Pro version for more features".
* Set defaults for "external devices" to allow, as for instance MediaTek devices requires the setting.
* Do not await multi-key events for keys that are not configured for single key events. This avoids the processing delay for unconfigured keys. It is possible to check the unconfigured keys to, by mapping them to default or by enabling "Check Unconfigured Primary Key".
2014-10-17 3.4.1.2
* Pro license extended to 2014-12-31
2014-08-17 3.4.1.1
* Based on 3.4.1, see the main module for changes. Some of the specific changes are adapted in 3.3/3.4.
* Reset when pressing Power is set to 15s (8s in 3.4.1).
* Make it possible to execute multi key preferences with the complete sequence
* Increase max for long-press/click timeouts (especially 200ms for click is too short for the TS)
* Patch to SeekBar for long-press/click handling (to avoid printouts in the log)
* Pro license extended to 2014-10-17
Some changes in the mod has been aligned with the main app (most of the proposals have been rejected for inclusion).
- Data storage is same as in main mod. So you can keep the data when switching plugins, but you must migrate your key mappings from 3.2.2.8
- Change Click/Long press settings after update (If previously using Default or Click follow long-press)
- Not allowing all devices by default. You have to allow external Keyboard and Gamepad for the TS.
- Previously all keys+app launch+actions were allowed with screen-off or lock screen. Tasker Actions can be used instead
- Last/Previous app switched to the last app in the list. The switch is now to last app not exited (i.e. switched with Recent Apps or Home, not exit to launcher with Back).
- Multi key mapping can be done with repeating secondary only (not by repeating primary only)
- Feedback on long-press, long-long-press for key must be enabled in the settings file: Set enable_longpress_feedback to true in /data/data/com.spazedog.xposed.additionsgb/shared_prefs/config.xml
- The mod previously did not execute default actions if multi was set to default as it is confusing: Should it be one or many? Then what is multi long-press default? The mod follows the 3.4 beavior with one default action.
- Keys without any actions are not pass-through directly, the handling is always delayed. The mod handling required that multi-key also had single actions (reasonable for me but rejected).
- Unconfigured wakeup keys (like Home on some devices) must be explicitly mapped in Screen-off.
---
2014-07-12 3.2.2.8
* Long-long-long power press: vibrate to announce pending reboot
* Avoid reboot for <= 4.1, when when toggle to closed application or launching apps.
2014-06-20 3.2.2.7
* Always activate the screen for Power when screen is off. Was not done for unconfigured Power keys.
* ToggleLastApp did not start most recent activity (visible in recent apps) if it was not running. This led to confusing behavior as some apps stop running when exiting with back, other not.
* Extend Pro license to 2014-08-31
2014-06-14 3.2.2.6
* Press Power for 15s to reboot the device. This is built in most ROMs (8-12s), but not the Umeox x201 series.
2014-06-08 3.2.2.5
Bug fixes:
* Toggle app could reboot the device
* Unconfigured wakeup keys (like Home) did not wakeup the device
2014-05-04 3.2.2.4
Bug fixes:
* Xposed Additions did not work in some ROMs (SlimKat) "showGlobalActionsDialog" missing
2014-05-04 3.2.2.3
Bug fixes:
* Certain combinations of key events could give incorrect handling for key up and even both click and long press (this could also occur in the standard module, not just the mod).
* Additional Haptic feedback long-long press
2014-04-25 3.2.2.2
Bug fixes:
* Power key required mapping to wakeup/shutdown
2014-04-12 3.2.2.1: Based on 3.2.2
New:
* New keys: Double long press, triple long press and triple tap
* Holding a button after long press trigger long press on invoked button after another 2*long press.
Then it is possible to map Home to long press to long press, get recent apps after 3*initial down.
* Multi-key actions only require secondary button at first press, then only primary is needed.
* Possibility to set press/tap timeout to system default and tap to press timeout. If tap/press do not match, actions may be neither press nor tap.
No change but clarification: Default only applies to single long-press, single click, not any other key. (how to explain double tap creates single click?)
Email log emails to me rather than the original author.
Bug fixes:
* Invoked button should have the initial down time.
* Key invoked key kept down had no limit on inject key rate (could be several per ms in the emulator).
* Up event was not sent for secondary button, only primary.
* If a key was unmapped, the mod still inserted a delay to relay key down. Normally this makes no difference as applications wait until confirmed long press/click anyway.
Extra in this release:
* Enabled all actions in all situations, i.e. app launch when screen is off, all key insertions, all special actions. This will likely be removed if app shortcuts and custom keys are supported. Launch apps when screen is off normally requires that screen is turned on manually.
---
2.3.x:
A previous modification here, with minor changes: https://plus.google.com/107109556238544025767/posts/X6786oAd7so
While that change was fixed and enhanced, the author existing module was rewritten, so my changes had to be rewritten too.
TrueSmart Specific
Example of setup. I want to use this in IpBike, that can use buttons like Vol+, Vol- and Camera to control the app.
Double Click Delay: 250ms
Long press delay: 300ms
All conditions are onscreen, except where noted.
Home:
* Single:
- Long-press: Home (long-long press is Recent apps)
- Click: Back
* Double:
- Long Press: Vol-
- Click: Last application
* Triple:
- Long Press: Menu (long-long press search)
- Click: Media previous
Home, offscreen:
* Single:
- Click: Power This is not needed to wake the device since 3.4.1.10, but it gives haptic feedback at wake.
Power:
* Single:
- Long-press: Power
- Click: Camera
* Double:
- Long Press: Vol+
- Click: No Touch (app, configured to toggle)
* Triple:
- Long Press: Zoom out
- Click: Media next
Power-Home combinations:
* Single:
- Long-press: Oclock
- Click: Llama Shortcut for IpBike (GPS, screen timeout etc, then start IpBike)
* Double:
- Call
- Click: Camera Zoom FX
IpBike setup:
Workout Next Key: Vol+
Zoom out: Zoom out
Zoom in: Long press zoom in
Start Sensors: Long Press Vol-
Start Trip: Vol-
Lap: Back
Screenlock: Long Press Menu
TTS feedback: Camera
Next Screen: Media next
Prev Screen: Media Prev
Thanks for the wonderful modifications! Works like a charm.
I've mapped my buttons slightly differently. With the setup above I found myself wondering which combinations were mapped to which action during normal use, so I just wanted to keep things simple to start with.
Home
Screen on
Long press: Home
Click: Back
Double Tap: Last App
Triple long press: Kill App
Screen off
Click: Power
Double Tap: Unlock Device (bypass "swipe" lockscreen)
Power
Screen on
Long press: Power menu
Click: Power
Double long press: Camera
Screen off
Same as Home button for simplicity
Thanks for sharing your modded version. Works great and haven't ran into any problems but wish I could add any custom actions into the application. If possible could someone please take the time to write a guide on how to do so? By far this is one of the most useful Xposed modules created yet.
Antitype said:
Thanks for sharing your modded version. Works great and haven't ran into any problems but wish I could add any custom actions into the application. If possible could someone please take the time to write a guide on how to do so? By far this is one of the most useful Xposed modules created yet.
Click to expand...
Click to collapse
You can add applications, but do you mean App Shortcuts?
The major problem there is that App Shortcuts are not documented, especially from the "XPosed Additions" point of view, similar to those of launchers.
The original author said he was working on it. I have taken a look, that is not trivial.
A solution could be to use Tasker and the App Factory to create applications of shortcuts.
gerhardo said:
You can add applications, but do you mean App Shortcuts?
The major problem there is that App Shortcuts are not documented, especially from the "XPosed Additions" point of view, similar to those of launchers.
The original author said he was working on it. I have taken a look, that is not trivial.
A solution could be to use Tasker and the App Factory to create applications of shortcuts.
Click to expand...
Click to collapse
I have used Tasker and App Factory to create shortcuts. It's a little bit slower than what I had in mind but it does work. I had hope to just be able to map any key to the button, like; "Alt-Tab", or something. Possible to implement? If possible would love to see a version of this in XPosed Additions.
Since version .5 the display constantly turns off when I turn it on with the power button, the power button is remapped while screen off for double click and long click, unfortunately the haptic feedback works not on version .4
xXYoshiXx said:
Since version .5 the display constantly turns off when I turn it on with the power button, the power button is remapped while screen off for double click and long click, unfortunately the haptic feedback works not on version .4
Click to expand...
Click to collapse
The workaround is to map click to Power.
Will change the handling in next version, committed a change. It is a delicate matter to handle the Power key, a lot of workarounds. Cant be sure this is the last change.
There is haptic feedback on earlier versions, but .4 adds extra feedback for the "virtual inserted" keys.
I mapped long power when screen off to camera and it works, but without unlocking phone
Is that possible to unlock locked phone when maped app are started?
Also i brought the full version, but i whant to use your mod (not original app). Will it work after 30.06?
I does not work for me
gerhardo said:
Requirements:
* root
* backups recommended
Xposed Framework installation instructions:
http://forum.xda-developers.com/showthread.php?t=1574401¨
Note: Xposed is included with Lokifish Mars EnSec patch.
Xposed-additions mod:
http://web.comhem.se/gerhardo/ts/XPosedAdditionsGB.apk
This has Pro features temporary unlocked until 2014-06-30
Xposed-additions thread on xda:
http://forum.xda-developers.com/showthread.php?t=2294274
This mod will hopefully be merged to mainline by dk_zero-cool, until then the changes should be discussed here.
Source on GitHub:
https://github.com/gerhardol/xposed-additions
Planned:
* The original author has planned to add support for App Shortcuts. Then for instance Llama shortcuts can be mapped to execute a series of events.
* Custom key: I would like to use any key (especially more than available in Screen off).
Other:
This modification is signed with other keys than the original mod, so you have to uninstall the original mod to install this mod. Actually, you may even have to uninstall this mod if the test keys are replaced with standard keys.
The long-long press handling requires a little training to get used to. You probably do not want to have for example kill application and Camera on the same long press and Click too. I have Back on click and Home on long press and it works fine with about a second to get Home (and you get home from Recent apps too).
Note: This module could have conflicts if used together with the GravityBox module, that adds many other useful functions like pie menu. (GravityBox also have HW mapping functionality, but that was hard to adapt to the TS needs). I had some occasional problems with mapping Volume buttons on the phone I tested with. If this is a permanent problem, the modules must be integrated tighter.
Click to expand...
Click to collapse
In my Omate Truesmart 1900 I have installed xposed Framework and have installed xposed additions and try to map buttons to the camera but it did not work. What I am doing wrong? Thanks
rdefranx said:
In my Omate Truesmart 1900 I have installed xposed Framework and have installed xposed additions and try to map buttons to the camera but it did not work. What I am doing wrong? Thanks
Click to expand...
Click to collapse
What are you trying to do?
You can start a camera app with a button or combination and the Camera button to take pictures (only implemented in some apps).
See my setup for details.
b2rdetor said:
I mapped long power when screen off to camera and it works, but without unlocking phone
Is that possible to unlock locked phone when maped app are started?
Also i brought the full version, but i whant to use your mod (not original app). Will it work after 30.06?
Click to expand...
Click to collapse
I consider launching apps when screen is off as temporary for this kind of issues. Some may want to start the screen, other will not.
If the app could map to App Shortcuts, you could map Llama/Tasker events to buttons and do what you prefer.
So I do not plan anything else right now.
The latest build is unlocked until 2014-08-31. I am not involved in the Pro version but plan to release version until "suffiently changes are merged".
gerhardo said:
What are you trying to do?
You can start a camera app with a button or combination and the Camera button to take pictures (only implemented in some apps).
See my setup for details.
Click to expand...
Click to collapse
Hi, what I am trying to do is start the camara app from the home button in the truesmart if it is possible with a double click. I added the new button in xposed aditions, added the condition (when on or off), then selected the app (camera). I tried but it doesn't work. Thanks.
Personally I have set up my TS to use almost no button presses at all, in the interests of minimising the wear on the moving parts (and their water resistant components if any).
Using the "All In One Gestures" app you can add four corner swipes and one swipe from the bottom (given that left and right swipes are already used by the TS, and the downswipe is probably already used for notifications). So that's five extra "buttons", if you like.
On mine I've set up the top right and bottom right corners to replicate the functions of the adjacent buttons to avoid using them but of course you could continue to use the buttons if desired, and use those corners for other functions.
rdefranx said:
Hi, what I am trying to do is start the camara app from the home button in the truesmart if it is possible with a double click. I added the new button in xposed aditions, added the condition (when on or off), then selected the app (camera). I tried but it doesn't work. Thanks.
Click to expand...
Click to collapse
Works fine.
Long or double click.
Off works too but with locked screen.
rdefranx said:
Hi, what I am trying to do is start the camara app from the home button in the truesmart if it is possible with a double click. I added the new button in xposed aditions, added the condition (when on or off), then selected the app (camera). I tried but it doesn't work. Thanks.
Click to expand...
Click to collapse
Are you sure you did not add the Camera button?
That button you can use to take pictures in some apps. (I use Camera Zoom FX since long, there are others with Camera support.)
The stock Camera app on the TS has no shortcut on my device. It is the same app as Gallery, but then you have to switch to the Camera in Menu. Start the app in Camera mode can maybe be resolved with a shortcut, somehow.
Ozpeter said:
Personally I have set up my TS to use almost no button presses at all, in the interests of minimising the wear on the moving parts (and their water resistant components if any).
Click to expand...
Click to collapse
It all depends of what you want to use the TS for.
As a sports device, buttons are essential. I tend to use the buttons more and more, also when I can use the screen.
The TS has potential, but unless the firmware is fixed button wear is my smallest problem.
gerhardo said:
Are you sure you did not add the Camera button?
That button you can use to take pictures in some apps. (I use Camera Zoom FX since long, there are others with Camera support.)
The stock Camera app on the TS has no shortcut on my device. It is the same app as Gallery, but then you have to switch to the Camera in Menu. Start the app in Camera mode can maybe be resolved with a shortcut, somehow.
Click to expand...
Click to collapse
Hi, I don't know but I have a camera shortcut in my TS. Well, if anyone can tell me what are the steps to do this correctly I will appreciate. Thanks for your replies.