Explanation of how to change the keymap using NuPhy’s VIA

当ページのリンクには広告が含まれています。

The latest series such as Air “v2”, Halo “v2”, and Gem80 released in 2023 are QMK/VIA compatible, so keymaps can be easily changed on the GUI without programming knowledge.

However, since each of these mechanisms was not introduced in the v1 model when it was first released, many people may find it difficult to make the changes or do not know how to set them up.

This section tells you how to change the keymap of the Nuphy keyboard using the QMK/VIA mechanism.

NuPhy’s keyboards are capable of advanced functions using “Anykey” such as “simultaneous presses” and “key bindings change depending on press duration” even with wireless connectivity.

この記事の著者
Kawamura top R

Representative of GreenEchoes Studio

Ryosuke Kawamura

He launched his own media as a site operator and web writer, and now plans and manages multiple corporate media. He often types heavily in his work, and in his search for greater efficiency, he became addicted to the keyboard swamp and established “GreenKeys”.

タップできる目次

Discount Code: ryo10

to save 10% off your purchase.

Discount Code: ryo10

to save 10% off your purchase.

Click here for a list of coupon codes ▷▷▷

Find a keyboard layout you like.

This site is operated on a performance-based compensation advertising basis, and we may receive revenue from product purchases made through this site. Please be aware that some of the keyboards on this site are presented as advertisements (PR). This alert information conforms to the provisions of Article 5, Item 3 of the Revised Act Against Unjustifiable Premiums and Misleading Representations, which came into effect on October 1, 2023.

How to change keymap for NuPhy keyboard supporting QMK/VIA

First, a “.json” file is required before any keymap changes can be made.

06044f7e47e03db45e008a4850abcba2
Image reference: https://nuphy.com/pages/json-files-for-nuphy-keyboards

Download the software from the download page of the official website below.

https://nuphy.com/pages/json-files-for-nuphy-keyboards

keymap change procedure

STEP
有線モードで接続
IMG 20231020 062017 scaled

Connect a QMK/VIA compatible NuPhy keyboard to your PC /Mac with the keyboard set to “wired connection mode”.

STEP
VIAへアクセス

