jamesnvc/kaleidoscope-toifalone

Like Karabiner's ToIfAlone for Kaleidoscope

Kaleidoscope-ToIfAlone

This plugin enables you to have a key that acts normally when tapped, but shifts to a layer when held in conjunction with pressing other keys. It is very similiar to DualUse, mainly differing by never timing out.

It is made to emulate the behaviour of Karabiner's ToIfAlone functionality, hence the name.

Using the plugin

Add the plugin to your available libraries by cloning it into your Arduino-Boards/libraries directory.

#include <Kaleidoscope.h>
#include <Kaleidoscope-ToIfAlone.h>

// Have an enum for layers
// or some other way of assigning numbers to layers
enum {
  _BASE,
  _NUMPAD,
};

void setup(void) {
  Kaleidoscope.use(&ToIfAlone);

  Kaleidoscope.setup();

  static kaleidoscope::ToIfAlone::KeyBinding toifalonemap[] = {
    {Key_Escape, _NUMPAD},
    TOIFALONE_MAP_END
  };
  ToIfAlone.map = toifalonemap;
}

Plugin methods

The plugin provides the ToIfAlone object, with the following property:

.map

Set the key map. This takes an array of kaleidoscope::ToIfAlone::KeyBinding objects. The last item in the array must be the special TOIFALONE_MAP_END value. Each KeyBinding objects takes the key that will be pressed and the layer that it should shift to, respectively.

By default, the map is empty.

Further reading

Starting from the example is the recommended way of getting started with the plugin.

kaleidoscope-toifalone's Issues

Typing Unicode doesn't work while holding down key

If I use this plugin to shift to a layer that has macro keys on it that use the Unicode plugin to type things, the Unicode doesn't get sent. Unicode is sent properly if switching to said layer "normally" (using a one-shot layer, in my case).

Releasing a held key should prevent the secondary key from typing

Scenario:

Hold Motion Layer, Press "J" to move down.
Release Motion Layer while "J" is still down.

Actual:
"J" is typed.

Expected:
"J" is not typed.

Possible to allow Shift or other modifiers with Tap key?

I'd like to be able to have a

{Key_Tab, SYMBOLS}

mapping, but then it becomes impossible to type "shift+tab" anywhere on the keyboard. Could you allow modifiers for the tap key?