2 * vim:ts=4:sw=4:expandtab
4 * i3 - an improved dynamic tiling window manager
5 * © 2009 Michael Stapelberg and contributors (see also: LICENSE)
7 * commands.c: all command functions (see commands_parser.c)
16 #ifdef I3_ASAN_ENABLED
17 #include <sanitizer/lsan_interface.h>
22 // Macros to make the YAJL API a bit easier to use.
23 #define y(x, ...) (cmd_output->json_gen != NULL ? yajl_gen_##x(cmd_output->json_gen, ##__VA_ARGS__) : 0)
24 #define ystr(str) (cmd_output->json_gen != NULL ? yajl_gen_string(cmd_output->json_gen, (unsigned char *)str, strlen(str)) : 0)
25 #define ysuccess(success) \
27 if (cmd_output->json_gen != NULL) { \
34 #define yerror(format, ...) \
36 if (cmd_output->json_gen != NULL) { \
38 sasprintf(&message, format, ##__VA_ARGS__); \
49 /** If an error occurred during parsing of the criteria, we want to exit instead
50 * of relying on fallback behavior. See #2091. */
51 #define HANDLE_INVALID_MATCH \
53 if (current_match->error != NULL) { \
54 yerror("Invalid match: %s", current_match->error); \
59 /** When the command did not include match criteria (!), we use the currently
60 * focused container. Do not confuse this case with a command which included
61 * criteria but which did not match any windows. This macro has to be called in
64 #define HANDLE_EMPTY_MATCH \
66 HANDLE_INVALID_MATCH; \
68 if (match_is_empty(current_match)) { \
69 while (!TAILQ_EMPTY(&owindows)) { \
70 owindow *ow = TAILQ_FIRST(&owindows); \
71 TAILQ_REMOVE(&owindows, ow, owindows); \
74 owindow *ow = smalloc(sizeof(owindow)); \
76 TAILQ_INIT(&owindows); \
77 TAILQ_INSERT_TAIL(&owindows, ow, owindows); \
82 * Checks whether we switched to a new workspace and returns false in that case,
83 * signaling that further workspace switching should be done by the calling function
84 * If not, calls workspace_back_and_forth() if workspace_auto_back_and_forth is set
85 * and return true, signaling that no further workspace switching should occur in the calling function.
88 static bool maybe_back_and_forth(struct CommandResultIR *cmd_output, const char *name) {
89 Con *ws = con_get_workspace(focused);
91 /* If we switched to a different workspace, do nothing */
92 if (strcmp(ws->name, name) != 0)
95 DLOG("This workspace is already focused.\n");
96 if (config.workspace_auto_back_and_forth) {
97 workspace_back_and_forth();
98 cmd_output->needs_tree_render = true;
104 * Return the passed workspace unless it is the current one and auto back and
105 * forth is enabled, in which case the back_and_forth workspace is returned.
107 static Con *maybe_auto_back_and_forth_workspace(Con *workspace) {
110 if (!config.workspace_auto_back_and_forth)
113 current = con_get_workspace(focused);
115 if (current == workspace) {
116 baf = workspace_back_and_forth_get();
118 DLOG("Substituting workspace with back_and_forth, as it is focused.\n");
126 /*******************************************************************************
127 * Criteria functions.
128 ******************************************************************************/
131 * Helper data structure for an operation window (window on which the operation
132 * will be performed). Used to build the TAILQ owindows.
135 typedef struct owindow {
142 typedef TAILQ_HEAD(owindows_head, owindow) owindows_head;
144 static owindows_head owindows;
147 * Initializes the specified 'Match' data structure and the initial state of
148 * commands.c for matching target windows of a command.
151 void cmd_criteria_init(I3_CMD) {
155 DLOG("Initializing criteria, current_match = %p\n", current_match);
156 match_free(current_match);
157 match_init(current_match);
158 while (!TAILQ_EMPTY(&owindows)) {
159 ow = TAILQ_FIRST(&owindows);
160 TAILQ_REMOVE(&owindows, ow, owindows);
163 TAILQ_INIT(&owindows);
165 TAILQ_FOREACH(con, &all_cons, all_cons) {
166 ow = smalloc(sizeof(owindow));
168 TAILQ_INSERT_TAIL(&owindows, ow, owindows);
173 * A match specification just finished (the closing square bracket was found),
174 * so we filter the list of owindows.
177 void cmd_criteria_match_windows(I3_CMD) {
178 owindow *next, *current;
180 DLOG("match specification finished, matching...\n");
181 /* copy the old list head to iterate through it and start with a fresh
182 * list which will contain only matching windows */
183 struct owindows_head old = owindows;
184 TAILQ_INIT(&owindows);
185 for (next = TAILQ_FIRST(&old); next != TAILQ_END(&old);) {
186 /* make a copy of the next pointer and advance the pointer to the
187 * next element as we are going to invalidate the element’s
188 * next/prev pointers by calling TAILQ_INSERT_TAIL later */
190 next = TAILQ_NEXT(next, owindows);
192 DLOG("checking if con %p / %s matches\n", current->con, current->con->name);
194 /* We use this flag to prevent matching on window-less containers if
195 * only window-specific criteria were specified. */
196 bool accept_match = false;
198 if (current_match->con_id != NULL) {
201 if (current_match->con_id == current->con) {
202 DLOG("con_id matched.\n");
204 DLOG("con_id does not match.\n");
210 if (current_match->mark != NULL && !TAILQ_EMPTY(&(current->con->marks_head))) {
212 bool matched_by_mark = false;
215 TAILQ_FOREACH(mark, &(current->con->marks_head), marks) {
216 if (!regex_matches(current_match->mark, mark->name))
219 DLOG("match by mark\n");
220 matched_by_mark = true;
224 if (!matched_by_mark) {
225 DLOG("mark does not match.\n");
231 if (current->con->window != NULL) {
232 if (match_matches_window(current_match, current->con->window)) {
233 DLOG("matches window!\n");
236 DLOG("doesn't match\n");
243 TAILQ_INSERT_TAIL(&owindows, current, owindows);
250 TAILQ_FOREACH(current, &owindows, owindows) {
251 DLOG("matching: %p / %s\n", current->con, current->con->name);
256 * Interprets a ctype=cvalue pair and adds it to the current match
260 void cmd_criteria_add(I3_CMD, const char *ctype, const char *cvalue) {
261 match_parse_property(current_match, ctype, cvalue);
264 static void move_matches_to_workspace(Con *ws) {
266 TAILQ_FOREACH(current, &owindows, owindows) {
267 DLOG("matching: %p / %s\n", current->con, current->con->name);
268 con_move_to_workspace(current->con, ws, true, false, false);
273 * Implementation of 'move [window|container] [to] workspace
274 * next|prev|next_on_output|prev_on_output|current'.
277 void cmd_move_con_to_workspace(I3_CMD, const char *which) {
278 DLOG("which=%s\n", which);
280 /* We have nothing to move:
281 * when criteria was specified but didn't match any window or
282 * when criteria wasn't specified and we don't have any window focused. */
283 if ((!match_is_empty(current_match) && TAILQ_EMPTY(&owindows)) ||
284 (match_is_empty(current_match) && focused->type == CT_WORKSPACE &&
285 !con_has_children(focused))) {
292 /* get the workspace */
294 if (strcmp(which, "next") == 0)
295 ws = workspace_next();
296 else if (strcmp(which, "prev") == 0)
297 ws = workspace_prev();
298 else if (strcmp(which, "next_on_output") == 0)
299 ws = workspace_next_on_output();
300 else if (strcmp(which, "prev_on_output") == 0)
301 ws = workspace_prev_on_output();
302 else if (strcmp(which, "current") == 0)
303 ws = con_get_workspace(focused);
305 ELOG("BUG: called with which=%s\n", which);
310 move_matches_to_workspace(ws);
312 cmd_output->needs_tree_render = true;
313 // XXX: default reply for now, make this a better reply
318 * Implementation of 'move [window|container] [to] workspace back_and_forth'.
321 void cmd_move_con_to_workspace_back_and_forth(I3_CMD) {
322 Con *ws = workspace_back_and_forth_get();
324 yerror("No workspace was previously active.");
330 move_matches_to_workspace(ws);
332 cmd_output->needs_tree_render = true;
333 // XXX: default reply for now, make this a better reply
338 * Implementation of 'move [--no-auto-back-and-forth] [window|container] [to] workspace <name>'.
341 void cmd_move_con_to_workspace_name(I3_CMD, const char *name, const char *_no_auto_back_and_forth) {
342 if (strncasecmp(name, "__", strlen("__")) == 0) {
343 LOG("You cannot move containers to i3-internal workspaces (\"%s\").\n", name);
348 const bool no_auto_back_and_forth = (_no_auto_back_and_forth != NULL);
350 /* We have nothing to move:
351 * when criteria was specified but didn't match any window or
352 * when criteria wasn't specified and we don't have any window focused. */
353 if (!match_is_empty(current_match) && TAILQ_EMPTY(&owindows)) {
354 ELOG("No windows match your criteria, cannot move.\n");
357 } else if (match_is_empty(current_match) && focused->type == CT_WORKSPACE &&
358 !con_has_children(focused)) {
363 LOG("should move window to workspace %s\n", name);
364 /* get the workspace */
365 Con *ws = workspace_get(name, NULL);
367 if (!no_auto_back_and_forth)
368 ws = maybe_auto_back_and_forth_workspace(ws);
372 move_matches_to_workspace(ws);
374 cmd_output->needs_tree_render = true;
375 // XXX: default reply for now, make this a better reply
380 * Implementation of 'move [--no-auto-back-and-forth] [window|container] [to] workspace number <name>'.
383 void cmd_move_con_to_workspace_number(I3_CMD, const char *which, const char *_no_auto_back_and_forth) {
384 const bool no_auto_back_and_forth = (_no_auto_back_and_forth != NULL);
386 /* We have nothing to move:
387 * when criteria was specified but didn't match any window or
388 * when criteria wasn't specified and we don't have any window focused. */
389 if ((!match_is_empty(current_match) && TAILQ_EMPTY(&owindows)) ||
390 (match_is_empty(current_match) && focused->type == CT_WORKSPACE &&
391 !con_has_children(focused))) {
396 LOG("should move window to workspace %s\n", which);
398 long parsed_num = ws_name_to_number(which);
399 if (parsed_num == -1) {
400 LOG("Could not parse initial part of \"%s\" as a number.\n", which);
401 yerror("Could not parse number \"%s\"", which);
405 Con *ws = get_existing_workspace_by_num(parsed_num);
407 ws = workspace_get(which, NULL);
410 if (!no_auto_back_and_forth)
411 ws = maybe_auto_back_and_forth_workspace(ws);
415 move_matches_to_workspace(ws);
417 cmd_output->needs_tree_render = true;
418 // XXX: default reply for now, make this a better reply
422 static void cmd_resize_floating(I3_CMD, const char *way, const char *direction, Con *floating_con, int px) {
423 LOG("floating resize\n");
424 Rect old_rect = floating_con->rect;
425 Con *focused_con = con_descend_focused(floating_con);
427 /* ensure that resize will take place even if pixel increment is smaller than
428 * height increment or width increment.
430 const i3Window *window = focused_con->window;
431 if (window != NULL) {
432 if (strcmp(direction, "up") == 0 || strcmp(direction, "down") == 0 ||
433 strcmp(direction, "height") == 0) {
435 px = (-px < window->height_increment) ? -window->height_increment : px;
437 px = (px < window->height_increment) ? window->height_increment : px;
438 } else if (strcmp(direction, "left") == 0 || strcmp(direction, "right") == 0) {
440 px = (-px < window->width_increment) ? -window->width_increment : px;
442 px = (px < window->width_increment) ? window->width_increment : px;
446 if (strcmp(direction, "up") == 0) {
447 floating_con->rect.height += px;
448 } else if (strcmp(direction, "down") == 0 || strcmp(direction, "height") == 0) {
449 floating_con->rect.height += px;
450 } else if (strcmp(direction, "left") == 0) {
451 floating_con->rect.width += px;
453 floating_con->rect.width += px;
456 floating_check_size(floating_con);
458 /* Did we actually resize anything or did the size constraints prevent us?
459 * If we could not resize, exit now to not move the window. */
460 if (memcmp(&old_rect, &(floating_con->rect), sizeof(Rect)) == 0)
463 if (strcmp(direction, "up") == 0) {
464 floating_con->rect.y -= (floating_con->rect.height - old_rect.height);
465 } else if (strcmp(direction, "left") == 0) {
466 floating_con->rect.x -= (floating_con->rect.width - old_rect.width);
469 /* If this is a scratchpad window, don't auto center it from now on. */
470 if (floating_con->scratchpad_state == SCRATCHPAD_FRESH)
471 floating_con->scratchpad_state = SCRATCHPAD_CHANGED;
474 static bool cmd_resize_tiling_direction(I3_CMD, Con *current, const char *way, const char *direction, int ppt) {
475 LOG("tiling resize\n");
477 Con *first = current;
478 direction_t search_direction;
479 if (!strcmp(direction, "left"))
480 search_direction = D_LEFT;
481 else if (!strcmp(direction, "right"))
482 search_direction = D_RIGHT;
483 else if (!strcmp(direction, "up"))
484 search_direction = D_UP;
486 search_direction = D_DOWN;
488 bool res = resize_find_tiling_participants(&first, &second, search_direction, false);
490 LOG("No second container in this direction found.\n");
495 /* get the default percentage */
496 int children = con_num_children(first->parent);
497 LOG("ins. %d children\n", children);
498 double percentage = 1.0 / children;
499 LOG("default percentage = %f\n", percentage);
502 LOG("first->percent before = %f\n", first->percent);
503 LOG("second->percent before = %f\n", second->percent);
504 if (first->percent == 0.0)
505 first->percent = percentage;
506 if (second->percent == 0.0)
507 second->percent = percentage;
508 double new_first_percent = first->percent + ((double)ppt / 100.0);
509 double new_second_percent = second->percent - ((double)ppt / 100.0);
510 LOG("new_first_percent = %f\n", new_first_percent);
511 LOG("new_second_percent = %f\n", new_second_percent);
512 /* Ensure that the new percentages are positive. */
513 if (new_first_percent > 0.0 && new_second_percent > 0.0) {
514 first->percent = new_first_percent;
515 second->percent = new_second_percent;
516 LOG("first->percent after = %f\n", first->percent);
517 LOG("second->percent after = %f\n", second->percent);
519 LOG("Not resizing, already at minimum size\n");
525 static bool cmd_resize_tiling_width_height(I3_CMD, Con *current, const char *way, const char *direction, int ppt) {
526 LOG("width/height resize\n");
528 /* get the appropriate current container (skip stacked/tabbed cons) */
530 direction_t search_direction = (strcmp(direction, "width") == 0 ? D_LEFT : D_DOWN);
531 bool search_result = resize_find_tiling_participants(¤t, &dummy, search_direction, true);
532 if (search_result == false) {
537 /* get the default percentage */
538 int children = con_num_children(current->parent);
539 LOG("ins. %d children\n", children);
540 double percentage = 1.0 / children;
541 LOG("default percentage = %f\n", percentage);
543 /* Ensure all the other children have a percentage set. */
545 TAILQ_FOREACH(child, &(current->parent->nodes_head), nodes) {
546 LOG("child->percent = %f (child %p)\n", child->percent, child);
547 if (child->percent == 0.0)
548 child->percent = percentage;
551 double new_current_percent = current->percent + ((double)ppt / 100.0);
552 double subtract_percent = ((double)ppt / 100.0) / (children - 1);
553 LOG("new_current_percent = %f\n", new_current_percent);
554 LOG("subtract_percent = %f\n", subtract_percent);
555 /* Ensure that the new percentages are positive. */
556 TAILQ_FOREACH(child, &(current->parent->nodes_head), nodes) {
557 if (child == current)
559 if (child->percent - subtract_percent <= 0.0) {
560 LOG("Not resizing, already at minimum size (child %p would end up with a size of %.f\n", child, child->percent - subtract_percent);
565 if (new_current_percent <= 0.0) {
566 LOG("Not resizing, already at minimum size\n");
571 current->percent = new_current_percent;
572 LOG("current->percent after = %f\n", current->percent);
574 TAILQ_FOREACH(child, &(current->parent->nodes_head), nodes) {
575 if (child == current)
577 child->percent -= subtract_percent;
578 LOG("child->percent after (%p) = %f\n", child, child->percent);
585 * Implementation of 'resize grow|shrink <direction> [<px> px] [or <ppt> ppt]'.
588 void cmd_resize(I3_CMD, const char *way, const char *direction, long resize_px, long resize_ppt) {
589 DLOG("resizing in way %s, direction %s, px %ld or ppt %ld\n", way, direction, resize_px, resize_ppt);
590 if (strcmp(way, "shrink") == 0) {
598 TAILQ_FOREACH(current, &owindows, owindows) {
599 /* Don't handle dock windows (issue #1201) */
600 if (current->con->window && current->con->window->dock) {
601 DLOG("This is a dock window. Not resizing (con = %p)\n)", current->con);
606 if ((floating_con = con_inside_floating(current->con))) {
607 cmd_resize_floating(current_match, cmd_output, way, direction, floating_con, resize_px);
609 if (strcmp(direction, "width") == 0 ||
610 strcmp(direction, "height") == 0) {
611 if (!cmd_resize_tiling_width_height(current_match, cmd_output,
612 current->con, way, direction, resize_ppt))
615 if (!cmd_resize_tiling_direction(current_match, cmd_output,
616 current->con, way, direction, resize_ppt))
622 cmd_output->needs_tree_render = true;
623 // XXX: default reply for now, make this a better reply
628 * Implementation of 'resize set <width> [px | ppt] <height> [px | ppt]'.
631 void cmd_resize_set(I3_CMD, long cwidth, const char *mode_width, long cheight, const char *mode_height) {
632 DLOG("resizing to %ld %s x %ld %s\n", cwidth, mode_width, cheight, mode_height);
633 if (cwidth < 0 || cheight < 0) {
634 ELOG("Resize failed: dimensions cannot be negative (was %ld %s x %ld %s)\n", cwidth, mode_width, cheight, mode_height);
642 TAILQ_FOREACH(current, &owindows, owindows) {
644 if ((floating_con = con_inside_floating(current->con))) {
645 Con *output = con_get_output(floating_con);
647 cwidth = floating_con->rect.width;
648 } else if (mode_width && strcmp(mode_width, "ppt") == 0) {
649 cwidth = output->rect.width * ((double)cwidth / 100.0);
652 cheight = floating_con->rect.height;
653 } else if (mode_height && strcmp(mode_height, "ppt") == 0) {
654 cheight = output->rect.height * ((double)cheight / 100.0);
656 floating_resize(floating_con, cwidth, cheight);
658 if (current->con->window && current->con->window->dock) {
659 DLOG("This is a dock window. Not resizing (con = %p)\n)", current->con);
663 if (cwidth > 0 && mode_width && strcmp(mode_width, "ppt") == 0) {
664 /* get the appropriate current container (skip stacked/tabbed cons) */
665 Con *target = current->con;
667 resize_find_tiling_participants(&target, &dummy, D_LEFT, true);
669 /* Calculate new size for the target container */
670 double current_percent = target->percent;
674 if (current_percent > cwidth) {
675 action_string = "shrink";
676 adjustment = (int)(current_percent * 100) - cwidth;
678 action_string = "grow";
679 adjustment = cwidth - (int)(current_percent * 100);
682 /* perform resizing and report failure if not possible */
683 if (!cmd_resize_tiling_width_height(current_match, cmd_output,
684 target, action_string, "width", adjustment)) {
689 if (cheight > 0 && mode_height && strcmp(mode_height, "ppt") == 0) {
690 /* get the appropriate current container (skip stacked/tabbed cons) */
691 Con *target = current->con;
693 resize_find_tiling_participants(&target, &dummy, D_DOWN, true);
695 /* Calculate new size for the target container */
696 double current_percent = target->percent;
700 if (current_percent > cheight) {
701 action_string = "shrink";
702 adjustment = (int)(current_percent * 100) - cheight;
704 action_string = "grow";
705 adjustment = cheight - (int)(current_percent * 100);
708 /* perform resizing and report failure if not possible */
709 if (!cmd_resize_tiling_width_height(current_match, cmd_output,
710 target, action_string, "height", adjustment)) {
717 cmd_output->needs_tree_render = true;
721 static int border_width_from_style(border_style_t border_style, long border_width, Con *con) {
722 if (border_style == BS_NONE) {
725 if (border_width >= 0) {
726 return logical_px(border_width);
729 const bool is_floating = con_inside_floating(con) != NULL;
730 /* Load the configured defaults. */
731 if (is_floating && border_style == config.default_floating_border) {
732 return config.default_floating_border_width;
733 } else if (!is_floating && border_style == config.default_border) {
734 return config.default_border_width;
736 /* Use some hardcoded values. */
737 return logical_px(border_style == BS_NORMAL ? 2 : 1);
742 * Implementation of 'border normal|pixel [<n>]', 'border none|1pixel|toggle'.
745 void cmd_border(I3_CMD, const char *border_style_str, long border_width) {
746 DLOG("border style should be changed to %s with border width %ld\n", border_style_str, border_width);
751 TAILQ_FOREACH(current, &owindows, owindows) {
752 DLOG("matching: %p / %s\n", current->con, current->con->name);
754 border_style_t border_style;
755 if (strcmp(border_style_str, "toggle") == 0) {
756 border_style = (current->con->border_style + 1) % 3;
757 } else if (strcmp(border_style_str, "normal") == 0) {
758 border_style = BS_NORMAL;
759 } else if (strcmp(border_style_str, "pixel") == 0) {
760 border_style = BS_PIXEL;
761 } else if (strcmp(border_style_str, "none") == 0) {
762 border_style = BS_NONE;
764 ELOG("BUG: called with border_style=%s\n", border_style_str);
769 const int con_border_width = border_width_from_style(border_style, border_width, current->con);
770 con_set_border_style(current->con, border_style, con_border_width);
773 cmd_output->needs_tree_render = true;
774 // XXX: default reply for now, make this a better reply
779 * Implementation of 'nop <comment>'.
782 void cmd_nop(I3_CMD, const char *comment) {
783 LOG("-------------------------------------------------\n");
784 LOG(" NOP: %s\n", comment);
785 LOG("-------------------------------------------------\n");
790 * Implementation of 'append_layout <path>'.
793 void cmd_append_layout(I3_CMD, const char *cpath) {
794 LOG("Appending layout \"%s\"\n", cpath);
796 /* Make sure we allow paths like '~/.i3/layout.json' */
797 char *path = resolve_tilde(cpath);
801 if ((len = slurp(path, &buf)) < 0) {
802 /* slurp already logged an error. */
806 if (!json_validate(buf, len)) {
807 ELOG("Could not parse \"%s\" as JSON, not loading.\n", path);
808 yerror("Could not parse \"%s\" as JSON.", path);
812 json_content_t content = json_determine_content(buf, len);
813 LOG("JSON content = %d\n", content);
814 if (content == JSON_CONTENT_UNKNOWN) {
815 ELOG("Could not determine the contents of \"%s\", not loading.\n", path);
816 yerror("Could not determine the contents of \"%s\".", path);
820 Con *parent = focused;
821 if (content == JSON_CONTENT_WORKSPACE) {
822 parent = output_get_content(con_get_output(parent));
824 /* We need to append the layout to a split container, since a leaf
825 * container must not have any children (by definition).
826 * Note that we explicitly check for workspaces, since they are okay for
827 * this purpose, but con_accepts_window() returns false for workspaces. */
828 while (parent->type != CT_WORKSPACE && !con_accepts_window(parent))
829 parent = parent->parent;
831 DLOG("Appending to parent=%p instead of focused=%p\n", parent, focused);
832 char *errormsg = NULL;
833 tree_append_json(parent, buf, len, &errormsg);
834 if (errormsg != NULL) {
837 /* Note that we continue executing since tree_append_json() has
838 * side-effects — user-provided layouts can be partly valid, partly
839 * invalid, leading to half of the placeholder containers being
845 // XXX: This is a bit of a kludge. Theoretically, render_con(parent,
846 // false); should be enough, but when sending 'workspace 4; append_layout
847 // /tmp/foo.json', the needs_tree_render == true of the workspace command
848 // is not executed yet and will be batched with append_layout’s
849 // needs_tree_render after the parser finished. We should check if that is
851 render_con(croot, false);
853 restore_open_placeholder_windows(parent);
855 if (content == JSON_CONTENT_WORKSPACE)
856 ipc_send_workspace_event("restored", parent, NULL);
858 cmd_output->needs_tree_render = true;
865 * Implementation of 'workspace next|prev|next_on_output|prev_on_output'.
868 void cmd_workspace(I3_CMD, const char *which) {
871 DLOG("which=%s\n", which);
873 if (con_get_fullscreen_con(croot, CF_GLOBAL)) {
874 LOG("Cannot switch workspace while in global fullscreen\n");
879 if (strcmp(which, "next") == 0)
880 ws = workspace_next();
881 else if (strcmp(which, "prev") == 0)
882 ws = workspace_prev();
883 else if (strcmp(which, "next_on_output") == 0)
884 ws = workspace_next_on_output();
885 else if (strcmp(which, "prev_on_output") == 0)
886 ws = workspace_prev_on_output();
888 ELOG("BUG: called with which=%s\n", which);
895 cmd_output->needs_tree_render = true;
896 // XXX: default reply for now, make this a better reply
901 * Implementation of 'workspace [--no-auto-back-and-forth] number <name>'
904 void cmd_workspace_number(I3_CMD, const char *which, const char *_no_auto_back_and_forth) {
905 const bool no_auto_back_and_forth = (_no_auto_back_and_forth != NULL);
907 if (con_get_fullscreen_con(croot, CF_GLOBAL)) {
908 LOG("Cannot switch workspace while in global fullscreen\n");
913 long parsed_num = ws_name_to_number(which);
914 if (parsed_num == -1) {
915 LOG("Could not parse initial part of \"%s\" as a number.\n", which);
916 yerror("Could not parse number \"%s\"", which);
920 Con *workspace = get_existing_workspace_by_num(parsed_num);
922 LOG("There is no workspace with number %ld, creating a new one.\n", parsed_num);
924 workspace_show_by_name(which);
925 cmd_output->needs_tree_render = true;
928 if (!no_auto_back_and_forth && maybe_back_and_forth(cmd_output, workspace->name)) {
932 workspace_show(workspace);
934 cmd_output->needs_tree_render = true;
935 // XXX: default reply for now, make this a better reply
940 * Implementation of 'workspace back_and_forth'.
943 void cmd_workspace_back_and_forth(I3_CMD) {
944 if (con_get_fullscreen_con(croot, CF_GLOBAL)) {
945 LOG("Cannot switch workspace while in global fullscreen\n");
950 workspace_back_and_forth();
952 cmd_output->needs_tree_render = true;
953 // XXX: default reply for now, make this a better reply
958 * Implementation of 'workspace [--no-auto-back-and-forth] <name>'
961 void cmd_workspace_name(I3_CMD, const char *name, const char *_no_auto_back_and_forth) {
962 const bool no_auto_back_and_forth = (_no_auto_back_and_forth != NULL);
964 if (strncasecmp(name, "__", strlen("__")) == 0) {
965 LOG("You cannot switch to the i3-internal workspaces (\"%s\").\n", name);
970 if (con_get_fullscreen_con(croot, CF_GLOBAL)) {
971 LOG("Cannot switch workspace while in global fullscreen\n");
976 DLOG("should switch to workspace %s\n", name);
977 if (!no_auto_back_and_forth && maybe_back_and_forth(cmd_output, name)) {
981 workspace_show_by_name(name);
983 cmd_output->needs_tree_render = true;
984 // XXX: default reply for now, make this a better reply
989 * Implementation of 'mark [--add|--replace] [--toggle] <mark>'
992 void cmd_mark(I3_CMD, const char *mark, const char *mode, const char *toggle) {
995 owindow *current = TAILQ_FIRST(&owindows);
996 if (current == NULL) {
1001 /* Marks must be unique, i.e., no two windows must have the same mark. */
1002 if (current != TAILQ_LAST(&owindows, owindows_head)) {
1003 yerror("A mark must not be put onto more than one window");
1007 DLOG("matching: %p / %s\n", current->con, current->con->name);
1009 mark_mode_t mark_mode = (mode == NULL || strcmp(mode, "--replace") == 0) ? MM_REPLACE : MM_ADD;
1010 if (toggle != NULL) {
1011 con_mark_toggle(current->con, mark, mark_mode);
1013 con_mark(current->con, mark, mark_mode);
1016 cmd_output->needs_tree_render = true;
1017 // XXX: default reply for now, make this a better reply
1022 * Implementation of 'unmark [mark]'
1025 void cmd_unmark(I3_CMD, const char *mark) {
1026 if (match_is_empty(current_match)) {
1027 con_unmark(NULL, mark);
1030 TAILQ_FOREACH(current, &owindows, owindows) {
1031 con_unmark(current->con, mark);
1035 cmd_output->needs_tree_render = true;
1036 // XXX: default reply for now, make this a better reply
1041 * Implementation of 'mode <string>'.
1044 void cmd_mode(I3_CMD, const char *mode) {
1045 DLOG("mode=%s\n", mode);
1048 // XXX: default reply for now, make this a better reply
1053 * Implementation of 'move [window|container] [to] output <str>'.
1056 void cmd_move_con_to_output(I3_CMD, const char *name) {
1057 DLOG("Should move window to output \"%s\".\n", name);
1061 bool had_error = false;
1062 TAILQ_FOREACH(current, &owindows, owindows) {
1063 DLOG("matching: %p / %s\n", current->con, current->con->name);
1065 had_error |= !con_move_to_output_name(current->con, name, true);
1068 cmd_output->needs_tree_render = true;
1069 ysuccess(!had_error);
1073 * Implementation of 'move [container|window] [to] mark <str>'.
1076 void cmd_move_con_to_mark(I3_CMD, const char *mark) {
1077 DLOG("moving window to mark \"%s\"\n", mark);
1083 TAILQ_FOREACH(current, &owindows, owindows) {
1084 DLOG("moving matched window %p / %s to mark \"%s\"\n", current->con, current->con->name, mark);
1085 result &= con_move_to_mark(current->con, mark);
1088 cmd_output->needs_tree_render = true;
1093 * Implementation of 'floating enable|disable|toggle'
1096 void cmd_floating(I3_CMD, const char *floating_mode) {
1099 DLOG("floating_mode=%s\n", floating_mode);
1103 TAILQ_FOREACH(current, &owindows, owindows) {
1104 DLOG("matching: %p / %s\n", current->con, current->con->name);
1105 if (strcmp(floating_mode, "toggle") == 0) {
1106 DLOG("should toggle mode\n");
1107 toggle_floating_mode(current->con, false);
1109 DLOG("should switch mode to %s\n", floating_mode);
1110 if (strcmp(floating_mode, "enable") == 0) {
1111 floating_enable(current->con, false);
1113 floating_disable(current->con, false);
1118 cmd_output->needs_tree_render = true;
1119 // XXX: default reply for now, make this a better reply
1124 * Implementation of 'move workspace to [output] <str>'.
1127 void cmd_move_workspace_to_output(I3_CMD, const char *name) {
1128 DLOG("should move workspace to output %s\n", name);
1133 TAILQ_FOREACH(current, &owindows, owindows) {
1134 Con *ws = con_get_workspace(current->con);
1135 if (con_is_internal(ws)) {
1139 Output *current_output = get_output_for_con(ws);
1140 if (current_output == NULL) {
1141 ELOG("Cannot get current output. This is a bug in i3.\n");
1146 Output *target_output = get_output_from_string(current_output, name);
1147 if (!target_output) {
1148 ELOG("Could not get output from string \"%s\"\n", name);
1153 bool success = workspace_move_to_output(ws, target_output);
1155 ELOG("Failed to move workspace to output.\n");
1161 cmd_output->needs_tree_render = true;
1162 // XXX: default reply for now, make this a better reply
1167 * Implementation of 'split v|h|t|vertical|horizontal|toggle'.
1170 void cmd_split(I3_CMD, const char *direction) {
1174 LOG("splitting in direction %c\n", direction[0]);
1175 TAILQ_FOREACH(current, &owindows, owindows) {
1176 if (con_is_docked(current->con)) {
1177 ELOG("Cannot split a docked container, skipping.\n");
1181 DLOG("matching: %p / %s\n", current->con, current->con->name);
1182 if (direction[0] == 't') {
1183 layout_t current_layout;
1184 if (current->con->type == CT_WORKSPACE) {
1185 current_layout = current->con->layout;
1187 current_layout = current->con->parent->layout;
1189 /* toggling split orientation */
1190 if (current_layout == L_SPLITH) {
1191 tree_split(current->con, VERT);
1193 tree_split(current->con, HORIZ);
1196 tree_split(current->con, (direction[0] == 'v' ? VERT : HORIZ));
1200 cmd_output->needs_tree_render = true;
1201 // XXX: default reply for now, make this a better reply
1206 * Implementation of 'kill [window|client]'.
1209 void cmd_kill(I3_CMD, const char *kill_mode_str) {
1210 if (kill_mode_str == NULL)
1211 kill_mode_str = "window";
1213 DLOG("kill_mode=%s\n", kill_mode_str);
1216 if (strcmp(kill_mode_str, "window") == 0)
1217 kill_mode = KILL_WINDOW;
1218 else if (strcmp(kill_mode_str, "client") == 0)
1219 kill_mode = KILL_CLIENT;
1221 ELOG("BUG: called with kill_mode=%s\n", kill_mode_str);
1229 TAILQ_FOREACH(current, &owindows, owindows) {
1230 con_close(current->con, kill_mode);
1233 cmd_output->needs_tree_render = true;
1234 // XXX: default reply for now, make this a better reply
1239 * Implementation of 'exec [--no-startup-id] <command>'.
1242 void cmd_exec(I3_CMD, const char *nosn, const char *command) {
1243 bool no_startup_id = (nosn != NULL);
1245 DLOG("should execute %s, no_startup_id = %d\n", command, no_startup_id);
1246 start_application(command, no_startup_id);
1248 // XXX: default reply for now, make this a better reply
1253 * Implementation of 'focus left|right|up|down'.
1256 void cmd_focus_direction(I3_CMD, const char *direction) {
1257 DLOG("direction = *%s*\n", direction);
1259 if (strcmp(direction, "left") == 0)
1260 tree_next('p', HORIZ);
1261 else if (strcmp(direction, "right") == 0)
1262 tree_next('n', HORIZ);
1263 else if (strcmp(direction, "up") == 0)
1264 tree_next('p', VERT);
1265 else if (strcmp(direction, "down") == 0)
1266 tree_next('n', VERT);
1268 ELOG("Invalid focus direction (%s)\n", direction);
1273 cmd_output->needs_tree_render = true;
1274 // XXX: default reply for now, make this a better reply
1279 * Focus a container and disable any other fullscreen container not permitting the focus.
1282 static void cmd_focus_force_focus(Con *con) {
1283 /* Disable fullscreen container in workspace with container to be focused. */
1284 Con *ws = con_get_workspace(con);
1285 Con *fullscreen_on_ws = (focused && focused->fullscreen_mode == CF_GLOBAL) ? focused : con_get_fullscreen_con(ws, CF_OUTPUT);
1286 if (fullscreen_on_ws && fullscreen_on_ws != con && !con_has_parent(con, fullscreen_on_ws)) {
1287 con_disable_fullscreen(fullscreen_on_ws);
1293 * Implementation of 'focus tiling|floating|mode_toggle'.
1296 void cmd_focus_window_mode(I3_CMD, const char *window_mode) {
1297 DLOG("window_mode = %s\n", window_mode);
1299 bool to_floating = false;
1300 if (strcmp(window_mode, "mode_toggle") == 0) {
1301 to_floating = !con_inside_floating(focused);
1302 } else if (strcmp(window_mode, "floating") == 0) {
1304 } else if (strcmp(window_mode, "tiling") == 0) {
1305 to_floating = false;
1308 Con *ws = con_get_workspace(focused);
1310 bool success = false;
1311 TAILQ_FOREACH(current, &(ws->focus_head), focused) {
1312 if ((to_floating && current->type != CT_FLOATING_CON) ||
1313 (!to_floating && current->type == CT_FLOATING_CON))
1316 cmd_focus_force_focus(con_descend_focused(current));
1322 cmd_output->needs_tree_render = true;
1325 yerror("Failed to find a %s container in workspace.", to_floating ? "floating" : "tiling");
1330 * Implementation of 'focus parent|child'.
1333 void cmd_focus_level(I3_CMD, const char *level) {
1334 DLOG("level = %s\n", level);
1335 bool success = false;
1337 /* Focusing the parent can only be allowed if the newly
1338 * focused container won't escape the fullscreen container. */
1339 if (strcmp(level, "parent") == 0) {
1340 if (focused && focused->parent) {
1341 if (con_fullscreen_permits_focusing(focused->parent))
1342 success = level_up();
1344 ELOG("'focus parent': Currently in fullscreen, not going up\n");
1348 /* Focusing a child should always be allowed. */
1350 success = level_down();
1352 cmd_output->needs_tree_render = success;
1353 // XXX: default reply for now, make this a better reply
1358 * Implementation of 'focus'.
1361 void cmd_focus(I3_CMD) {
1362 DLOG("current_match = %p\n", current_match);
1364 if (match_is_empty(current_match)) {
1365 ELOG("You have to specify which window/container should be focused.\n");
1366 ELOG("Example: [class=\"urxvt\" title=\"irssi\"] focus\n");
1368 yerror("You have to specify which window/container should be focused");
1373 Con *__i3_scratch = workspace_get("__i3_scratch", NULL);
1376 TAILQ_FOREACH(current, &owindows, owindows) {
1377 Con *ws = con_get_workspace(current->con);
1378 /* If no workspace could be found, this was a dock window.
1379 * Just skip it, you cannot focus dock windows. */
1383 /* In case this is a scratchpad window, call scratchpad_show(). */
1384 if (ws == __i3_scratch) {
1385 scratchpad_show(current->con);
1387 /* While for the normal focus case we can change focus multiple
1388 * times and only a single window ends up focused, we could show
1389 * multiple scratchpad windows. So, rather break here. */
1393 /* If the container is not on the current workspace,
1394 * workspace_show() will switch to a different workspace and (if
1395 * enabled) trigger a mouse pointer warp to the currently focused
1396 * container (!) on the target workspace.
1398 * Therefore, before calling workspace_show(), we make sure that
1399 * 'current' will be focused on the workspace. However, we cannot
1400 * just con_focus(current) because then the pointer will not be
1401 * warped at all (the code thinks we are already there).
1403 * So we focus 'current' to make it the currently focused window of
1404 * the target workspace, then revert focus. */
1405 Con *currently_focused = focused;
1406 cmd_focus_force_focus(current->con);
1407 con_activate(currently_focused);
1409 /* Now switch to the workspace, then focus */
1411 LOG("focusing %p / %s\n", current->con, current->con->name);
1412 con_activate(current->con);
1417 LOG("WARNING: Your criteria for the focus command matches %d containers, "
1418 "while only exactly one container can be focused at a time.\n",
1421 cmd_output->needs_tree_render = true;
1422 ysuccess(count > 0);
1426 * Implementation of 'fullscreen enable|toggle [global]' and
1427 * 'fullscreen disable'
1430 void cmd_fullscreen(I3_CMD, const char *action, const char *fullscreen_mode) {
1431 fullscreen_mode_t mode = strcmp(fullscreen_mode, "global") == 0 ? CF_GLOBAL : CF_OUTPUT;
1432 DLOG("%s fullscreen, mode = %s\n", action, fullscreen_mode);
1437 TAILQ_FOREACH(current, &owindows, owindows) {
1438 DLOG("matching: %p / %s\n", current->con, current->con->name);
1439 if (strcmp(action, "toggle") == 0) {
1440 con_toggle_fullscreen(current->con, mode);
1441 } else if (strcmp(action, "enable") == 0) {
1442 con_enable_fullscreen(current->con, mode);
1443 } else if (strcmp(action, "disable") == 0) {
1444 con_disable_fullscreen(current->con);
1448 cmd_output->needs_tree_render = true;
1449 // XXX: default reply for now, make this a better reply
1454 * Implementation of 'sticky enable|disable|toggle'.
1457 void cmd_sticky(I3_CMD, const char *action) {
1458 DLOG("%s sticky on window\n", action);
1462 TAILQ_FOREACH(current, &owindows, owindows) {
1463 if (current->con->window == NULL) {
1464 ELOG("only containers holding a window can be made sticky, skipping con = %p\n", current->con);
1467 DLOG("setting sticky for container = %p / %s\n", current->con, current->con->name);
1469 bool sticky = false;
1470 if (strcmp(action, "enable") == 0)
1472 else if (strcmp(action, "disable") == 0)
1474 else if (strcmp(action, "toggle") == 0)
1475 sticky = !current->con->sticky;
1477 current->con->sticky = sticky;
1478 ewmh_update_sticky(current->con->window->id, sticky);
1481 /* A window we made sticky might not be on a visible workspace right now, so we need to make
1482 * sure it gets pushed to the front now. */
1483 output_push_sticky_windows(focused);
1485 ewmh_update_wm_desktop();
1487 cmd_output->needs_tree_render = true;
1492 * Implementation of 'move <direction> [<pixels> [px]]'.
1495 void cmd_move_direction(I3_CMD, const char *direction, long move_px) {
1499 Con *initially_focused = focused;
1501 TAILQ_FOREACH(current, &owindows, owindows) {
1502 DLOG("moving in direction %s, px %ld\n", direction, move_px);
1503 if (con_is_floating(current->con)) {
1504 DLOG("floating move with %ld pixels\n", move_px);
1505 Rect newrect = current->con->parent->rect;
1506 if (strcmp(direction, "left") == 0) {
1507 newrect.x -= move_px;
1508 } else if (strcmp(direction, "right") == 0) {
1509 newrect.x += move_px;
1510 } else if (strcmp(direction, "up") == 0) {
1511 newrect.y -= move_px;
1512 } else if (strcmp(direction, "down") == 0) {
1513 newrect.y += move_px;
1515 floating_reposition(current->con->parent, newrect);
1517 tree_move(current->con, (strcmp(direction, "right") == 0 ? D_RIGHT : (strcmp(direction, "left") == 0 ? D_LEFT : (strcmp(direction, "up") == 0 ? D_UP : D_DOWN))));
1518 cmd_output->needs_tree_render = true;
1522 /* the move command should not disturb focus */
1523 if (focused != initially_focused)
1524 con_activate(initially_focused);
1526 // XXX: default reply for now, make this a better reply
1531 * Implementation of 'layout default|stacked|stacking|tabbed|splitv|splith'.
1534 void cmd_layout(I3_CMD, const char *layout_str) {
1538 if (!layout_from_name(layout_str, &layout)) {
1539 ELOG("Unknown layout \"%s\", this is a mismatch between code and parser spec.\n", layout_str);
1543 DLOG("changing layout to %s (%d)\n", layout_str, layout);
1546 TAILQ_FOREACH(current, &owindows, owindows) {
1547 if (con_is_docked(current->con)) {
1548 ELOG("cannot change layout of a docked container, skipping it.\n");
1552 DLOG("matching: %p / %s\n", current->con, current->con->name);
1553 con_set_layout(current->con, layout);
1556 cmd_output->needs_tree_render = true;
1557 // XXX: default reply for now, make this a better reply
1562 * Implementation of 'layout toggle [all|split]'.
1565 void cmd_layout_toggle(I3_CMD, const char *toggle_mode) {
1568 if (toggle_mode == NULL)
1569 toggle_mode = "default";
1571 DLOG("toggling layout (mode = %s)\n", toggle_mode);
1573 /* check if the match is empty, not if the result is empty */
1574 if (match_is_empty(current_match))
1575 con_toggle_layout(focused, toggle_mode);
1577 TAILQ_FOREACH(current, &owindows, owindows) {
1578 DLOG("matching: %p / %s\n", current->con, current->con->name);
1579 con_toggle_layout(current->con, toggle_mode);
1583 cmd_output->needs_tree_render = true;
1584 // XXX: default reply for now, make this a better reply
1589 * Implementation of 'exit'.
1592 void cmd_exit(I3_CMD) {
1593 LOG("Exiting due to user command.\n");
1594 #ifdef I3_ASAN_ENABLED
1595 __lsan_do_leak_check();
1597 ipc_shutdown(SHUTDOWN_REASON_EXIT);
1598 unlink(config.ipc_socket_path);
1599 xcb_disconnect(conn);
1606 * Implementation of 'reload'.
1609 void cmd_reload(I3_CMD) {
1611 kill_nagbar(&config_error_nagbar_pid, false);
1612 kill_nagbar(&command_error_nagbar_pid, false);
1613 load_configuration(conn, NULL, true);
1615 /* Send an IPC event just in case the ws names have changed */
1616 ipc_send_workspace_event("reload", NULL, NULL);
1617 /* Send an update event for the barconfig just in case it has changed */
1620 // XXX: default reply for now, make this a better reply
1625 * Implementation of 'restart'.
1628 void cmd_restart(I3_CMD) {
1629 LOG("restarting i3\n");
1630 ipc_shutdown(SHUTDOWN_REASON_RESTART);
1631 unlink(config.ipc_socket_path);
1632 /* We need to call this manually since atexit handlers don’t get called
1634 purge_zerobyte_logfile();
1637 // XXX: default reply for now, make this a better reply
1642 * Implementation of 'open'.
1645 void cmd_open(I3_CMD) {
1646 LOG("opening new container\n");
1647 Con *con = tree_open_con(NULL, NULL);
1648 con->layout = L_SPLITH;
1655 y(integer, (uintptr_t)con);
1658 cmd_output->needs_tree_render = true;
1662 * Implementation of 'focus output <output>'.
1665 void cmd_focus_output(I3_CMD, const char *name) {
1668 DLOG("name = %s\n", name);
1672 /* get the output */
1673 Output *current_output = NULL;
1676 TAILQ_FOREACH(current, &owindows, owindows)
1677 current_output = get_output_for_con(current->con);
1678 assert(current_output != NULL);
1680 output = get_output_from_string(current_output, name);
1683 LOG("No such output found.\n");
1688 /* get visible workspace on output */
1690 GREP_FIRST(ws, output_get_content(output->con), workspace_is_visible(child));
1698 cmd_output->needs_tree_render = true;
1699 // XXX: default reply for now, make this a better reply
1704 * Implementation of 'move [window|container] [to] [absolute] position <px> [px] <px> [px]
1707 void cmd_move_window_to_position(I3_CMD, long x, long y) {
1708 bool has_error = false;
1713 TAILQ_FOREACH(current, &owindows, owindows) {
1714 if (!con_is_floating(current->con)) {
1715 ELOG("Cannot change position. The window/container is not floating\n");
1718 yerror("Cannot change position of a window/container because it is not floating.");
1725 Rect newrect = current->con->parent->rect;
1727 DLOG("moving to position %ld %ld\n", x, y);
1731 if (!floating_reposition(current->con->parent, newrect)) {
1732 yerror("Cannot move window/container out of bounds.");
1742 * Implementation of 'move [window|container] [to] [absolute] position center
1745 void cmd_move_window_to_center(I3_CMD, const char *method) {
1746 bool has_error = false;
1750 TAILQ_FOREACH(current, &owindows, owindows) {
1751 Con *floating_con = con_inside_floating(current->con);
1752 if (floating_con == NULL) {
1753 ELOG("con %p / %s is not floating, cannot move it to the center.\n",
1754 current->con, current->con->name);
1757 yerror("Cannot change position of a window/container because it is not floating.");
1764 if (strcmp(method, "absolute") == 0) {
1765 DLOG("moving to absolute center\n");
1766 floating_center(floating_con, croot->rect);
1768 floating_maybe_reassign_ws(floating_con);
1769 cmd_output->needs_tree_render = true;
1772 if (strcmp(method, "position") == 0) {
1773 DLOG("moving to center\n");
1774 floating_center(floating_con, con_get_workspace(floating_con)->rect);
1776 cmd_output->needs_tree_render = true;
1780 // XXX: default reply for now, make this a better reply
1786 * Implementation of 'move [window|container] [to] position mouse'
1789 void cmd_move_window_to_mouse(I3_CMD) {
1793 TAILQ_FOREACH(current, &owindows, owindows) {
1794 Con *floating_con = con_inside_floating(current->con);
1795 if (floating_con == NULL) {
1796 DLOG("con %p / %s is not floating, cannot move it to the mouse position.\n",
1797 current->con, current->con->name);
1801 DLOG("moving floating container %p / %s to cursor position\n", floating_con, floating_con->name);
1802 floating_move_to_pointer(floating_con);
1805 cmd_output->needs_tree_render = true;
1810 * Implementation of 'move scratchpad'.
1813 void cmd_move_scratchpad(I3_CMD) {
1814 DLOG("should move window to scratchpad\n");
1819 TAILQ_FOREACH(current, &owindows, owindows) {
1820 DLOG("matching: %p / %s\n", current->con, current->con->name);
1821 scratchpad_move(current->con);
1824 cmd_output->needs_tree_render = true;
1825 // XXX: default reply for now, make this a better reply
1830 * Implementation of 'scratchpad show'.
1833 void cmd_scratchpad_show(I3_CMD) {
1834 DLOG("should show scratchpad window\n");
1836 bool result = false;
1838 if (match_is_empty(current_match)) {
1839 result = scratchpad_show(NULL);
1841 TAILQ_FOREACH(current, &owindows, owindows) {
1842 DLOG("matching: %p / %s\n", current->con, current->con->name);
1843 result |= scratchpad_show(current->con);
1847 cmd_output->needs_tree_render = true;
1853 * Implementation of 'swap [container] [with] id|con_id|mark <arg>'.
1856 void cmd_swap(I3_CMD, const char *mode, const char *arg) {
1859 owindow *match = TAILQ_FIRST(&owindows);
1860 if (match == NULL) {
1861 DLOG("No match found for swapping.\n");
1866 if (strcmp(mode, "id") == 0) {
1868 if (!parse_long(arg, &target, 0)) {
1869 yerror("Failed to parse %s into a window id.\n", arg);
1873 con = con_by_window_id(target);
1874 } else if (strcmp(mode, "con_id") == 0) {
1876 if (!parse_long(arg, &target, 0)) {
1877 yerror("Failed to parse %s into a container id.\n", arg);
1881 con = con_by_con_id(target);
1882 } else if (strcmp(mode, "mark") == 0) {
1883 con = con_by_mark(arg);
1885 yerror("Unhandled swap mode \"%s\". This is a bug.\n", mode);
1890 yerror("Could not find container for %s = %s\n", mode, arg);
1894 if (match != TAILQ_LAST(&owindows, owindows_head)) {
1895 DLOG("More than one container matched the swap command, only using the first one.");
1898 if (match->con == NULL) {
1899 DLOG("Match %p has no container.\n", match);
1904 DLOG("Swapping %p with %p.\n", match->con, con);
1905 bool result = con_swap(match->con, con);
1907 cmd_output->needs_tree_render = true;
1912 * Implementation of 'title_format <format>'
1915 void cmd_title_format(I3_CMD, const char *format) {
1916 DLOG("setting title_format to \"%s\"\n", format);
1920 TAILQ_FOREACH(current, &owindows, owindows) {
1921 DLOG("setting title_format for %p / %s\n", current->con, current->con->name);
1922 FREE(current->con->title_format);
1924 /* If we only display the title without anything else, we can skip the parsing step,
1925 * so we remove the title format altogether. */
1926 if (strcasecmp(format, "%title") != 0) {
1927 current->con->title_format = sstrdup(format);
1929 if (current->con->window != NULL) {
1930 i3String *formatted_title = con_parse_title_format(current->con);
1931 ewmh_update_visible_name(current->con->window->id, i3string_as_utf8(formatted_title));
1932 I3STRING_FREE(formatted_title);
1935 if (current->con->window != NULL) {
1936 /* We can remove _NET_WM_VISIBLE_NAME since we don't display a custom title. */
1937 ewmh_update_visible_name(current->con->window->id, NULL);
1941 if (current->con->window != NULL) {
1942 /* Make sure the window title is redrawn immediately. */
1943 current->con->window->name_x_changed = true;
1945 /* For windowless containers we also need to force the redrawing. */
1946 FREE(current->con->deco_render_params);
1950 cmd_output->needs_tree_render = true;
1955 * Implementation of 'rename workspace [<name>] to <name>'
1958 void cmd_rename_workspace(I3_CMD, const char *old_name, const char *new_name) {
1959 if (strncasecmp(new_name, "__", strlen("__")) == 0) {
1960 LOG("Cannot rename workspace to \"%s\": names starting with __ are i3-internal.\n", new_name);
1965 LOG("Renaming workspace \"%s\" to \"%s\"\n", old_name, new_name);
1967 LOG("Renaming current workspace to \"%s\"\n", new_name);
1972 workspace = get_existing_workspace_by_name(old_name);
1974 workspace = con_get_workspace(focused);
1975 old_name = workspace->name;
1979 yerror("Old workspace \"%s\" not found", old_name);
1983 Con *check_dest = get_existing_workspace_by_name(new_name);
1985 /* If check_dest == workspace, the user might be changing the case of the
1986 * workspace, or it might just be a no-op. */
1987 if (check_dest != NULL && check_dest != workspace) {
1988 yerror("New workspace \"%s\" already exists", new_name);
1992 /* Change the name and try to parse it as a number. */
1993 /* old_name might refer to workspace->name, so copy it before free()ing */
1994 char *old_name_copy = sstrdup(old_name);
1995 FREE(workspace->name);
1996 workspace->name = sstrdup(new_name);
1998 workspace->num = ws_name_to_number(new_name);
1999 LOG("num = %d\n", workspace->num);
2001 /* By re-attaching, the sort order will be correct afterwards. */
2002 Con *previously_focused = focused;
2003 Con *previously_focused_content = focused->type == CT_WORKSPACE ? focused->parent : NULL;
2004 Con *parent = workspace->parent;
2005 con_detach(workspace);
2006 con_attach(workspace, parent, false);
2008 /* Move the workspace to the correct output if it has an assignment */
2009 struct Workspace_Assignment *assignment = NULL;
2010 TAILQ_FOREACH(assignment, &ws_assignments, ws_assignments) {
2011 if (assignment->output == NULL)
2013 if (strcmp(assignment->name, workspace->name) != 0 && (!name_is_digits(assignment->name) || ws_name_to_number(assignment->name) != workspace->num)) {
2017 Output *target_output = get_output_by_name(assignment->output, true);
2018 if (!target_output) {
2019 LOG("Could not get output named \"%s\"\n", assignment->output);
2022 if (!output_triggers_assignment(target_output, assignment)) {
2025 workspace_move_to_output(workspace, target_output);
2027 bool can_restore_focus = previously_focused != NULL;
2028 /* NB: If previously_focused is a workspace we can't
2029 * work directly with it since it might have been cleaned up by
2030 * workspace_show() already, depending on the
2031 * focus order/number of other workspaces on the output.
2032 * Instead, we loop through the available workspaces and only focus
2033 * previously_focused if we still find it. */
2034 if (previously_focused_content) {
2035 Con *workspace = NULL;
2036 GREP_FIRST(workspace, previously_focused_content, child == previously_focused);
2037 can_restore_focus &= (workspace != NULL);
2040 if (can_restore_focus) {
2041 /* Restore the previous focus since con_attach messes with the focus. */
2042 workspace_show(con_get_workspace(previously_focused));
2043 con_activate(previously_focused);
2049 cmd_output->needs_tree_render = true;
2052 ipc_send_workspace_event("rename", workspace, NULL);
2053 ewmh_update_desktop_names();
2054 ewmh_update_desktop_viewport();
2055 ewmh_update_current_desktop();
2057 startup_sequence_rename_workspace(old_name_copy, new_name);
2058 free(old_name_copy);
2062 * Implementation of 'bar mode dock|hide|invisible|toggle [<bar_id>]'
2065 bool cmd_bar_mode(const char *bar_mode, const char *bar_id) {
2067 bool toggle = false;
2068 if (strcmp(bar_mode, "dock") == 0)
2070 else if (strcmp(bar_mode, "hide") == 0)
2072 else if (strcmp(bar_mode, "invisible") == 0)
2074 else if (strcmp(bar_mode, "toggle") == 0)
2077 ELOG("Unknown bar mode \"%s\", this is a mismatch between code and parser spec.\n", bar_mode);
2081 bool changed_sth = false;
2082 Barconfig *current = NULL;
2083 TAILQ_FOREACH(current, &barconfigs, configs) {
2084 if (bar_id && strcmp(current->id, bar_id) != 0)
2088 mode = (current->mode + 1) % 2;
2090 DLOG("Changing bar mode of bar_id '%s' to '%s (%d)'\n", current->id, bar_mode, mode);
2091 current->mode = mode;
2098 if (bar_id && !changed_sth) {
2099 DLOG("Changing bar mode of bar_id %s failed, bar_id not found.\n", bar_id);
2107 * Implementation of 'bar hidden_state hide|show|toggle [<bar_id>]'
2110 bool cmd_bar_hidden_state(const char *bar_hidden_state, const char *bar_id) {
2111 int hidden_state = S_SHOW;
2112 bool toggle = false;
2113 if (strcmp(bar_hidden_state, "hide") == 0)
2114 hidden_state = S_HIDE;
2115 else if (strcmp(bar_hidden_state, "show") == 0)
2116 hidden_state = S_SHOW;
2117 else if (strcmp(bar_hidden_state, "toggle") == 0)
2120 ELOG("Unknown bar state \"%s\", this is a mismatch between code and parser spec.\n", bar_hidden_state);
2124 bool changed_sth = false;
2125 Barconfig *current = NULL;
2126 TAILQ_FOREACH(current, &barconfigs, configs) {
2127 if (bar_id && strcmp(current->id, bar_id) != 0)
2131 hidden_state = (current->hidden_state + 1) % 2;
2133 DLOG("Changing bar hidden_state of bar_id '%s' to '%s (%d)'\n", current->id, bar_hidden_state, hidden_state);
2134 current->hidden_state = hidden_state;
2141 if (bar_id && !changed_sth) {
2142 DLOG("Changing bar hidden_state of bar_id %s failed, bar_id not found.\n", bar_id);
2150 * Implementation of 'bar (hidden_state hide|show|toggle)|(mode dock|hide|invisible|toggle) [<bar_id>]'
2153 void cmd_bar(I3_CMD, const char *bar_type, const char *bar_value, const char *bar_id) {
2155 if (strcmp(bar_type, "mode") == 0)
2156 ret = cmd_bar_mode(bar_value, bar_id);
2157 else if (strcmp(bar_type, "hidden_state") == 0)
2158 ret = cmd_bar_hidden_state(bar_value, bar_id);
2160 ELOG("Unknown bar option type \"%s\", this is a mismatch between code and parser spec.\n", bar_type);
2172 * Implementation of 'shmlog <size>|toggle|on|off'
2175 void cmd_shmlog(I3_CMD, const char *argument) {
2176 if (!strcmp(argument, "toggle"))
2177 /* Toggle shm log, if size is not 0. If it is 0, set it to default. */
2178 shmlog_size = shmlog_size ? -shmlog_size : default_shmlog_size;
2179 else if (!strcmp(argument, "on"))
2180 shmlog_size = default_shmlog_size;
2181 else if (!strcmp(argument, "off"))
2185 if (!parse_long(argument, &new_size, 0)) {
2186 yerror("Failed to parse %s into a shmlog size.\n", argument);
2189 /* If shm logging now, restart logging with the new size. */
2190 if (shmlog_size > 0) {
2192 LOG("Restarting shm logging...\n");
2195 shmlog_size = (int)new_size;
2197 LOG("%s shm logging\n", shmlog_size > 0 ? "Enabling" : "Disabling");
2199 update_shmlog_atom();
2204 * Implementation of 'debuglog toggle|on|off'
2207 void cmd_debuglog(I3_CMD, const char *argument) {
2208 bool logging = get_debug_logging();
2209 if (!strcmp(argument, "toggle")) {
2210 LOG("%s debug logging\n", logging ? "Disabling" : "Enabling");
2211 set_debug_logging(!logging);
2212 } else if (!strcmp(argument, "on") && !logging) {
2213 LOG("Enabling debug logging\n");
2214 set_debug_logging(true);
2215 } else if (!strcmp(argument, "off") && logging) {
2216 LOG("Disabling debug logging\n");
2217 set_debug_logging(false);
2219 // XXX: default reply for now, make this a better reply