Skip to content

Commit dd2eb46

Browse files
ClixTWSchneegans
authored andcommitted
📝 Add img & fix formatting
1 parent d6ed435 commit dd2eb46

2 files changed

Lines changed: 16 additions & 11 deletions

File tree

src/assets/img/input-remapper.png

78.2 KB
Loading

src/content/docs/input-remapper-tutorial.mdx

Lines changed: 16 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
# SPDX-FileCopyrightText: Simon Schneegans <code@simonschneegans.de>
33
# SPDX-License-Identifier: CC-BY-4.0
44

5-
title: Input-Remapper (Linux)
5+
title: Input Remapper (Linux)
66
description: A guide on how to use Input Remapper to open Kando menus with mouse buttons.
77
---
88

@@ -16,31 +16,36 @@ import Intro from '../../components/Intro.astro';
1616
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!
1717
</Intro>
1818

19+
![input-remapper](../../assets/img/input-remapper.png)
20+
1921
# Introduction
2022

2123
**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.
2224

2325
Input Remapper on GitHub: https://github.com/sezanzeb/input-remapper
26+
2427
You can visit the repository to learn about installation and general usage. This article will focus specifically on how to work with Kando.
2528

2629
# Configuration
2730

2831
There are three ways to trigger a Kando menu through Input Remapper.
2932

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+
<Aside type="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>
3136

3237
## Option 1: Direct Shortcut Mapping
3338

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:
3540

3641
```yaml
3742
# Any Mouse Button
3843
# Target: keyboard
3944
KEY_LEFTCTRL + KEY_LEFTSHIFT + KEY_F1
4045
```
4146

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.
4449

4550
## Option 2: Long Press Mouse Button
4651

@@ -52,12 +57,12 @@ A long press triggers the Kando menu, while a short press (tap) retains the butt
5257
if_tap( key( BTN_RIGHT ), modify( KEY_LEFTCTRL, modify( KEY_LEFTSHIFT, key (KEY_F1 ))).wait( 100 ).hold( KEY_LEFTCTRL ), 150 )
5358
```
5459

55-
<Aside type="note" title="Tips">
60+
<Aside type="tip" title="Tip">
5661
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.
5762
</Aside>
5863

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.
6166

6267
## Option 3: Combining Two Mouse Buttons
6368

@@ -68,10 +73,10 @@ Triggered by holding one mouse button and tapping another. The following example
6873
# Target: keyboard + mouse
6974
if_tap( key( BTN_RIGHT ), hold( KEY_LEFTCTRL ))
7075

71-
# Mouse Button RIGHT + Mouse Button LEFT
76+
# Mouse Button LEFT
7277
# Target: keyboard
7378
KEY_LEFTCTRL + KEY_LEFTSHIFT + KEY_F1
7479
```
7580

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

Comments
 (0)