hyprctl(1)
Control and query the Hyprland wayland compositor from the command line.
Synopsis
hyprctl [COMMAND] [ARGS]Description
hyprctl is the primary interface for controlling Hyprland, a dynamic tiling Wayland compositor. It allows you to query workspace information, manage windows, toggle settings, reload configuration, and interact with various compositor features without restarting.
Commands communicate with the Hyprland daemon via a socket. Most operations return JSON-formatted output that can be parsed by scripts. Use hyprctl help to see all available commands.
Common options
| Flag | What it does |
|---|---|
-j, --json | Output response in JSON format for easier parsing by scripts |
-r, --raw | Return raw output without formatting |
-i INSTANCE_SIGNATURE | Target a specific Hyprland instance by signature |
--batch | Execute multiple commands in sequence, one per line |
Examples
List all connected monitors and their configurations
hyprctl monitorsDisplay all workspaces and their active status
hyprctl workspacesList all open windows with their properties
hyprctl clientsMove workspace 1 to monitor 0
hyprctl dispatch moveworkspacetomonitor 1 0Change keyboard layout to US on the fly
hyprctl keyword input:kb_layout usReload Hyprland configuration without restarting
hyprctl reloadToggle fullscreen for the active window
hyprctl dispatch fullscreen 1Query windows on workspace 1 in JSON and filter with jq
hyprctl -j clients | jq '.[] | select(.workspace.id==1)'