2023-07-20 15:12:38 +02:00
|
|
|
# Configurable keybinds
|
2023-06-06 22:00:51 +02:00
|
|
|
|
|
|
|
spmenu has since version 1.0 supported configuring keybinds and mouse binds
|
2023-06-20 10:37:55 +02:00
|
|
|
through a config file. The default config file *should* have the default
|
|
|
|
keybinds already.
|
2023-06-06 22:00:51 +02:00
|
|
|
|
2023-07-20 04:24:06 +02:00
|
|
|
## List of valid modes
|
2023-06-06 22:00:51 +02:00
|
|
|
|
2023-07-20 04:24:06 +02:00
|
|
|
NOTE: Can be used with keybinds.
|
2023-06-06 22:00:51 +02:00
|
|
|
|
|
|
|
- `-1`
|
|
|
|
- Any mode
|
|
|
|
- `0`
|
|
|
|
- Normal mode
|
|
|
|
- `1`
|
|
|
|
- Insert mode
|
|
|
|
|
2023-07-20 04:24:06 +02:00
|
|
|
## List of valid clicks
|
2023-06-06 22:00:51 +02:00
|
|
|
|
2023-07-20 04:24:06 +02:00
|
|
|
NOTE: Can be used with mouse binds.
|
2023-06-06 22:00:51 +02:00
|
|
|
|
|
|
|
- `ClickWindow`
|
|
|
|
- Clicking on the spmenu window
|
|
|
|
- `ClickPrompt`
|
|
|
|
- Clicking on the prompt
|
|
|
|
- `ClickInput`
|
|
|
|
- Clicking on the input
|
|
|
|
- `ClickLArrow`
|
|
|
|
- Clicking on the left arrow
|
|
|
|
- `ClickRArrow`
|
|
|
|
- Clicking on the right arrow
|
|
|
|
- `ClickItem`
|
|
|
|
- Clicking on the item area
|
2023-07-04 16:40:05 +02:00
|
|
|
- `ClickImage`
|
|
|
|
- Clicking on an image
|
2023-06-06 22:00:51 +02:00
|
|
|
- `ClickNumber`
|
|
|
|
- Clicking on the match count indicator
|
|
|
|
- `ClickCaps`
|
|
|
|
- Clicking on the caps lock indicator
|
|
|
|
- `ClickMode`
|
|
|
|
- Clicking on the mode indicator
|
2023-07-14 21:32:37 +02:00
|
|
|
- `None`
|
|
|
|
- Any click
|
2023-06-06 22:00:51 +02:00
|
|
|
|
2023-07-20 04:24:06 +02:00
|
|
|
## List of valid modifiers
|
2023-06-06 22:00:51 +02:00
|
|
|
|
2023-07-20 04:24:06 +02:00
|
|
|
NOTE: Can be used with keybinds.
|
2023-06-06 22:00:51 +02:00
|
|
|
|
|
|
|
- `Ctrl`
|
|
|
|
- `Shift`
|
|
|
|
- `Super`
|
|
|
|
- `Alt`
|
|
|
|
- `None`
|
2023-05-09 19:37:40 +02:00
|
|
|
|
2023-07-20 04:24:06 +02:00
|
|
|
These can be combined by using '+' as a separator (ie. Ctrl+Shift)
|
2023-05-09 19:37:40 +02:00
|
|
|
|
2023-07-20 04:24:06 +02:00
|
|
|
## List of valid buttons
|
2023-06-06 22:00:51 +02:00
|
|
|
|
2023-07-20 04:24:06 +02:00
|
|
|
NOTE: Can be used with mouse binds
|
2023-05-09 19:37:40 +02:00
|
|
|
|
|
|
|
- Left Click
|
|
|
|
- Middle Click
|
|
|
|
- Right Click
|
|
|
|
- Scroll Up
|
|
|
|
- Scroll Down
|
|
|
|
|
2023-07-20 04:24:06 +02:00
|
|
|
## List of valid functions
|
2023-05-09 19:37:40 +02:00
|
|
|
|
2023-07-20 04:24:06 +02:00
|
|
|
NOTE: Can be used with keybinds and mouse binds.
|
2023-05-09 19:37:40 +02:00
|
|
|
|
2023-06-06 22:00:51 +02:00
|
|
|
- `moveup`
|
2023-07-20 04:24:06 +02:00
|
|
|
- Move up by MAX(passed argument, 1)
|
2023-06-06 22:00:51 +02:00
|
|
|
- `movedown`
|
2023-07-20 04:24:06 +02:00
|
|
|
- Move down by MAX(passed argument, 1)
|
2023-06-06 22:00:51 +02:00
|
|
|
- `moveleft`
|
2023-07-20 04:24:06 +02:00
|
|
|
- Move left by MAX(passed argument, 1)
|
2023-06-06 22:00:51 +02:00
|
|
|
- `moveright`
|
2023-07-20 04:24:06 +02:00
|
|
|
- Move right by MAX(passed argument, 1)
|
2023-06-06 22:00:51 +02:00
|
|
|
- `movestart`
|
2023-07-20 04:24:06 +02:00
|
|
|
- Move to the first item
|
|
|
|
- `moveend`
|
|
|
|
- Move to the last item
|
2023-06-06 22:00:51 +02:00
|
|
|
- `movenext`
|
2023-07-20 04:24:06 +02:00
|
|
|
- Move to the next page
|
2023-06-06 22:00:51 +02:00
|
|
|
- `moveprev`
|
2023-07-20 04:24:06 +02:00
|
|
|
- Move to the previous page
|
2023-06-06 22:00:51 +02:00
|
|
|
- `moveitem`
|
2023-07-20 04:24:06 +02:00
|
|
|
- Move to item passed argument
|
2023-06-06 22:00:51 +02:00
|
|
|
- `paste`
|
2023-07-20 04:24:06 +02:00
|
|
|
- Paste from clipboard, 0 means clipboard selection, 1 means primary selection
|
2023-06-06 22:00:51 +02:00
|
|
|
- `restoresel`
|
2023-07-20 04:24:06 +02:00
|
|
|
- Move back to the first item
|
2023-06-06 22:00:51 +02:00
|
|
|
- `clear`
|
2023-07-20 04:24:06 +02:00
|
|
|
- Clear input
|
2023-06-06 22:00:51 +02:00
|
|
|
- `clearins`
|
2023-07-20 04:24:06 +02:00
|
|
|
- Clear input text and switch to insert mode
|
2023-06-06 22:00:51 +02:00
|
|
|
- `viewhist`
|
2023-07-20 04:24:06 +02:00
|
|
|
- Toggle history and item buffer
|
2023-06-06 22:00:51 +02:00
|
|
|
- `moveword`
|
2023-07-20 04:24:06 +02:00
|
|
|
- Navigate through input text by 1 word, -1 means start, +1 means end
|
2023-06-06 22:00:51 +02:00
|
|
|
- `deleteword`
|
2023-07-20 04:24:06 +02:00
|
|
|
- Delete input text by 1 word
|
2023-06-06 22:00:51 +02:00
|
|
|
- `movecursor`
|
2023-07-20 04:24:06 +02:00
|
|
|
- Move cursor (caret) by MAX(passed argument, 1)
|
2023-06-06 22:00:51 +02:00
|
|
|
- `navhistory`
|
2023-07-20 04:24:06 +02:00
|
|
|
- Navigate through history buffer, -1 means forward, +1 means backwards
|
2023-06-06 22:00:51 +02:00
|
|
|
- `backspace`
|
2023-07-20 04:24:06 +02:00
|
|
|
- Backspace 1 character from input text
|
2023-06-06 22:00:51 +02:00
|
|
|
- `selectitem`
|
2023-07-20 04:24:06 +02:00
|
|
|
- Select the current selected item
|
2023-06-06 22:00:51 +02:00
|
|
|
- `quit`
|
2023-07-20 04:24:06 +02:00
|
|
|
- Quit spmenu
|
2023-06-06 22:00:51 +02:00
|
|
|
- `complete`
|
2023-07-20 04:24:06 +02:00
|
|
|
- Tab complete the selected item
|
2023-06-06 22:00:51 +02:00
|
|
|
- `setimgsize`
|
2023-07-20 04:24:06 +02:00
|
|
|
- Set image size to passed argument
|
2023-06-06 22:00:51 +02:00
|
|
|
- `defaultimg`
|
2023-07-20 04:24:06 +02:00
|
|
|
- Reset image size to the default
|
|
|
|
- `toggleinput`
|
|
|
|
- Toggle input
|
|
|
|
- `togglelarrow`
|
|
|
|
- Toggle left arrow
|
|
|
|
- `togglerarrow`
|
|
|
|
- Toggle right arrow
|
|
|
|
- `toggleitem`
|
|
|
|
- Toggle items
|
|
|
|
- `toggleprompt`
|
|
|
|
- Toggle prompt
|
|
|
|
- `togglecaps`
|
|
|
|
- Toggle caps lock indicator
|
|
|
|
- `togglepowerline`
|
|
|
|
- Toggle powerlines
|
|
|
|
- `togglecaret`
|
|
|
|
- Toggle caret (cursor)
|
|
|
|
- `togglehighlight`
|
|
|
|
- Toggle highlighting
|
|
|
|
- `togglematchcount`
|
|
|
|
- Toggle match count
|
|
|
|
- `togglemode`
|
|
|
|
- Toggle mode
|
|
|
|
- `toggleregex`
|
|
|
|
- Toggle regex mode
|
2023-07-22 19:12:36 +02:00
|
|
|
- `togglefuzzy`
|
|
|
|
- Toggle fuzzy matching
|
2023-07-20 04:24:06 +02:00
|
|
|
- `toggleimg`
|
|
|
|
- Toggle images
|
2023-06-06 22:00:51 +02:00
|
|
|
- `flipimg`
|
2023-07-20 04:24:06 +02:00
|
|
|
- Flip image, 0 means vertically, 1 means horizontally
|
2023-06-06 22:00:51 +02:00
|
|
|
- `setimgpos`
|
2023-07-20 04:24:06 +02:00
|
|
|
- Move to the next image position
|
2023-06-06 22:00:51 +02:00
|
|
|
- `setimggaps`
|
2023-07-20 04:24:06 +02:00
|
|
|
- Set image gaps to passed argument
|
2023-06-06 22:00:51 +02:00
|
|
|
- `setlines`
|
2023-07-20 04:24:06 +02:00
|
|
|
- Set lines to passed argument
|
2023-06-06 22:00:51 +02:00
|
|
|
- `setcolumns`
|
2023-07-20 04:24:06 +02:00
|
|
|
- Set columns to passed argument
|
|
|
|
- `setlineheight`
|
|
|
|
- Set line height to passed argument
|
2023-06-06 22:00:51 +02:00
|
|
|
- `setprofile`
|
2023-07-20 04:24:06 +02:00
|
|
|
- Open profile menu if available
|
2023-06-06 22:00:51 +02:00
|
|
|
- `switchmode`
|
2023-07-20 04:24:06 +02:00
|
|
|
- Switch between Normal mode and Insert mode
|
|
|
|
- `selecthover`
|
2023-07-25 00:28:39 +02:00
|
|
|
- Select/output the item clicked on
|
|
|
|
- `outputhover`
|
2023-07-20 04:24:06 +02:00
|
|
|
- Output the item clicked on
|
2023-07-25 00:20:43 +02:00
|
|
|
- `markhover`
|
|
|
|
- Mark the item clicked on
|
2023-06-30 08:18:25 +02:00
|
|
|
- `screenshot`
|
2023-07-20 04:24:06 +02:00
|
|
|
- Take a screenshot of spmenu
|
2023-05-09 19:37:40 +02:00
|
|
|
|
2023-07-20 04:24:06 +02:00
|
|
|
## List of valid arguments
|
2023-05-09 19:37:40 +02:00
|
|
|
|
2023-07-20 04:24:06 +02:00
|
|
|
NOTE: Can be used with both keybinds and mouse binds.
|
2023-05-09 19:37:40 +02:00
|
|
|
|
2023-06-06 22:00:51 +02:00
|
|
|
- `0`
|
|
|
|
- `1` through `100`
|
|
|
|
- `+1` through `+100`
|
|
|
|
- `-1` through `-100`
|
2023-05-09 19:37:40 +02:00
|
|
|
|
2023-07-20 04:24:06 +02:00
|
|
|
Please note that all functions will not accept
|
|
|
|
all of these or use them properly.
|
|
|
|
See 'List of valid functions' for more information.
|
|
|
|
|
|
|
|
## List of valid keys
|
2023-05-09 19:37:40 +02:00
|
|
|
|
2023-07-20 04:24:06 +02:00
|
|
|
NOTE: Can be used with keybinds.
|
2023-06-06 22:00:51 +02:00
|
|
|
|
|
|
|
- `None`
|
|
|
|
- `Space`
|
|
|
|
- `Enter`
|
|
|
|
- `Tab`
|
|
|
|
- `a`
|
|
|
|
- `b`
|
|
|
|
- `c`
|
|
|
|
- `d`
|
|
|
|
- `e`
|
|
|
|
- `f`
|
|
|
|
- `g`
|
|
|
|
- `h`
|
|
|
|
- `i`
|
|
|
|
- `j`
|
|
|
|
- `k`
|
|
|
|
- `l`
|
|
|
|
- `m`
|
|
|
|
- `n`
|
|
|
|
- `o`
|
|
|
|
- `p`
|
|
|
|
- `q`
|
|
|
|
- `r`
|
|
|
|
- `s`
|
|
|
|
- `t`
|
|
|
|
- `u`
|
|
|
|
- `v`
|
|
|
|
- `w`
|
|
|
|
- `x`
|
|
|
|
- `y`
|
|
|
|
- `z`
|
|
|
|
- `0`
|
|
|
|
- `1`
|
|
|
|
- `2`
|
|
|
|
- `3`
|
|
|
|
- `4`
|
|
|
|
- `5`
|
|
|
|
- `6`
|
|
|
|
- `7`
|
|
|
|
- `8`
|
|
|
|
- `9`
|
|
|
|
- `!`
|
|
|
|
- `"`
|
|
|
|
- `#`
|
|
|
|
- `$`
|
|
|
|
- `%`
|
|
|
|
- `&`
|
|
|
|
- `'`
|
|
|
|
- `(`
|
|
|
|
- `)`
|
|
|
|
- `*`
|
|
|
|
- `+`
|
|
|
|
- `,`
|
|
|
|
- `-`
|
|
|
|
- `.`
|
|
|
|
- `/`
|
|
|
|
- `:`
|
|
|
|
- `;`
|
|
|
|
- `<`
|
|
|
|
- `=`
|
|
|
|
- `>`
|
|
|
|
- `?`
|
|
|
|
- `@`
|
|
|
|
- `[`
|
|
|
|
- `\\`
|
|
|
|
- `]`
|
|
|
|
- `_`
|
|
|
|
- `grave`
|
|
|
|
- `{`
|
|
|
|
- `bar`
|
|
|
|
- `}`
|
|
|
|
- `~`
|
|
|
|
- `F1`
|
|
|
|
- `F2`
|
|
|
|
- `F3`
|
|
|
|
- `F4`
|
|
|
|
- `F5`
|
|
|
|
- `F6`
|
|
|
|
- `F7`
|
|
|
|
- `F8`
|
|
|
|
- `F9`
|
|
|
|
- `F10`
|
|
|
|
- `F11`
|
|
|
|
- `F12`
|
|
|
|
- `PageUp`
|
|
|
|
- `PageDown`
|
|
|
|
- `Home`
|
|
|
|
- `End`
|
|
|
|
- `Delete`
|
|
|
|
- `PrintScr`
|
|
|
|
- `Esc`
|
|
|
|
- `Pause`
|
|
|
|
- `ScrollLock`
|
|
|
|
- `Backspace`
|
|
|
|
- `Up`
|
|
|
|
- `Down`
|
|
|
|
- `Left`
|
|
|
|
- `Right`
|
|
|
|
- `Next`
|
|
|
|
- `Prior`
|
2023-07-20 04:24:06 +02:00
|
|
|
|
|
|
|
If the key is **not** listed here, it may still work.
|
|
|
|
If it does not, please file a bug report.
|
|
|
|
|
|
|
|
## See also
|
|
|
|
|
|
|
|
- [[spmenu.conf documentation]]
|
|
|
|
- [[binds.conf documentation]]
|
|
|
|
- spmenu(1)
|
|
|
|
|