Skip to content

A quick and dirty plugin to allow you remap alt tab chord for kaleidoscope

License

Notifications You must be signed in to change notification settings

Nimamoh/Kaleidoscope-TranscientWindowSwitchingState

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Kaleidoscope-TranscientWindowSwitchingState

Have you tried to re-create 【Alt+Tab】 on keyboard.io (remapping it on 【Fn+d】 for instance)

It is not easy. See https://blog.nimamoh.net/keyboard-io-m01-alt-tab/ for a quick and dirty rationale.

This plugin allows you to

  • Enable a state where Alt key is hold. (The transcient window switching state)
  • Disable the TWSS when user defined keys are released.

How to use

git clone on your sketchbook directory. (see https://github.com/keyboardio/Kaleidoscope/wiki/Installing-Plugins#installing-third-party-plugins)

Include directive:

#include "Kaleidoscope-TranscientWindowSwitchingState.h"

Initialize the plugin

KALEIDOSCOPE_INIT_PLUGINS(
    ...
    TranscientWindowSwitchingState,
    ...
)

Define the keys which exits the TWSS on setup function, (Use the TWSS_KEYS helper macro for that):

static const kaleidoscope::Key stoppingKeys[] = TWSS_KEYS(Key_Escape, ShiftToLayer(2));
TranscientWindowSwitchingState.disableOnReleaseKeys = stoppingKeys; 

The TWSS is disabled by default, you can enable it by enabling the plugin

Define a macro which enable the plugin:

static void windowSwitch(uint8_t keyState) {
  TranscientWindowSwitchingState.enable();
  kaleidoscope::hid::pressKey(Key_Tab, keyToggledOn(keyState));
}

Assign your macro and you are good to go

Gotchas

  • Try to stick to the guide above, this plugin is quite specific (and certainly too complex for what it aims for), do not forget to define at least one stopping key to prevent being stuck to the TWSS.
  • This is my first plugin with kaleidoscope and I didn't write cpp for a long time. PR and ideas of improvment are welcome.

About

A quick and dirty plugin to allow you remap alt tab chord for kaleidoscope

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published