RIVERCTL(1) General Commands Manual RIVERCTL(1) (NAME) riverctl - (river) (SYNOPSIS) riverctl [] command [ ] (DESCRIPTION) riverctl river (Wayland) . (OPTIONS) -h . -version . (TERMINOLOGY) . (compositor) (display server) (Wayland server) river . (view) ( toplevel) . (output) () . (Tags) river ( ) (workspaces) . (COMMANDS) (ACTIONS) close . exit . focus-output next|previous|up|right|down|left|name . focus-view [-skip-floating] next|previous|up|down|left|right . o -skip-floating: (tiled). move up|down|left|right delta delta . . resize horizontal|vertical delta delta . . snap up|down|left|right . . send-to-output [-current-tags] next|previous|up|right|down|left|name . o -current-tags: . spawn shell_command shell_command `/bin/sh -c shell_command`. spawn . . swap next|previous|up|down|left|right ( ) . toggle-float (/). toggle-fullscreen (/). zoom . . default-layout namespace (layout namespace) . output-layout namespace default-layout ( ) . send-layout-cmd namespace command command (layout generator) namespace . . rivertile rivertile(1) . (TAG MANAGEMENT) (workspaces) . . river (bitfields) . () . 000000001 100001101 . . . river . set-focused-tags tags tags . set-view-tags tags tags . toggle-focused-tags tags tags . toggle-view-tags tags tags . spawn-tagmask tagmask tagmask . AND . 000011111 tagmask 111110001 000010001 . tagmask . focus-previous-tags . send-to-previous-tags . (MAPPINGS) river (modal) . (mode) . : "normal" "locked". normal . locked ( ) . . (modifiers) : o Shift o Control o Mod1 (Alt) o Mod3 o Mod4 (Super) o Mod5 o None Alt Super Mod1 Mod4 . None . keysym XKB . /usr/include/xkbcommon/xkbcommon- keysyms.h . (Linux input event code) . : o BTN_LEFT - o BTN_RIGHT - o BTN_MIDDLE - /usr/include/linux/input-event-codes.h . declare-mode name name. enter-mode name . map [-release|-repeat|-layout index] mode modifiers key command command key modifiers mode . o -release: o -repeat: -release o -layout: . o index: keyboard-layout . -layout o mode: o modifiers: (+) . o key: keysym XKB o command: riverctl map-pointer mode modifiers button action|command command button modifiers mode . . o mode: o modifiers: (+). o button: o action: : o move-view o resize-view o command: riverctl map-switch mode lid|tablet state command command river . o mode: o lid|tablet: 'lid switch' ( ) 'tablet mode switch' ( ) o state: o lid: o close o open o tablet: o on o off o command: riverctl unmap [-release] mode modifiers key : o -release: o mode: o modifiers: (+). o key: keysym XKB unmap-pointer mode modifiers button : o mode: o modifiers: (+). o button: unmap-switch mode lid|tablet state : o mode: o lid|tablet: o state: (RULES) app-id (title) glob . glob * / . * glob app-id . abc a* *a* *b* *c abc * *a b* *b c* ab . * ** . rule-add [-app-id glob|-title glob] action [arguments] action app-id title glob . -app-id -title -app-id * -title * . arguments . action : o float: . . o no-float: . . o ssd: (server-side decorations) . . o csd: (client-side decorations) . . o tags: . . . o output: . . . ( HDMI-A-1 DP-2) MAKE MODEL SERIAL : HP Inc. : HP 22w : CNC93720WF : HP Inc. HP 22w CNC93720WF. "Unknown" . o position: . x y . . o dimensions: . . . o fullscreen: . . o no-fullscreen: . . o tearing: (tearing) . . o no-tearing: . . float no-float no-float float . ssd csd fullscreen no-fullscreen tearing no-tearing . () . app-id title action foo bar ssd foo * csd * bar csd * baz ssd app-id 'foo' 'bar' csd ssd . app-id 'foo' 'baz' csd app-id . river csd/ssd (heuristics) - . position dimensions . float . rule-del [-app-id glob|-title glob] action rule-add . list-rules float|ssd|tags|position|dimensions|fullscreen . . . (CONFIGURATION) default-attach-mode top|bottom|above|below|after (attach mode) . : o top: . o bottom: . o above: . o below: . o after : N . attach-mode default- attach-mode . output-attach-mode top|bottom|above|below|after default-attach-mode ( ) . allow-tearing enabled|disabled (tearing) . tearing . background-color 0xRRGGBB|0xRRGGBBAA . border-color-focused 0xRRGGBB|0xRRGGBBAA . border-color-unfocused 0xRRGGBB|0xRRGGBBAA . border-color-urgent 0xRRGGBB|0xRRGGBBAA (urgent). border-width pixels pixels. focus-follows-cursor disabled|normal|always : o disabled: . . o normal: . . o always: . . hide-cursor timeout timeout timeout . 0 . . hide-cursor when-typing enabled|disabled . . set-cursor-warp disabled|on-output-change|on-focus-change (cursor warp). : o disabled: . . o on-output-change: . o on-focus-change: / . set-repeat rate delay rate delay . . xcursor-theme theme_name [size] xcursor theme_name size. (seat) Xwayland XCURSOR_THEME XCURSOR_SIZE . (INPUT CONFIGURATION) list-inputs . list-input-configs . keyboard-layout [-rules rules] [-model model] [-variant variant] [-options options] layout XKB . libxkbcommon . layout ( "us,de") options ( -options "grp:ctrl_space_toggle") . xkeyboard-config(7) . keyboard-layout-file path XKB keymap . keymap XKB : https://xkbcommon.org/doc/current/keymap-text-format-v1.html input name . (name) (vendor id) (product id) (-) . (globbing) glob . . . input name events enabled|disabled|disabled-on-external-mouse river . input name accel-profile none|flat|adaptive (acceleration profile) . input name pointer-accel factor . -1.0 1.0 . input name click-method none|button-areas|clickfinger . input name drag enabled|disabled (tap-and-drag) . input name drag-lock enabled|disabled (drag lock) . input name disable-while-typing enabled|disabled . input name disable-while-trackpointing enabled|disabled (trackpoint) . input name middle-emulation enabled|disabled . input name natural-scroll enabled|disabled (natural scroll) . . input name scroll-factor factor . . factor 0.5 factor . input name left-handed enabled|disabled . input name tap enabled|disabled (tap) . input name tap-button-map left-right-middle|left-middle-right . o left-right-middle: . o left-middle-right: . input name scroll-method none|two-finger|edge|button . o none: o two-finger: o edge: o button: input name scroll-button button . button . input name scroll-button-lock enabled|disabled . . input name map-to-output output|disabled . . (EXAMPLES) Super+Return normal foot(1): riverctl map normal Mod4 Return spawn 'foot --app-id=foobar' Super+Shift+J : riverctl map normal Mod4+Shift J swap next (AUTHORS) Isaac Freund . river . (SEE ALSO) river(1), rivertile(1) 2026-05-07 RIVERCTL(1)