Documentation

Space Shift

Space Shift (SS) leverages the Space key as a modifier key, enabling a variety of inputs and controls without moving your hands from the keyboard's home position.

Space Shift (SS) leverages the Space key as a modifier key, enabling a variety of inputs and controls without moving your hands from the keyboard’s home position.


Basic Concept and Operational Behavior

  • Layer Activation via Long Press:
    • Holding down the Space key (defaulting to 300ms or longer) and pressing other alphabetical keys activates the Space Shift (SS) layer mapping.
    • In this state, the indicator displays .
  • Space Input via Short Press (Tap):
    • Tapping and releasing the Space key quickly (without combining it with another key) sends a single regular space character ( ).

Continuous Space Output Mode

To balance “layer activation via long press” with “continuous space input,” the following smart detection logic is implemented:

  1. Double-Tap Continuous Send:
    • If you press down the Space key again immediately after tapping and releasing it, the tool detects that you want to type multiple spaces continuously.
    • In this state, as long as you hold down the Space key, spaces will be entered continuously via the OS’s standard key-repeat behavior (temporarily bypassing layer activation via long press).
  2. Maintaining Typing Comfort:
    • This continuous output mode allows you to easily type multiple spaces or adjust indentations without losing typing speed, coexisting seamlessly with the long-press layer function.

Conflict Prevention Technology

To prevent mismatches between the physical state of the space key (KeyDown / KeyUp) and the OS’s key state recognition—such as during macro playback or when modifiers are pressed simultaneously—the tool performs smart recovery of the logical key state internally. For instance, when macro playback begins, it temporarily sends a logical Space Up even if the physical Space key is held down, ensuring safe character playback. Once playback is complete, it restores the original Space Down state. This prevents unintended space characters from being inserted.