mirror of
https://github.com/hyprwm/Hyprland
synced 2024-11-10 11:25:59 +01:00
145 lines
2.4 KiB
Groff
145 lines
2.4 KiB
Groff
.\" Automatically generated by Pandoc 2.5
|
|
.\"
|
|
.TH "hyprctl" "1" "21 Aug 2022" "" "hyprctl User Manual"
|
|
.hy
|
|
.SH NAME
|
|
.PP
|
|
hyprctl \- Utility for controlling parts of Hyprland from a CLI or a
|
|
script
|
|
.SH SYNOPSIS
|
|
.PP
|
|
\f[B]hyprctl\f[R] [\f[I](opt)flags\f[R]] [\f[B]command\f[R]]
|
|
[\f[I](opt)args\f[R]]
|
|
.SH DESCRIPTION
|
|
.PP
|
|
\f[B]hyprctl\f[R] is a utility for controlling some parts of the
|
|
compositor from a CLI or a script.
|
|
.SH CONTROL COMMANDS
|
|
.PP
|
|
\f[B]dispatch\f[R]
|
|
.RS
|
|
.PP
|
|
Call a dispatcher with an argument.
|
|
.PP
|
|
An argument must be present.
|
|
For dispatchers without parameters it can be anything.
|
|
.PP
|
|
Returns: \f[I]ok\f[R] on success, and an error message on failure.
|
|
.TP
|
|
.B Examples:
|
|
\f[B]hyprctl\f[R] \f[I]dispatch exec kitty\f[R]
|
|
.RS
|
|
.PP
|
|
\f[B]hyprctl\f[R] \f[I]dispatch pseudo x\f[R]
|
|
.RE
|
|
.RE
|
|
.PP
|
|
\f[B]keyword\f[R]
|
|
.RS
|
|
.PP
|
|
Set a config keyword dynamically.
|
|
.PP
|
|
Returns: \f[I]ok\f[R] on success, and an error message on failure.
|
|
.TP
|
|
.B Examples:
|
|
\f[B]hyprctl\f[R] \f[I]keyword bind SUPER,0,pseudo\f[R]
|
|
.RS
|
|
.PP
|
|
\f[B]hyprctl\f[R] \f[I]keyword general:border_size 10\f[R]
|
|
.RE
|
|
.RE
|
|
.PP
|
|
\f[B]reload\f[R]
|
|
.RS
|
|
.PP
|
|
Force a reload of the config file.
|
|
.RE
|
|
.PP
|
|
\f[B]kill\f[R]
|
|
.RS
|
|
.PP
|
|
Enter kill mode, where you can kill an app by clicking on it.
|
|
You can exit by pressing ESCAPE.
|
|
.RE
|
|
.SH INFO COMMANDS
|
|
.PP
|
|
\f[B]version\f[R]
|
|
.RS
|
|
.PP
|
|
Prints the Hyprland version, flags, commit and branch of build.
|
|
.RE
|
|
.PP
|
|
\f[B]monitors\f[R]
|
|
.RS
|
|
.PP
|
|
Lists all the outputs with their properties.
|
|
.RE
|
|
.PP
|
|
\f[B]workspaces\f[R]
|
|
.RS
|
|
.PP
|
|
Lists all workspaces with their properties.
|
|
.RE
|
|
.PP
|
|
\f[B]clients\f[R]
|
|
.RS
|
|
.PP
|
|
Lists all windows with their properties.
|
|
.RE
|
|
.PP
|
|
\f[B]devices\f[R]
|
|
.RS
|
|
.PP
|
|
Lists all connected input devices.
|
|
.RE
|
|
.PP
|
|
\f[B]activewindow\f[R]
|
|
.RS
|
|
.PP
|
|
Returns the active window name.
|
|
.RE
|
|
.PP
|
|
\f[B]layers\f[R]
|
|
.RS
|
|
.PP
|
|
Lists all the layers.
|
|
.RE
|
|
.PP
|
|
\f[B]splash\f[R]
|
|
.RS
|
|
.PP
|
|
Returns the current random splash.
|
|
.RE
|
|
.SH OPTIONS
|
|
.PP
|
|
\f[B]\-\-batch\f[R]
|
|
.RS
|
|
.PP
|
|
Specify a batch of commands to execute.
|
|
.TP
|
|
.B Example:
|
|
\f[B]hyprctl\f[R] \f[I]\-\-batch \[dq]keyword general:border_size 2 ;
|
|
keyword general:gaps_out 20\[dq]\f[R]
|
|
.RS
|
|
.PP
|
|
\f[I];\f[R] separates the commands.
|
|
.RE
|
|
.RE
|
|
.PP
|
|
\f[B]\-j\f[R]
|
|
.RS
|
|
.PP
|
|
Outputs information in JSON.
|
|
.RE
|
|
.SH BUGS
|
|
.TP
|
|
.B Submit bug reports and request features online at:
|
|
<\f[I]https://github.com/hyprwm/Hyprland/issues\f[R]>
|
|
.SH SEE ALSO
|
|
.PP
|
|
Sources at: <\f[I]https://github.com/hyprwm/Hyprland\f[R]>
|
|
.SH COPYRIGHT
|
|
.PP
|
|
Copyright (c) 2022, vaxerski
|
|
.SH AUTHORS
|
|
Vaxerski <\f[I]https://github.com/vaxerski\f[R]>.
|