ZMK의 Behavior 전체 목록
- Behavior는 키맵 레이어의 키 위치, 센서(엔코더), 콤보에 할당되어 키를 누르거나 뗄 때 발생하는 동작을 정의합니다.
- 다른 Behavior(예: 매크로)에서 재귀적으로 호출될 수도 있습니다.
🔑 Key Press Behaviors (키 입력)
캡션 텍스트
| 바인딩 |
Behavior |
설명
|
| `&kp` |
Key Press |
키 눌렀을 때 호스트로 키코드 전송
|
| `&mt` |
Mod Tap |
홀드/탭에 따라 다른 키코드 전송
|
| `&kt` |
Key Toggle |
키 토글 (누른 상태 유지/해제)
|
| `&sk` |
Sticky Key |
다음 키 입력 시까지 유지 (Shift 원핸드 입력 등)
|
| `&gresc` |
Grave Escape |
Shift/GUI 홀드 시 `` ` ``, 아닐 때 ESC
|
| `&caps_word` |
Caps Word |
Caps Lock 유사하지만 특정 키 누르면 자동 해제
|
| `&key_repeat` |
Key Repeat |
직전에 보낸 키코드 재전송
|
🔀 Miscellaneous Behaviors
캡션 텍스트
| 바인딩 |
설명
|
| `&trans` |
Transparent — 하위 활성 레이어로 키 전달
|
| `&none` |
None — 키 입력 완전 차단
|
🗂️ Layer Navigation Behaviors
캡션 텍스트
| 바인딩 |
Behavior |
설명
|
| `&mo` |
Momentary Layer |
누르는 동안 레이어 활성화
|
| `<` |
Layer-tap |
홀드 시 레이어, 탭 시 키코드
|
| `&to` |
To Layer |
해당 레이어만 활성화, 나머지 비활성
|
| `&tog` |
Toggle Layer |
수동으로 끌 때까지 레이어 유지
|
| `&sl` |
Sticky Layer |
다음 키 누를 때까지 레이어 활성
|
🖱️ Mouse Emulation Behaviors
캡션 텍스트
| 바인딩 |
설명
|
| `&mkp` |
마우스 버튼 클릭
|
| `&mmv` |
마우스 커서 이동
|
| `&msc` |
마우스 스크롤
|
🔄 Reset Behaviors
캡션 텍스트
| 바인딩 |
설명
|
| `&sys_reset` |
펌웨어 재시작
|
| `&bootloader` |
부트로더 모드 진입 (펌웨어 플래싱용)
|
📡 Output Selection Behaviors
캡션 텍스트
| 바인딩 |
설명
|
| `&bt` |
블루투스 동작 (기기 전환 등)
|
| `&out` |
USB / BLE 출력 선택
|
💡 Lighting Behaviors
캡션 텍스트
| 바인딩 |
설명
|
| `&rgb_ug` |
RGB 언더글로우 제어
|
| `&bl` |
백라이트 제어
|
⚡ Power Management Behaviors
캡션 텍스트
| 바인딩 |
설명
|
| `&ext_power` |
VCC 전원 출력 ON/OFF (절전)
|
| `&soft_off` |
키보드 전원 끄기
|
🔓 ZMK Studio Behaviors
캡션 텍스트
| 바인딩 |
설명
|
| `&studio_unlock` |
ZMK Studio UI에서 키맵 변경 허용 잠금 해제
|
🛠️ User-Defined Behaviors (사용자 정의)
캡션 텍스트
| Behavior |
설명
|
| **Macros** |
키 누름/뗌 시 여러 Behavior 순서대로 실행
|
| **Hold-Tap** |
홀드/탭 시간이나 인터럽트 키에 따라 다른 Behavior
|
| **Tap Dance** |
탭 횟수에 따라 다른 Behavior 실행
|
| **Mod-Morph** |
특정 Modifier 홀드 여부에 따라 다른 Behavior
|
| **Sensor Rotation** |
엔코더 CW/CCW 회전에 따라 다른 Behavior
|
Sputnik Corne 키보드에서 자주 쓰이는 것은 `&mt` (Mod-Tap), `<` (Layer-Tap), `&mo`, `&sk`, `&td` (Tap-Dance) 정도입니다.