2 #define I3__FILE__ "manage.c"
4 * vim:ts=4:sw=4:expandtab
6 * i3 - an improved dynamic tiling window manager
7 * © 2009 Michael Stapelberg and contributors (see also: LICENSE)
9 * manage.c: Initially managing new windows (or existing ones on restart).
13 #include "yajl_utils.h"
15 #include <yajl/yajl_gen.h>
18 * Go through all existing windows (if the window manager is restarted) and manage them
21 void manage_existing_windows(xcb_window_t root) {
22 xcb_query_tree_reply_t *reply;
24 xcb_window_t *children;
25 xcb_get_window_attributes_cookie_t *cookies;
27 /* Get the tree of windows whose parent is the root window (= all) */
28 if ((reply = xcb_query_tree_reply(conn, xcb_query_tree(conn, root), 0)) == NULL)
31 len = xcb_query_tree_children_length(reply);
32 cookies = smalloc(len * sizeof(*cookies));
34 /* Request the window attributes for every window */
35 children = xcb_query_tree_children(reply);
36 for (i = 0; i < len; ++i)
37 cookies[i] = xcb_get_window_attributes(conn, children[i]);
39 /* Call manage_window with the attributes for every window */
40 for (i = 0; i < len; ++i)
41 manage_window(children[i], cookies[i], true);
48 * Restores the geometry of each window by reparenting it to the root window
49 * at the position of its frame.
51 * This is to be called *only* before exiting/restarting i3 because of evil
52 * side-effects which are to be expected when continuing to run i3.
55 void restore_geometry(void) {
56 DLOG("Restoring geometry\n");
59 TAILQ_FOREACH(con, &all_cons, all_cons)
61 DLOG("Re-adding X11 border of %d px\n", con->border_width);
62 con->window_rect.width += (2 * con->border_width);
63 con->window_rect.height += (2 * con->border_width);
64 xcb_set_window_rect(conn, con->window->id, con->window_rect);
65 DLOG("placing window %08x at %d %d\n", con->window->id, con->rect.x, con->rect.y);
66 xcb_reparent_window(conn, con->window->id, root,
67 con->rect.x, con->rect.y);
70 /* Strictly speaking, this line doesn’t really belong here, but since we
71 * are syncing, let’s un-register as a window manager first */
72 xcb_change_window_attributes(conn, root, XCB_CW_EVENT_MASK, (uint32_t[]){XCB_EVENT_MASK_SUBSTRUCTURE_REDIRECT});
74 /* Make sure our changes reach the X server, we restart/exit now */
79 * Do some sanity checks and then reparent the window.
82 void manage_window(xcb_window_t window, xcb_get_window_attributes_cookie_t cookie,
83 bool needs_to_be_mapped) {
84 xcb_drawable_t d = {window};
85 xcb_get_geometry_cookie_t geomc;
86 xcb_get_geometry_reply_t *geom;
87 xcb_get_window_attributes_reply_t *attr = NULL;
89 xcb_get_property_cookie_t wm_type_cookie, strut_cookie, state_cookie,
90 utf8_title_cookie, title_cookie,
91 class_cookie, leader_cookie, transient_cookie,
92 role_cookie, startup_id_cookie, wm_hints_cookie,
93 wm_normal_hints_cookie, motif_wm_hints_cookie;
95 geomc = xcb_get_geometry(conn, d);
97 /* Check if the window is mapped (it could be not mapped when intializing and
98 calling manage_window() for every window) */
99 if ((attr = xcb_get_window_attributes_reply(conn, cookie, 0)) == NULL) {
100 DLOG("Could not get attributes\n");
101 xcb_discard_reply(conn, geomc.sequence);
105 if (needs_to_be_mapped && attr->map_state != XCB_MAP_STATE_VIEWABLE) {
106 xcb_discard_reply(conn, geomc.sequence);
110 /* Don’t manage clients with the override_redirect flag */
111 if (attr->override_redirect) {
112 xcb_discard_reply(conn, geomc.sequence);
116 /* Check if the window is already managed */
117 if (con_by_window_id(window) != NULL) {
118 DLOG("already managed (by con %p)\n", con_by_window_id(window));
119 xcb_discard_reply(conn, geomc.sequence);
123 /* Get the initial geometry (position, size, …) */
124 if ((geom = xcb_get_geometry_reply(conn, geomc, 0)) == NULL) {
125 DLOG("could not get geometry\n");
131 /* Set a temporary event mask for the new window, consisting only of
132 * PropertyChange and StructureNotify. We need to be notified of
133 * PropertyChanges because the client can change its properties *after* we
134 * requested them but *before* we actually reparented it and have set our
136 * We need StructureNotify because the client may unmap the window before
137 * we get to re-parent it.
138 * If this request fails, we assume the client has already unmapped the
139 * window between the MapRequest and our event mask change. */
140 values[0] = XCB_EVENT_MASK_PROPERTY_CHANGE |
141 XCB_EVENT_MASK_STRUCTURE_NOTIFY;
142 xcb_void_cookie_t event_mask_cookie =
143 xcb_change_window_attributes_checked(conn, window, XCB_CW_EVENT_MASK, values);
144 if (xcb_request_check(conn, event_mask_cookie) != NULL) {
145 LOG("Could not change event mask, the window probably already disappeared.\n");
149 #define GET_PROPERTY(atom, len) xcb_get_property(conn, false, window, atom, XCB_GET_PROPERTY_TYPE_ANY, 0, len)
151 wm_type_cookie = GET_PROPERTY(A__NET_WM_WINDOW_TYPE, UINT32_MAX);
152 strut_cookie = GET_PROPERTY(A__NET_WM_STRUT_PARTIAL, UINT32_MAX);
153 state_cookie = GET_PROPERTY(A__NET_WM_STATE, UINT32_MAX);
154 utf8_title_cookie = GET_PROPERTY(A__NET_WM_NAME, 128);
155 leader_cookie = GET_PROPERTY(A_WM_CLIENT_LEADER, UINT32_MAX);
156 transient_cookie = GET_PROPERTY(XCB_ATOM_WM_TRANSIENT_FOR, UINT32_MAX);
157 title_cookie = GET_PROPERTY(XCB_ATOM_WM_NAME, 128);
158 class_cookie = GET_PROPERTY(XCB_ATOM_WM_CLASS, 128);
159 role_cookie = GET_PROPERTY(A_WM_WINDOW_ROLE, 128);
160 startup_id_cookie = GET_PROPERTY(A__NET_STARTUP_ID, 512);
161 wm_hints_cookie = xcb_icccm_get_wm_hints(conn, window);
162 wm_normal_hints_cookie = xcb_icccm_get_wm_normal_hints(conn, window);
163 motif_wm_hints_cookie = GET_PROPERTY(A__MOTIF_WM_HINTS, 5 * sizeof(uint64_t));
165 DLOG("Managing window 0x%08x\n", window);
167 i3Window *cwindow = scalloc(sizeof(i3Window));
168 cwindow->id = window;
169 cwindow->depth = get_visual_depth(attr->visual);
171 /* We need to grab buttons 1-3 for click-to-focus and buttons 1-5
172 * to allow for mouse bindings using --whole-window to work correctly. */
173 xcb_grab_button(conn, false, window, XCB_EVENT_MASK_BUTTON_PRESS,
174 XCB_GRAB_MODE_SYNC, XCB_GRAB_MODE_ASYNC, root, XCB_NONE,
175 XCB_BUTTON_INDEX_ANY,
176 XCB_BUTTON_MASK_ANY /* don’t filter for any modifiers */);
178 /* update as much information as possible so far (some replies may be NULL) */
179 window_update_class(cwindow, xcb_get_property_reply(conn, class_cookie, NULL), true);
180 window_update_name_legacy(cwindow, xcb_get_property_reply(conn, title_cookie, NULL), true);
181 window_update_name(cwindow, xcb_get_property_reply(conn, utf8_title_cookie, NULL), true);
182 window_update_leader(cwindow, xcb_get_property_reply(conn, leader_cookie, NULL));
183 window_update_transient_for(cwindow, xcb_get_property_reply(conn, transient_cookie, NULL));
184 window_update_strut_partial(cwindow, xcb_get_property_reply(conn, strut_cookie, NULL));
185 window_update_role(cwindow, xcb_get_property_reply(conn, role_cookie, NULL), true);
187 window_update_hints(cwindow, xcb_get_property_reply(conn, wm_hints_cookie, NULL), &urgency_hint);
188 border_style_t motif_border_style = BS_NORMAL;
189 window_update_motif_hints(cwindow, xcb_get_property_reply(conn, motif_wm_hints_cookie, NULL), &motif_border_style);
190 xcb_size_hints_t wm_size_hints;
191 if (!xcb_icccm_get_wm_size_hints_reply(conn, wm_normal_hints_cookie, &wm_size_hints, NULL))
192 memset(&wm_size_hints, '\0', sizeof(xcb_size_hints_t));
193 xcb_get_property_reply_t *type_reply = xcb_get_property_reply(conn, wm_type_cookie, NULL);
194 xcb_get_property_reply_t *state_reply = xcb_get_property_reply(conn, state_cookie, NULL);
196 xcb_get_property_reply_t *startup_id_reply;
197 startup_id_reply = xcb_get_property_reply(conn, startup_id_cookie, NULL);
198 char *startup_ws = startup_workspace_for_window(cwindow, startup_id_reply);
199 DLOG("startup workspace = %s\n", startup_ws);
201 /* check if the window needs WM_TAKE_FOCUS */
202 cwindow->needs_take_focus = window_supports_protocol(cwindow->id, A_WM_TAKE_FOCUS);
204 /* read the preferred _NET_WM_WINDOW_TYPE atom */
205 cwindow->window_type = xcb_get_preferred_window_type(type_reply);
207 /* Where to start searching for a container that swallows the new one? */
208 Con *search_at = croot;
210 if (xcb_reply_contains_atom(type_reply, A__NET_WM_WINDOW_TYPE_DOCK)) {
211 LOG("This window is of type dock\n");
212 Output *output = get_output_containing(geom->x, geom->y);
213 if (output != NULL) {
214 DLOG("Starting search at output %s\n", output->name);
215 search_at = output->con;
218 /* find out the desired position of this dock window */
219 if (cwindow->reserved.top > 0 && cwindow->reserved.bottom == 0) {
220 DLOG("Top dock client\n");
221 cwindow->dock = W_DOCK_TOP;
222 } else if (cwindow->reserved.top == 0 && cwindow->reserved.bottom > 0) {
223 DLOG("Bottom dock client\n");
224 cwindow->dock = W_DOCK_BOTTOM;
226 DLOG("Ignoring invalid reserved edges (_NET_WM_STRUT_PARTIAL), using position as fallback:\n");
227 if (geom->y < (int16_t)(search_at->rect.height / 2)) {
228 DLOG("geom->y = %d < rect.height / 2 = %d, it is a top dock client\n",
229 geom->y, (search_at->rect.height / 2));
230 cwindow->dock = W_DOCK_TOP;
232 DLOG("geom->y = %d >= rect.height / 2 = %d, it is a bottom dock client\n",
233 geom->y, (search_at->rect.height / 2));
234 cwindow->dock = W_DOCK_BOTTOM;
239 DLOG("Initial geometry: (%d, %d, %d, %d)\n", geom->x, geom->y, geom->width, geom->height);
243 Assignment *assignment;
245 /* TODO: two matches for one container */
247 /* See if any container swallows this new window */
248 nc = con_for_window(search_at, cwindow, &match);
250 /* If not, check if it is assigned to a specific workspace */
251 if ((assignment = assignment_for(cwindow, A_TO_WORKSPACE))) {
252 DLOG("Assignment matches (%p)\n", match);
253 Con *assigned_ws = workspace_get(assignment->dest.workspace, NULL);
254 nc = con_descend_tiling_focused(assigned_ws);
255 DLOG("focused on ws %s: %p / %s\n", assigned_ws->name, nc, nc->name);
256 if (nc->type == CT_WORKSPACE)
257 nc = tree_open_con(nc, cwindow);
259 nc = tree_open_con(nc->parent, cwindow);
261 /* set the urgency hint on the window if the workspace is not visible */
262 if (!workspace_is_visible(assigned_ws))
264 } else if (startup_ws) {
265 /* If it’s not assigned, but was started on a specific workspace,
266 * we want to open it there */
267 DLOG("Using workspace on which this application was started (%s)\n", startup_ws);
268 nc = con_descend_tiling_focused(workspace_get(startup_ws, NULL));
269 DLOG("focused on ws %s: %p / %s\n", startup_ws, nc, nc->name);
270 if (nc->type == CT_WORKSPACE)
271 nc = tree_open_con(nc, cwindow);
273 nc = tree_open_con(nc->parent, cwindow);
275 /* If not, insert it at the currently focused position */
276 if (focused->type == CT_CON && con_accepts_window(focused)) {
277 LOG("using current container, focused = %p, focused->name = %s\n",
278 focused, focused->name);
281 nc = tree_open_con(NULL, cwindow);
284 /* M_BELOW inserts the new window as a child of the one which was
285 * matched (e.g. dock areas) */
286 if (match != NULL && match->insert_where == M_BELOW) {
287 nc = tree_open_con(nc, cwindow);
290 /* If M_BELOW is not used, the container is replaced. This happens with
291 * "swallows" criteria that are used for stored layouts, in which case
292 * we need to remove that criterion, because they should only be valid
294 if (match != NULL && match->insert_where != M_BELOW) {
295 DLOG("Removing match %p from container %p\n", match, nc);
296 TAILQ_REMOVE(&(nc->swallow_head), match, matches);
300 DLOG("new container = %p\n", nc);
301 if (nc->window != NULL && nc->window != cwindow) {
302 if (!restore_kill_placeholder(nc->window->id)) {
303 DLOG("Uh?! Container without a placeholder, but with a window, has swallowed this to-be-managed window?!\n");
306 nc->window = cwindow;
309 nc->border_width = geom->border_width;
312 sasprintf(&name, "[i3 con] container around %p", cwindow);
313 x_set_name(nc, name);
316 /* handle fullscreen containers */
317 Con *ws = con_get_workspace(nc);
318 Con *fs = (ws ? con_get_fullscreen_con(ws, CF_OUTPUT) : NULL);
320 fs = con_get_fullscreen_con(croot, CF_GLOBAL);
322 if (xcb_reply_contains_atom(state_reply, A__NET_WM_STATE_FULLSCREEN)) {
323 /* If this window is already fullscreen (after restarting!), skip
324 * toggling fullscreen, that would drop it out of fullscreen mode. */
326 con_toggle_fullscreen(nc, CF_OUTPUT);
330 bool set_focus = false;
333 DLOG("Not in fullscreen mode, focusing\n");
334 if (!cwindow->dock) {
335 /* Check that the workspace is visible and on the same output as
336 * the current focused container. If the window was assigned to an
337 * invisible workspace, we should not steal focus. */
338 Con *current_output = con_get_output(focused);
339 Con *target_output = con_get_output(ws);
341 if (workspace_is_visible(ws) && current_output == target_output) {
342 if (!match || !match->restart_mode) {
345 DLOG("not focusing, matched with restart_mode == true\n");
347 DLOG("workspace not visible, not focusing\n");
349 DLOG("dock, not focusing\n");
351 DLOG("fs = %p, ws = %p, not focusing\n", fs, ws);
352 /* Insert the new container in focus stack *after* the currently
353 * focused (fullscreen) con. This way, the new container will be
354 * focused after we return from fullscreen mode */
355 Con *first = TAILQ_FIRST(&(nc->parent->focus_head));
357 /* We only modify the focus stack if the container is not already
358 * the first one. This can happen when existing containers swallow
359 * new windows, for example when restarting. */
360 TAILQ_REMOVE(&(nc->parent->focus_head), nc, focused);
361 TAILQ_INSERT_AFTER(&(nc->parent->focus_head), first, nc, focused);
365 /* set floating if necessary */
366 bool want_floating = false;
367 if (xcb_reply_contains_atom(type_reply, A__NET_WM_WINDOW_TYPE_DIALOG) ||
368 xcb_reply_contains_atom(type_reply, A__NET_WM_WINDOW_TYPE_UTILITY) ||
369 xcb_reply_contains_atom(type_reply, A__NET_WM_WINDOW_TYPE_TOOLBAR) ||
370 xcb_reply_contains_atom(type_reply, A__NET_WM_WINDOW_TYPE_SPLASH) ||
371 xcb_reply_contains_atom(state_reply, A__NET_WM_STATE_MODAL) ||
372 (wm_size_hints.flags & XCB_ICCCM_SIZE_HINT_P_MAX_SIZE &&
373 wm_size_hints.flags & XCB_ICCCM_SIZE_HINT_P_MIN_SIZE &&
374 wm_size_hints.min_height == wm_size_hints.max_height &&
375 wm_size_hints.min_width == wm_size_hints.max_width)) {
376 LOG("This window is a dialog window, setting floating\n");
377 want_floating = true;
383 if (cwindow->transient_for != XCB_NONE ||
384 (cwindow->leader != XCB_NONE &&
385 cwindow->leader != cwindow->id &&
386 con_by_window_id(cwindow->leader) != NULL)) {
387 LOG("This window is transient for another window, setting floating\n");
388 want_floating = true;
390 if (config.popup_during_fullscreen == PDF_LEAVE_FULLSCREEN &&
392 LOG("There is a fullscreen window, leaving fullscreen mode\n");
393 con_toggle_fullscreen(fs, CF_OUTPUT);
394 } else if (config.popup_during_fullscreen == PDF_SMART &&
396 fs->window != NULL) {
397 i3Window *transient_win = cwindow;
398 while (transient_win != NULL &&
399 transient_win->transient_for != XCB_NONE) {
400 if (transient_win->transient_for == fs->window->id) {
401 LOG("This floating window belongs to the fullscreen window (popup_during_fullscreen == smart)\n");
405 Con *next_transient = con_by_window_id(transient_win->transient_for);
406 if (next_transient == NULL)
408 /* Some clients (e.g. x11-ssh-askpass) actually set
409 * WM_TRANSIENT_FOR to their own window id, so break instead of
410 * looping endlessly. */
411 if (transient_win == next_transient->window)
413 transient_win = next_transient->window;
418 /* dock clients cannot be floating, that makes no sense */
420 want_floating = false;
422 /* Store the requested geometry. The width/height gets raised to at least
423 * 75x50 when entering floating mode, which is the minimum size for a
424 * window to be useful (smaller windows are usually overlays/toolbars/…
425 * which are not managed by the wm anyways). We store the original geometry
426 * here because it’s used for dock clients. */
427 if (nc->geometry.width == 0)
428 nc->geometry = (Rect){geom->x, geom->y, geom->width, geom->height};
430 if (motif_border_style != BS_NORMAL) {
431 DLOG("MOTIF_WM_HINTS specifies decorations (border_style = %d)\n", motif_border_style);
433 con_set_border_style(nc, motif_border_style, config.default_floating_border_width);
435 con_set_border_style(nc, motif_border_style, config.default_border_width);
440 DLOG("geometry = %d x %d\n", nc->geometry.width, nc->geometry.height);
441 /* automatically set the border to the default value if a motif border
442 * was not specified */
443 bool automatic_border = (motif_border_style == BS_NORMAL);
445 floating_enable(nc, automatic_border);
448 /* explicitly set the border width to the default */
449 if (nc->current_border_width == -1) {
450 nc->current_border_width = (want_floating ? config.default_floating_border_width : config.default_border_width);
453 /* to avoid getting an UnmapNotify event due to reparenting, we temporarily
454 * declare no interest in any state change event of this window */
455 values[0] = XCB_NONE;
456 xcb_change_window_attributes(conn, window, XCB_CW_EVENT_MASK, values);
458 xcb_void_cookie_t rcookie = xcb_reparent_window_checked(conn, window, nc->frame, 0, 0);
459 if (xcb_request_check(conn, rcookie) != NULL) {
460 LOG("Could not reparent the window, aborting\n");
464 values[0] = CHILD_EVENT_MASK & ~XCB_EVENT_MASK_ENTER_WINDOW;
465 xcb_change_window_attributes(conn, window, XCB_CW_EVENT_MASK, values);
468 /* Put the client inside the save set. Upon termination (whether killed or
469 * normal exit does not matter) of the window manager, these clients will
470 * be correctly reparented to their most closest living ancestor (=
472 xcb_change_save_set(conn, XCB_SET_MODE_INSERT, window);
474 /* Check if any assignments match */
475 run_assignments(cwindow);
477 /* 'ws' may be invalid because of the assignments, e.g. when the user uses
478 * "move window to workspace 1", but had it assigned to workspace 2. */
479 ws = con_get_workspace(nc);
481 /* If this window was put onto an invisible workspace (via assignments), we
482 * render this workspace. It wouldn’t be rendered in our normal code path
483 * because only the visible workspaces get rendered.
485 * By rendering the workspace, we assign proper coordinates (read: not
486 * width=0, height=0) to the window, which is important for windows who
487 * actually use them to position their GUI elements, e.g. rhythmbox. */
488 if (ws && !workspace_is_visible(ws)) {
489 /* This is a bit hackish: we need to copy the content container’s rect
490 * to the workspace, because calling render_con() on the content
491 * container would also take the shortcut and not render the invisible
492 * workspace at all. However, just calling render_con() on the
493 * workspace isn’t enough either — it needs the rect. */
494 ws->rect = ws->parent->rect;
495 render_con(ws, true);
496 /* Disable setting focus, otherwise we’d move focus to an invisible
497 * workspace, which we generally prevent (e.g. in
498 * con_move_to_workspace). */
501 render_con(croot, false);
503 /* Send an event about window creation */
504 ipc_send_window_event("new", nc);
506 /* Defer setting focus after the 'new' event has been sent to ensure the
507 * proper window event sequence. */
508 if (set_focus && !nc->window->doesnt_accept_focus && nc->mapped) {
509 if (assignment_for(cwindow, A_NO_FOCUS) == NULL) {
510 DLOG("Now setting focus.\n");
517 /* Windows might get managed with the urgency hint already set (Pidgin is
518 * known to do that), so check for that and handle the hint accordingly.
519 * This code needs to be in this part of manage_window() because the window
520 * needs to be on the final workspace first. */
521 con_set_urgency(nc, urgency_hint);