Arch manual pages

SWAYMSG(1)   SWAYMSG(1)

NAME

swaymsg - Send messages to a running instance of sway over the IPC socket.

SYNOPSIS

swaymsg [options] [message]

OPTIONS

-h, --help
Show help message and quit.
-q, --quiet
Sends the IPC message but does not print the response from sway.
-r, --raw
Use raw output even if using a tty.
-s, --socket <path>
Use the specified socket path. Otherwise, swaymsg will ask sway where the socket is (which is the value of $SWAYSOCK, then of $I3SOCK).
-t, --type <type>
Specify the type of IPC message. See below.
-v, --version
Print the version (of swaymsg) and quit.

IPC MESSAGE TYPES

command
The message is a sway command (the same commands you can bind to keybindings in your sway config file). It will be executed immediately.
get_workspaces
Gets a JSON-encoded list of workspaces and their status.
get_inputs
Gets a JSON-encoded list of current inputs.
get_outputs
Gets a JSON-encoded list of current outputs.
get_tree
Gets a JSON-encoded layout tree of all open windows, containers, outputs, workspaces, and so on.
get_marks
Get a JSON-encoded list of marks.
get_bar_config
Get a JSON-encoded configuration for swaybar.
get_version
Get JSON-encoded version information for the running instance of sway.

AUTHORS

Maintained by Drew DeVault <sir@cmpwn.com>, who is assisted by other open source contributors. For more information about sway development, see https://github.com/SirCmpwn/sway.

SEE ALSO

sway(5)
07/27/2017