2 * vim:ts=4:sw=4:expandtab
4 * i3 - an improved dynamic tiling window manager
5 * © 2009-2010 Michael Stapelberg and contributors (see also: LICENSE)
7 * This public header defines the different constants and message types to use
8 * for the IPC interface to i3 (see docs/ipc for more information).
15 * Messages from clients to i3
19 /** Never change this, only on major IPC breakage (don’t do that) */
20 #define I3_IPC_MAGIC "i3-ipc"
22 /** The payload of the message will be interpreted as a command */
23 #define I3_IPC_MESSAGE_TYPE_COMMAND 0
25 /** Requests the current workspaces from i3 */
26 #define I3_IPC_MESSAGE_TYPE_GET_WORKSPACES 1
28 /** Subscribe to the specified events */
29 #define I3_IPC_MESSAGE_TYPE_SUBSCRIBE 2
31 /** Requests the current outputs from i3 */
32 #define I3_IPC_MESSAGE_TYPE_GET_OUTPUTS 3
34 /** Requests the tree layout from i3 */
35 #define I3_IPC_MESSAGE_TYPE_GET_TREE 4
37 /** Request the current defined marks from i3 */
38 #define I3_IPC_MESSAGE_TYPE_GET_MARKS 5
40 /** Request the configuration for a specific 'bar' */
41 #define I3_IPC_MESSAGE_TYPE_GET_BAR_CONFIG 6
44 * Messages from i3 to clients
48 /** Command reply type */
49 #define I3_IPC_REPLY_TYPE_COMMAND 0
51 /** Workspaces reply type */
52 #define I3_IPC_REPLY_TYPE_WORKSPACES 1
54 /** Subscription reply type */
55 #define I3_IPC_REPLY_TYPE_SUBSCRIBE 2
57 /** Outputs reply type */
58 #define I3_IPC_REPLY_TYPE_OUTPUTS 3
60 /** Tree reply type */
61 #define I3_IPC_REPLY_TYPE_TREE 4
63 /** Marks reply type */
64 #define I3_IPC_REPLY_TYPE_MARKS 5
66 /** Bar config reply type */
67 #define I3_IPC_REPLY_TYPE_BAR_CONFIG 6
70 * Events from i3 to clients. Events have the first bit set high.
73 #define I3_IPC_EVENT_MASK (1 << 31)
75 /* The workspace event will be triggered upon changes in the workspace list */
76 #define I3_IPC_EVENT_WORKSPACE (I3_IPC_EVENT_MASK | 0)
78 /* The output event will be triggered upon changes in the output list */
79 #define I3_IPC_EVENT_OUTPUT (I3_IPC_EVENT_MASK | 1)