This is a fork of that replaces pango with for font rendering. Note: do not use the master branch; use one of the fontconfig branches
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

120 lines
3.3 KiB

swaymsg - Send messages to a running instance of sway over the IPC socket.
_swaymsg_ [options...] [message]
*-h, --help*
Show help message and quit.
*-m, --monitor*
Monitor for responses until killed instead of exiting after the first
response. This can only be used with the IPC message type _subscribe_. If
there is a malformed response or an invalid event type was requested,
swaymsg will stop monitoring and exit.
*-p, --pretty*
Use pretty output even when not using a tty.
*-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.
The message is a sway command (the same commands you can bind to keybindings
in your sway config file). It will be executed immediately.
See *sway*(5) for a list of commands.
- Command expansion is performed twice: once by swaymsg, and again by sway.
If you have quoted multi-word strings in your command, enclose the entire
command in single-quotes. For example, use
_swaymsg 'output "Foobar Display" enable'_ instead of
_swaymsg output "Foobar Display" enable_. Furthermore, note that comma
separated options also count as multi-word strings, because commas can be
used to execute commands on the same line.
- If you are providing a command that contains a leading hyphen (_-_), insert
two hyphens (_--_) before the command to signal to swaymsg not to parse
anything beyond that point as an option. For example, use
_swaymsg -- mark --add test_ instead of _swaymsg mark --add test_.
Gets a JSON-encoded list of workspaces and their status.
Gets a JSON-encoded list of current inputs.
Gets a JSON-encoded list of current outputs.
Gets a JSON-encoded layout tree of all open windows, containers, outputs,
workspaces, and so on.
Gets a JSON-encoded list of all seats,
its properties and all assigned devices.
Get a JSON-encoded list of marks.
Get a JSON-encoded configuration for swaybar.
Get JSON-encoded version information for the running instance of sway.
Gets a JSON-encoded list of currently configured binding modes.
Gets JSON-encoded info about the current binding state.
Gets a JSON-encoded copy of the current configuration.
Sends a tick event to all subscribed clients.
Subscribe to a list of event types. The argument for this type should be
provided in the form of a valid JSON array. If any of the types are invalid
or if a valid JSON array is not provided, this will result in a failure.
swaymsg errors such as invalid syntax, unable to connect to the ipc socket
or unable to parse sway's reply
Sway returned an error when processing the command (ex. invalid command,
command failed, and invalid subscription request)
*sway*(5) *sway-bar*(5) *sway-input*(5) *sway-output*(5) *sway-ipc*(7)