Default Right Joycon Configuration
This page describes the included right joycon configurations found in the configs/right_joycon/ folder. Note that to use joycons, you must install dkms-hid-nintendo as well as joycond.
This describes the shorthand button names used in the mapping descriptions below.
| Alias | Description |
|---|---|
| A | A button |
| B | B button |
| X | X button |
| Y | Y button |
| R | Shoulder Right |
| ZR | Trigger Right |
| Plus | Plus button |
| Home | Home button |
| RSU | Right stick up |
| RSR | Right stick right |
| RSL | Right stick left |
| RSD | Right stick down |
| RSC | Right stick click |
The SL and SR buttons were deemed too awkward to use and are intentionally left out.
Since there's a very limited set of input combinations that can be created using just one joycon, multiple configuration files are used to allow for different actions to be mapped to the same input, depending on the currently loaded configuration file. Each configuration file represents a different "mode" the joycon can be in, with 5 distinct modes:
- Blank - The recommended launch configuration file. It has no output actions, except for switching between other modes.
- Mouse - Controls the mouse, including clicking, right-clicking, and dragging.
- Letters - Outputs keys used for writing words, as well as some symbols typically found in writing.
- Symbols - Outputs keys used for numbers and less common symbols.
- Shortcuts - A few shortcuts useful for playing media.
All modes include the following linking inputs:
| Output | Input |
|---|---|
| Switch to Blank | Plus |
| Switch to Mouse | B |
| Switch to Letters | A |
| Switch to Symbols | X |
| Switch to Shortcuts | Y |
All modes except for blank also include the following modifier inputs:
| Output | Input |
|---|---|
| Toggle Ctrl | X + Y |
| Toggle Super | X + A |
| Toggle Alt | B + Y |
| Toggle Shift | B + A |
| Unset Modifiers | X + B + Y + A |
Since these are toggle actions, they'll keep the modifiers pressed until their chords are inputted again, or until the chord for "Unset modifiers" is inputted.
The main input modes (Letters, Symbols, and Shortcuts) also include a button that allows you to hold down the previously outputted chord.
| Output | Input |
|---|---|
| RepeatLastChord | Home |
This makes it easy to do something like hold down backspace, by inputting the chord for backspace once then holding this button down.
This mode allows the joycon to control the mouse. All clicking inputs are chords -- they only emit actions when one of their buttons is released. A click indicated by (pulse) means that it will "tap" the click button, whereas a click indicated by (toggle) means that it will "hold" the click button until that chord is inputted again.
| Output | Input |
|---|---|
| Mouse movement | Right analog stick |
| Left click (pulse) | RSC |
| Left click (toggle) | ZR + RSC |
| Right click (pulse) | R + RSC |
| Right click (toggle) | ZR + R + RSC |
This mode allows for the joycon to output letters as well as useful writing symbols.
| Output | Input |
|---|---|
| a | ZR + RSR |
| b | R + RSL |
| c | ZR + RSU + RSR |
| d | ZR + RSD |
| e | R + RSU |
| f | RSR + RSD |
| g | RSL + RSU |
| h | RSL |
| i | ZR + RSL |
| j | RSD |
| k | RSU |
| l | RSR |
| m | ZR + R + RSR |
| n | RSD + RSL |
| o | R + RSD |
| p | R + RSD + RSR |
| q | ZR + RSU + RSL |
| r | ZR + RSD + RSL |
| s | ZR + RSD + RSR |
| t | RSU + RSR |
| u | ZR + RSU |
| v | ZR + R + RSL |
| w | R + RSR |
| x | R + RSU + RSL |
| y | R + RSD + RSL |
| z | R + RSU + RSR |
| Space | RSC |
| Backspace | ZR + RSC |
| Enter | R + RSC |
| . | ZR + R + RSU |
| , | ZR + R + RSD |
| ' | ZR + R + RSD + RSR |
| Esc | ZR + R + RSC |
| / | ZR + R + RSU + RSL |
| Tab | ZR + R + RSU + RSR |
| ; | RL + R + RSD + RSL |
This mode allows for the joycon to output numbers as well as less common symbols.
| Output | Input |
|---|---|
| 0 | R + RSC |
| 1 | RSU |
| 2 | RSU + RSR |
| 3 | RSR |
| 4 | RSD + RSR |
| 5 | RSD |
| 6 | RSD + RSL |
| 7 | RSL |
| 8 | RSU + RSL |
| 9 | RSC |
| ! | ZR + R + RSD |
| @ | ZR + RSU + RSR |
| # | ZR + R + RSU + RSR |
| $ | ZR + RSD + RSR |
| % | ZR + R + RSD + RSR |
| ^ | ZR + RSD + RSL |
| & | ZR + R + RSD + RSL |
| * | ZR + RSU + RSL |
| ( | R + RSL |
| ) | R + RSR |
| - | R + RSD |
| = | ZR + R + RSR |
| _ | ZR + R + RSU + RSL |
| + | R + RSU |
| [ | R + RSU + RSL |
| ] | R + RSU + RSR |
| { | R + RSD + RSL |
| } | R + RSD + RSR |
| \ | ZR + RSC |
| | | ZR + R + RSU |
| ~ | ZR + R + RSL |
| ` | ZR + R + RSC |
| Up arrow | ZR + RSU |
| Down arrow | ZR + RSD |
| Left arrow | ZR + RSL |
| Right arrow | ZR + RSR |
A few shortcuts useful for playing media.
| Output | Input |
|---|---|
| Volume up | RSU |
| Volume down | RSD |
| Play/Pause | RSC |
| Next Song | R + RSR |
| Previous Song | R + RSL |