Bilateral Combinations

The last mod-tap hold will be converted to the corresponding mod-tap tap if another key on the same hand is tapped during the hold, unless a key on the other hand is tapped first.

This option can be used to prevent accidental modifier combinations with mod-tap, in particular those caused by rollover on home row mods.

• documentation
• branch

This is a proof of concept implementation. Please note the known issues.

A more correct implementation based on per-keypair tapping term is planned for the future. If successful, the current implementation will be dropped. If not, issues with the current implementation will be addressed and a PR submitted upstream.

Available for testing.

• documentation
• branch

I am not sure whether this is per design or a bug, but I am experiencing an issue with the bilateral combination setting. Despite it being turned on, the modifier code still seems to register for same-handed combinations. But instead of being sent together with the next key code, it is sent by itself.

Describe the Bug

Example (using colemak):

1. Press and hold LGUI_T(KC_A) longer than TAPPING_TERM
2. Press any other left-hand key, for example KC_R

This results in the following sequence of key strokes:

1. KC_LGUI
2. KC_A
3. KC_R

Note that the modifier is not sent together with the next key, instead it is sent by "itself" (triggered upon pressing the 2nd key). Accordingly, this issue does not matter for modifiers which do not do anything by themselves (shift, control), but for Alt and in particular for Gui, it has unintended effects on Windows 10. E.g., the above sequence will result in the windows start menu being opened and "AR" being typed into the search bar.

System Information

• Keyboard:
  • Revision (if applicable): Katana60 rev2
• Operating system: Windows 10
• AVR GCC version: 8.4.0
• ARM GCC version: 8.3.1 20190703 (release) [gcc-8-branch revision 273027]
• QMK Firmware version: 0.12.50 (merged with the Oct 26, 2020 version of your bilateral-combinations branch)
• Any keyboard related software installed?
  • AutoHotKey
  • Karabiner
  • Other: WinCompose v0.9.6 (issue persists when disabling the software)

A bilateral_combinations_per_key setting for the bilateral combinations option could be a useful feature.

Description

The setting would determine which tab-mods would be affected by the bilateral combinations setting and would work similar to permissive_hold_per_key. The setting would be useful to allow for certain one-handed combinations, while restricting home row mods to opposite hands. E.g., one could enable one-handed short-cuts involving thumb mods, which would be useful when when having one hand on the keyboard and the other one on the mouse

Extend BILATERAL_COMBINATIONS_HANDS from #17 (comment) to support left / right / any, to allow some keys to be immediately used as mods when combined with keys from either hand, for keys used as mods that can be reached from either hand.

Note same hand combinations are also already supported with a timeout:

If BILATERAL_COMBINATIONS is defined to a value, hold times greater than that value will permit same hand combinations.

It would be awesome to be possible to disable a few modifiers from the Bilateral Combinations setup. I want to do Ctrl+C, Ctrl+V or Ctrl+R with the same hand (e.g. LCTL_T(KC_Z) + KC_C) because I'm very used to doing this with the same hand and I always end up with "zc", "zv" since my Ctrl mod is on Z.

Retro Shift

Auto Shift for Tap Hold via Retro Tapping

Retro Shift combines the Tap Hold logic of Retro Tapping with the configurable keycode range matching of Auto Shift while preserving the ability to hold and release without producing a tap.

• documentation
• branch

This is a proof of concept implementation. Please note the known issues.

Describe the Bug

I have merged your branches manna-harbour/miryoku and manna-harbour/bilateral-combinations in my copy of qmk_firmware/master and enabled the BILATERAL_COMBINATIONS feature in config.h. I have noticed that keyboard combinations Ctrl-Backspace and Ctrl-Delete (e.g., delete previous and next work in Notepad) do not work anymore. Without the merge of manna-harbour/bilateral-combinations (but with manna-harbour/miryoku), both work as expected.

System Information

• Keyboard: Planck
  • Revision (if applicable): 6
• Operating system: Windows 10
• AVR GCC version: 5.4.0

• ARM GCC version: 9.2.1

• QMK Firmware version: 0.11.56 (with manna-harbour/miryoku and manna-harbour/bilateral-combinations merged in)

• Any keyboard related software installed?
  • AutoHotKey
  • Karabiner
  • Other:

Additional Context

You can find the branch here: https://github.com/Shredder/qmk_firmware/tree/dev_jz_bilateral_combinations.

Modular Hardware QMK

Provides modular hardware support for QMK keymaps. The following capabilities are included:

• Pointing devices:
  • Devices:
    • PAW3204
    • PIM447
    • PMW3360
    • Raw HID (non-integrated pointing device via daemon on host)
  • Transformation of movement:
    • Acceleration:
      • Linear
      • Polynomial
    • Axes rotation
    • Conversion:
      • Converted to:
        • Scroll
        • Reduced movement
        • Key taps
      • Activated by:
        • Layer
        • Key tap to toggle
        • Key hold
  • Reaction to movement:
    • Layer activation

Enabling support requires only adding a single line to the keymap, and features can be selected at build time.