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
+26-14Lines changed: 26 additions & 14 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: Input Remapper
6
6
description: A guide on how to use Input Remapper to open Kando menus with mouse buttons.
7
7
---
8
8
@@ -16,52 +16,64 @@ 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
+
**Input Remapper** is a Linux-only tool which allows you to remap mouse or controller buttons to keyboard shortcuts.
23
+
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.
24
+
25
+
Get Input Remapper from GitHub: https://github.com/sezanzeb/input-remapper
24
26
25
-
Input Remapper on GitHub: https://github.com/sezanzeb/input-remapper
27
+
You can visit the repository to learn about installation and general usage.
28
+
This guide here will focus specifically on how to work with Kando.
26
29
27
-
You can visit the repository to learn about installation and general usage. This article will focus specifically on how to work with Kando.
<center><sup>You can choose which button (on the left) should trigger which actions (on the right).</sup></center>
28
32
29
33
# Configuration
30
34
31
-
There are three ways to trigger a Kando menu through Input Remapper.
35
+
In this guide, we will explore three ways to trigger a Kando menu through Input Remapper.
36
+
First, we will look at the simplest method of directly mapping a mouse button to a keyboard shortcut.
37
+
Then, we will explore how to trigger a menu with a long press of a mouse button while keeping the original function on tap.
38
+
Finally, we will see how to trigger a menu by holding one mouse button and tapping another.
32
39
33
40
<Asidetype="note"title="Note">
34
41
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
42
</Aside>
36
43
37
44
## Option 1: Direct Shortcut Mapping
38
45
39
-
This is the simplest method. Pressing a single mouse button triggers the Kando menu:
46
+
This is the simplest method.
47
+
Pressing a single mouse button triggers the Kando menu.
48
+
In the Input pane on the left, add a new mapping and record the mouse button you want to use.
49
+
In the output pane on the right, set the **type to "Key or Macro"** and the **target to "keyboard"** and type in the shortcut you want to use to trigger the Kando menu:
40
50
41
51
```yaml
42
-
# Any Mouse Button
43
-
# Target: keyboard
44
52
KEY_LEFTCTRL + KEY_LEFTSHIFT + KEY_F1
45
53
```
46
54
55
+
After applying the changes, pressing the mouse button will trigger the Kando menu assigned to `Ctrl+Shift+F1`.
56
+
47
57
-**Pros**: Fast response with zero latency; simple setup.
48
58
-**Cons**: The button loses its original function, only suitable for mice with extra buttons.
49
59
50
60
## Option 2: Long Press Mouse Button
51
61
52
-
A long press triggers the Kando menu, while a short press (tap) retains the button's original function. The following example uses the **Right Mouse Button**:
62
+
With the following configuration, a long press triggers the Kando menu, while a short press (tap) retains the button's original function.
63
+
The following example uses the **Right Mouse Button**.
64
+
65
+
First, bind the right mouse button in the Input pane on the left.
66
+
Then, in the output pane on the right, set the **type to "Key or Macro"** and the **target to "keyboard + mouse"** and use the following configuration:
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.
73
+
The number `150` at the end represents the duration required for a long press in milliseconds. You can adjust this value, but setting it too short may lead to accidental triggers.
62
74
</Aside>
63
75
64
-
-**Pros**: Preserves the button's original tap functionality.
76
+
-**Pros**: Preserves the button's original tap functionality, you can directly engage in Marking Mode by holding the button without the need for an additional mouse click.
65
77
-**Cons**: You lose the button's original hold function; holding and dragging will now interact with the Kando menu instead.
0 commit comments