> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rekosk.dev/recircles/llms.txt
> Use this file to discover all available pages before exploring further.

# Keybindings

> Change the keys you use inside ReCircles. Look up every default binding, assign more than one shortcut to an action, and control numbered selection.

ReCircles reads keyboard shortcuts from `keybinds` in `recircles.json`. In **Settings → Keybinds**, choose an action to capture a combination or type one. Set the shortcut that launches ReCircles in your compositor.

## Set a binding

Each action accepts one string or an array of alternative combinations. Put the modifiers first and the GDK key name last. For example, this keeps **Down** and **Up** for navigation and adds **Ctrl+J** and **Ctrl+K**.

```json theme={null}
{
  "keybinds": {
    "next": ["Down", "Tab", "Ctrl+j"],
    "previous": ["Up", "Shift+Tab", "Ctrl+k"],
    "clear_query": "Ctrl+u"
  }
}
```

Setting a binding replaces the whole list for that action. Use `[]` to clear it. Modifiers include `Ctrl` (`Control`), `Shift`, `Alt` (`Mod1`), `Super` (`Win` or `Mod4`), and `Meta`. Common key names include `Return`, `Escape`, `Page_Down`, and `KP_Enter`.

## Default bindings

| Key | Default combinations | Action |
| - | - | - |
| `back` | `Escape` | Step back through navigation or close the outermost menu. |
| `home` | `Shift+Escape` | Return to the main ring. From the main ring or a direct `--run` session, close the launcher. |
| `activate` | `Return`, `KP_Enter` | Activate the selected or first result. |
| `secondary_activate` | `Shift+Return`, `Shift+KP_Enter` | Invoke the selected item's secondary action. |
| `open_current_folder` | `Alt+Return`, `Alt+KP_Enter` | Open the current folder in Files. |
| `next` | `Down`, `Tab` | Select the next item. |
| `previous` | `Up`, `Shift+Tab` | Select the previous item. |
| `page_next` | `Page_Down` | Move forward a page. |
| `page_previous` | `Page_Up` | Move back a page. |
| `accept_completion` | `Right`, `KP_Right` | Accept a suggested completion at the end of the query. |
| `undo_completion` | `Left`, `KP_Left` | Undo a completion or move to the parent path while browsing Files. |
| `clear_query` | `Ctrl+u` | Clear the search or input field. |
| `number_shortcuts` | `true` | Enable the numbered shortcuts below. Set `false` to turn them off. |

## Numbered selection

Keys **1–8** select visible positions when the launcher is accepting shortcuts. In the grid, count from the left of the first visible row. **Enter** activates the selection. **Ctrl+number** activates it directly, and **Ctrl+Shift+number** invokes its secondary action.

In a text-input box, you can type digits normally. With number shortcuts enabled, **Ctrl+1** or **Alt+1** submits the value, and **Ctrl+2** or **Alt+2** cancels.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.