X-Git-Url: https://git.sur5r.net/?a=blobdiff_plain;f=man%2Fi3-msg.man;h=625131de5855f16cac7b4fc10aeef881c5ef656f;hb=a84b30f8a995c38aa88b3333703595e052d650ab;hp=891c6c283dd7ab17fa6db541f5a1007e96865361;hpb=4fe974408da75a3aa45fcd5eabaadaa034845c1b;p=i3%2Fi3 diff --git a/man/i3-msg.man b/man/i3-msg.man index 891c6c28..625131de 100644 --- a/man/i3-msg.man +++ b/man/i3-msg.man @@ -1,7 +1,7 @@ i3-msg(1) ========= -Michael Stapelberg -v4.2, January 2012 +Michael Stapelberg +v4.2, August 2012 == NAME @@ -9,7 +9,35 @@ i3-msg - send messages to i3 window manager == SYNOPSIS -i3-msg [-t type] [message] +i3-msg [-q] [-v] [-h] [-s socket] [-t type] [message] + +== OPTIONS + +*-q, --quiet*:: +Only send ipc message and suppress the output of the response. + +*-v, --version*:: +Display version number and exit. + +*-h, --help*:: +Display a short help-message and exit. + +*-s, --socket* 'sock_path':: +i3-msg will use the environment variable I3SOCK or the socket path +given here. If both fail, it will try to get the socket information +from the root window and then try /tmp/i3-ipc.sock before exiting +with an error. + +*-t* 'type':: +Send ipc message, see below. This option defaults to "command". + +*-m*, *--monitor*:: +Instead of exiting right after receiving the first subscribed event, +wait indefinitely for all of them. Can only be used with "-t subscribe". +See the "subscribe" IPC message type below for details. + +*message*:: +Send ipc message, see below. == IPC MESSAGE TYPES @@ -24,7 +52,8 @@ workspaces. get_outputs:: Gets the current outputs. The reply will be a JSON-encoded list of outputs (see -the reply section). +the reply section of docs/ipc, e.g. at +https://i3wm.org/docs/ipc.html#_receiving_replies_from_i3). get_tree:: Gets the layout tree. i3 uses a tree as data structure which includes every @@ -38,6 +67,23 @@ get_bar_config:: Gets the configuration (as JSON map) of the workspace bar with the given ID. If no ID is provided, an array with all configured bar IDs is returned instead. +get_binding_modes:: +Gets a list of configured binding modes. + +get_version:: +Gets the version of i3. The reply will be a JSON-encoded dictionary with the +major, minor, patch and human-readable version. + +get_config:: +Gets the currently loaded i3 configuration. + +send_tick:: +Sends a tick to all IPC connections which subscribe to tick events. + +subscribe:: +The payload of the message describes the events to subscribe to. +Upon reception, each event will be dumped as a JSON-encoded object. +See the -m option for continuous monitoring. == DESCRIPTION @@ -55,6 +101,9 @@ i3-msg border normal # Dump the layout tree i3-msg -t get_tree + +# Monitor window changes +i3-msg -t subscribe -m '[ "window" ]' ------------------------------------------------ == ENVIRONMENT @@ -62,7 +111,7 @@ i3-msg -t get_tree === I3SOCK If no ipc-socket is specified on the commandline, this variable is used -to determine the path, at wich the unix domain socket is expected, on which +to determine the path, at which the unix domain socket is expected, on which to connect to i3. == SEE ALSO