Mod-Tap with VIA

Mod-Tap with VIA

Posted Oct 13, 2024 ⋆ Last modified Oct 26, 2024

Originally posted on boogerbuttcheeks.com

Here’s how to setup a Mod-Tap key on VIA software that acts as Escape on tap and Control when held. You have to use the special Any key.

  1. Open the VIA application or navigate to usevia.app on a comptible browser (Safari no, Chrome yes).
  2. Click Authorize Device, select your keyboard in the dialog popup, and click Connect.
  3. On the preview of your keyboard, select the key you want to add the Mod-Tap to. Then select the SPECIAL tab of the GUI and select the Any key.
  4. In the popup that appears, enter the desired QMK keycode. To setup a Mod-Tap, you use the following syntax:
// MT stands for Mod-Tap
MT(KEY_WHEN_HELD, KEY_WHEN_TAPPED)
// Since I want Control when held and Escape on tap...
MT(MOD_LCTL, KC_ESC)
  1. Done!

It took me a long time to figure this out because I thought Mod-Taps were set up in the MACRO tab. Don’t be like me…