hyprctl

hyprctl [command] [arguments]

hyprctl is the command-line control utility for Hyprland, a dynamic tiling Wayland compositor. It provides runtime control over window management, configuration, and system queries.
Dispatchers control actions like moving windows, changing workspaces, and executing programs. Common dispatchers include: exec, killactive, workspace, movewindow, fullscreen, togglefloating.
Configuration changes made with keyword are temporary and reset on reload. For persistent changes, edit the config file.

reload

Reload Hyprland configuration

Show active window information

List input devices

List workspaces

List monitors and properties

List all windows/clients

Execute a dispatcher (window actions, workspace changes)

Set configuration option at runtime

Set cursor theme and size

Switch keyboard layout

Execute multiple commands separated by semicolons

Output in JSON format

Only works when Hyprland is running. Some commands require appropriate permissions. Changes via keyword don't persist across restarts or reloads.

hyprctl is part of the Hyprland project, a modern Wayland compositor created by Vaxry. Hyprland gained popularity starting in 2022 for its smooth animations, dynamic tiling, and extensive customization options.

hyprpaper(1), hyprshot(1), swaymsg(1)