Access VIA ( https://usevia.app/#/ ) from your browser.

STEP
ブラウザでの読み込みを許可する

Click on “AUTHORIZE NEW” to select the keyboard whose keymap you want to change, then click on the Connect button to allow the browser to load it.

STEP
デザインタブを選択してjsonファイルを読み込む

Click on the second “paint brush symbol (Design tab)” from the right, then click on “Upload Area”.

On the file selection screen, select the json file downloaded from the official site.

The work is now complete.

Then select the “CONFIGURE” tab and change the keymap.

d9a54ada8ed2b86160daf3793b4a2a66

What to do when you cannot change the keymap on a QMK/VIA-compatible NuPhy keyboard

This section is for those who cannot change the keymap.

VIAを開いてもキーマップの変更ができません。何か間違っていますか?

To change the keymap, a special file called “json” is required. Download the json file from the official site and load it from the Design tab on the VIA site to change the keymap.

VIAでのキーマップの変更が反映されません。どうしてですか?

Air75v2/Air60v2 has a physical keyswitch for OS switching, and in Mac mode, “Layer0” is the default layer and “Layer1” is the second layer.

When in Win mode, the default layer is “Layer2” and the second layer is “Layer3”.

If you are a Windows user, and you are using in Win mode, you will feel that your keymap changes will not be reflected unless you change “Layer2” and “Layer3”.

The reason why keymap changes are not possible on QMK/VIA-compatible NuPhy keyboards is a case where the json files have not yet been merged into VIA.

Normally, if you connect a VIA-compatible keyboard by wire and access the VIA site, it will start loading automatically and you can change the keymap without having to read the json file.

However, since there is a time lag before registration, it appears that the json files required for keymap changes are not registered with VIA.

This is the reason why many people seem to get tripped up on changing keymaps.

Kawamura top RKawamura

Perhaps in time it will be possible to change the keymap without reading the json file.

Tidbits on changing the keymap

3fba9ad18f3417d01a6594c31c339c15

VIA has an intuitive UI, so you will not have that much trouble changing keymaps.

The basic usage is to simply drag and drop the key switch symbol you wish to change onto the keyswitch section of your choice, and the change will be reflected in real time.

However, there is actually quite a lot that can be done with QMK, which is the root of VIA.

Click here for the original explanation page of QMK Keycodes ▷▷▷.

Set up macros

Macros can be set up to create buttons that automate certain operations by registering specific operations.

Record a specific operation from the Macro Registration tab and set the M button.

f58a1980586668e207c097b9743430ea
0ab827f0aecbfe9c2034217219d1a1d7

Simultaneous presses and short/long press settings

QMK/VIA can implement advanced functions such as “simultaneous pressing of multiple keys with a single button operation” and “changing the content of keys to be input according to the time of pressing”.

It can be set from “SPECIAL” -> “Any” on the VIA Settings screen, but since it is necessary to type in the “code”, the setting hurdle is quite high if you are not familiar with QMK Codes.

For such people, we offer the VIA Any Generater, a system that allows you to generate code without knowledge, and we encourage you to use it.

Kawamura top RKawamura

The QMK code is reproduced below in case you are interested, but it is easier to use a generator.

Modifiers :id=modifiers (simultaneous key presses)

KeyAliasesDescription
LCTL(kc)C(kc)Hold Left Control and press kc
LSFT(kc)S(kc)Hold Left Shift and press kc
LALT(kc)A(kc), LOPT(kc)Hold Left Alt and press kc
LGUI(kc)G(kc), LCMD(kc), LWIN(kc)Hold Left GUI and press kc
RCTL(kc)Hold Right Control and press kc
RSFT(kc)Hold Right Shift and press kc
RALT(kc)ROPT(kc), ALGR(kc)Hold Right Alt (AltGr) and press kc
RGUI(kc)RCMD(kc), RWIN(kc)Hold Right GUI and press kc
LSG(kc)SGUI(kc), SCMD(kc), SWIN(kc)Hold Left Shift and Left GUI and press kc
LAG(kc)Hold Left Alt and Left GUI and press kc
RSG(kc)Hold Right Shift and Right GUI and press kc
RAG(kc)Hold Right Alt and Right GUI and press kc
LCA(kc)Hold Left Control and Alt and press kc
LSA(kc)Hold Left Shift and Left Alt and press kc
RSA(kc)SAGR(kc)Hold Right Shift and Right Alt (AltGr) and press kc
RCS(kc)Hold Right Control and Right Shift and press kc
LCAG(kc)Hold Left Control, Alt and GUI and press kc
MEH(kc)Hold Left Control, Shift and Alt and press kc
HYPR(kc)Hold Left Control, Shift, Alt and GUI and press kc
KC_MEHLeft Control, Shift and Alt
KC_HYPRLeft Control, Shift, Alt and GUI
Cited from: https://github.com/qmk/qmk_firmware/blob/master/docs/keycodes.md

Thus, simultaneous pressing with certain keyswitches can be realized.

For example, if you want to set up a shortcut for the paste button (CTRL +V), set the Any key in SPECIAL, and in the Any key setting field

LCTL(KC_V)

to create a paste button.

311cc7284039f6053fc89857d6e6fdb2

Configure MOD-TAP

MOD-TAP is a very useful mechanism of QMK.

It is possible to have different key functions for long press (HOLD) behavior and single press (TAP) behavior.

KeyAliasesDescription
MT(mod, kc)mod when held, kc when tapped
LCTL_T(kc)CTL_T(kc)Left Control when held, kc when tapped
LSFT_T(kc)SFT_T(kc)Left Shift when held, kc when tapped
LALT_T(kc)LOPT_T(kc), ALT_T(kc), OPT_T(kc)Left Alt when held, kc when tapped
LGUI_T(kc)LCMD_T(kc), LWIN_T(kc), GUI_T(kc), CMD_T(kc) WIN_T(kc)Left GUI when held, kc when tapped
RCTL_T(kc)Right Control when held, kc when tapped
RSFT_T(kc)Right Shift when held, kc when tapped
RALT_T(kc)ROPT_T(kc), ALGR_T(kc)Right Alt (AltGr) when held, kc when tapped
RGUI_T(kc)RCMD_T(kc), RWIN_T(kc)Right GUI when held, kc when tapped
LSG_T(kc)SGUI_T(kc), SCMD_T(kc), SWIN_T(kc)Left Shift and GUI when held, kc when tapped
LAG_T(kc)Left Alt and GUI when held, kc when tapped
RSG_T(kc)Right Shift and GUI when held, kc when tapped
RAG_T(kc)Right Alt and GUI when held, kc when tapped
LCA_T(kc)Left Control and Alt when held, kc when tapped
LSA_T(kc)Left Shift and Left Alt when held, kc when tapped
RSA_T(kc)SAGR_T(kc)Right Shift and Right Alt (AltGr) when held, kc when tapped
RCS_T(kc)Right Control and Right Shift when held, kc when tapped
LCAG_T(kc)Left Control, Alt and GUI when held, kc when tapped
RCAG_T(kc)Right Control, Alt and GUI when held, kc when tapped
C_S_T(kc)Left Control and Shift when held, kc when tapped
MEH_T(kc)Left Control, Shift and Alt when held, kc when tapped
HYPR_T(kc)ALL_T(kc)Left Control, Shift, Alt and GUI when held, kc when tapped – more info here
Cited from: https://github.com/qmk/qmk_firmware/blob/master/docs/keycodes.md
Kawamura top RKawamura

For example, setting MT(MOD_RSFT, KC_SLSH) will function as a shift key when long pressed and / when single pressed.

We are looking for keyboard-related information! If you have any information on new products or content you would like us to publish, please use the inquiry form.

Kawamura

Many companies have contacted us.
We encourage you to use our website for sales promotion!

気に入ったらシェアしてね!

GreenKeys著者情報

河村 亮介のアバター 河村 亮介 GreenKeys運営責任者/事業代表

WEBサイト運営事業GreenEchoes Studio代表をしています。他社法人メディアの運営ほかキーボードメディアや通信系メディアへの寄稿を行うなど、ウェブライターとしても活動しています。今年はオリジナルキーキャップセットを作る予定。

タップできる目次