Skip to main content
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.
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

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.