You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/content/docs/input-remapper-tutorial.mdx
+16-11Lines changed: 16 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
# SPDX-FileCopyrightText: Simon Schneegans <code@simonschneegans.de>
3
3
# SPDX-License-Identifier: CC-BY-4.0
4
4
5
-
title: Input-Remapper (Linux)
5
+
title: InputRemapper (Linux)
6
6
description: A guide on how to use Input Remapper to open Kando menus with mouse buttons.
7
7
---
8
8
@@ -16,31 +16,36 @@ import Intro from '../../components/Intro.astro';
16
16
On Linux, you can use a tool called [Input Remapper](https://github.com/sezanzeb/input-remapper) to remap mouse buttons or controller buttons to keyboard shortcuts and open Kando menus this way!
**Input Remapper** is a tool which allows you to remap mouse buttons to keyboard shortcuts. While you can use it directly to bind menus to mouse buttons via keyboard shortcuts, it also allows for more advanced setups like showing menus when pressing two mouse buttons at the same time.
22
24
23
25
Input Remapper on GitHub: https://github.com/sezanzeb/input-remapper
26
+
24
27
You can visit the repository to learn about installation and general usage. This article will focus specifically on how to work with Kando.
25
28
26
29
# Configuration
27
30
28
31
There are three ways to trigger a Kando menu through Input Remapper.
29
32
30
-
*To demonstrate the most complex scenarios, the examples below use `Ctrl+Shift+F1` as the trigger. You can modify this to your preferred shortcut.*
33
+
<Asidetype="note"title="Note">
34
+
To demonstrate the most complex scenarios, the examples below use `Ctrl+Shift+F1` as the trigger. You can modify this to your preferred shortcut.
35
+
</Aside>
31
36
32
37
## Option 1: Direct Shortcut Mapping
33
38
34
-
This is the simplest method. Pressing a single mouse button triggers the Kando menu.
39
+
This is the simplest method. Pressing a single mouse button triggers the Kando menu:
35
40
36
41
```yaml
37
42
# Any Mouse Button
38
43
# Target: keyboard
39
44
KEY_LEFTCTRL + KEY_LEFTSHIFT + KEY_F1
40
45
```
41
46
42
-
- Pros: Fast response with zero latency; simple setup.
43
-
- Cons: The button loses its original function, only suitable for mice with extra buttons.
47
+
-**Pros**: Fast response with zero latency; simple setup.
48
+
-**Cons**: The button loses its original function, only suitable for mice with extra buttons.
44
49
45
50
## Option 2: Long Press Mouse Button
46
51
@@ -52,12 +57,12 @@ A long press triggers the Kando menu, while a short press (tap) retains the butt
The number `150` at the end represents the duration required for a long press in milliseconds (ms). You can adjust this value, but setting it too short may lead to accidental triggers.
57
62
</Aside>
58
63
59
-
- Pros: Preserves the button's original tap functionality.
60
-
- Cons: You lose the button's original hold function; holding and dragging will now interact with the Kando menu instead.
64
+
-**Pros**: Preserves the button's original tap functionality.
65
+
-**Cons**: You lose the button's original hold function; holding and dragging will now interact with the Kando menu instead.
61
66
62
67
## Option 3: Combining Two Mouse Buttons
63
68
@@ -68,10 +73,10 @@ Triggered by holding one mouse button and tapping another. The following example
68
73
# Target: keyboard + mouse
69
74
if_tap( key( BTN_RIGHT ), hold( KEY_LEFTCTRL ))
70
75
71
-
# Mouse Button RIGHT + Mouse Button LEFT
76
+
# Mouse Button LEFT
72
77
# Target: keyboard
73
78
KEY_LEFTCTRL + KEY_LEFTSHIFT + KEY_F1
74
79
```
75
80
76
-
- Pros: Allows you to hold Right Click and tap Left Click multiple times to quickly toggle between menus assigned to the same shortcut.
77
-
- Cons: You lose the button's original hold function; holding and dragging will now interact with the Kando menu instead.
81
+
-**Pros**: Allows you to hold Right Click and tap Left Click multiple times to quickly toggle between menus assigned to the same shortcut.
82
+
-**Cons**: You lose the button's original hold function; holding and dragging will now interact with the Kando menu instead.
0 commit comments