2 #define I3__FILE__ "commands.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 * commands.c: all command functions (see commands_parser.c)
15 #ifdef I3_ASAN_ENABLED
16 #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 occured 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 * Returns true if a is definitely greater than b (using the given epsilon)
85 static bool definitelyGreaterThan(float a, float b, float epsilon) {
86 return (a - b) > ((fabs(a) < fabs(b) ? fabs(b) : fabs(a)) * epsilon);
90 * Returns the output containing the given container.
92 static Output *get_output_of_con(Con *con) {
93 Con *output_con = con_get_output(con);
94 Output *output = get_output_by_name(output_con->name);
95 assert(output != NULL);
101 * Checks whether we switched to a new workspace and returns false in that case,
102 * signaling that further workspace switching should be done by the calling function
103 * If not, calls workspace_back_and_forth() if workspace_auto_back_and_forth is set
104 * and return true, signaling that no further workspace switching should occur in the calling function.
107 static bool maybe_back_and_forth(struct CommandResultIR *cmd_output, const char *name) {
108 Con *ws = con_get_workspace(focused);
110 /* If we switched to a different workspace, do nothing */
111 if (strcmp(ws->name, name) != 0)
114 DLOG("This workspace is already focused.\n");
115 if (config.workspace_auto_back_and_forth) {
116 workspace_back_and_forth();
117 cmd_output->needs_tree_render = true;
123 * Return the passed workspace unless it is the current one and auto back and
124 * forth is enabled, in which case the back_and_forth workspace is returned.
126 static Con *maybe_auto_back_and_forth_workspace(Con *workspace) {
129 if (!config.workspace_auto_back_and_forth)
132 current = con_get_workspace(focused);
134 if (current == workspace) {
135 baf = workspace_back_and_forth_get();
137 DLOG("Substituting workspace with back_and_forth, as it is focused.\n");
145 /*******************************************************************************
146 * Criteria functions.
147 ******************************************************************************/
150 * Helper data structure for an operation window (window on which the operation
151 * will be performed). Used to build the TAILQ owindows.
154 typedef struct owindow {
156 TAILQ_ENTRY(owindow) owindows;
159 typedef TAILQ_HEAD(owindows_head, owindow) owindows_head;
161 static owindows_head owindows;
164 * Initializes the specified 'Match' data structure and the initial state of
165 * commands.c for matching target windows of a command.
168 void cmd_criteria_init(I3_CMD) {
172 DLOG("Initializing criteria, current_match = %p\n", current_match);
173 match_free(current_match);
174 match_init(current_match);
175 while (!TAILQ_EMPTY(&owindows)) {
176 ow = TAILQ_FIRST(&owindows);
177 TAILQ_REMOVE(&owindows, ow, owindows);
180 TAILQ_INIT(&owindows);
182 TAILQ_FOREACH(con, &all_cons, all_cons) {
183 ow = smalloc(sizeof(owindow));
185 TAILQ_INSERT_TAIL(&owindows, ow, owindows);
190 * A match specification just finished (the closing square bracket was found),
191 * so we filter the list of owindows.
194 void cmd_criteria_match_windows(I3_CMD) {
195 owindow *next, *current;
197 DLOG("match specification finished, matching...\n");
198 /* copy the old list head to iterate through it and start with a fresh
199 * list which will contain only matching windows */
200 struct owindows_head old = owindows;
201 TAILQ_INIT(&owindows);
202 for (next = TAILQ_FIRST(&old); next != TAILQ_END(&old);) {
203 /* make a copy of the next pointer and advance the pointer to the
204 * next element as we are going to invalidate the element’s
205 * next/prev pointers by calling TAILQ_INSERT_TAIL later */
207 next = TAILQ_NEXT(next, owindows);
209 DLOG("checking if con %p / %s matches\n", current->con, current->con->name);
211 /* We use this flag to prevent matching on window-less containers if
212 * only window-specific criteria were specified. */
213 bool accept_match = false;
215 if (current_match->con_id != NULL) {
218 if (current_match->con_id == current->con) {
219 DLOG("con_id matched.\n");
221 DLOG("con_id does not match.\n");
227 if (current_match->mark != NULL && !TAILQ_EMPTY(&(current->con->marks_head))) {
229 bool matched_by_mark = false;
232 TAILQ_FOREACH(mark, &(current->con->marks_head), marks) {
233 if (!regex_matches(current_match->mark, mark->name))
236 DLOG("match by mark\n");
237 matched_by_mark = true;
241 if (!matched_by_mark) {
242 DLOG("mark does not match.\n");
248 if (current->con->window != NULL) {
249 if (match_matches_window(current_match, current->con->window)) {
250 DLOG("matches window!\n");
253 DLOG("doesn't match\n");
260 TAILQ_INSERT_TAIL(&owindows, current, owindows);
267 TAILQ_FOREACH(current, &owindows, owindows) {
268 DLOG("matching: %p / %s\n", current->con, current->con->name);
273 * Interprets a ctype=cvalue pair and adds it to the current match
277 void cmd_criteria_add(I3_CMD, const char *ctype, const char *cvalue) {
278 match_parse_property(current_match, ctype, cvalue);
282 * Implementation of 'move [window|container] [to] workspace
283 * next|prev|next_on_output|prev_on_output|current'.
286 void cmd_move_con_to_workspace(I3_CMD, const char *which) {
289 DLOG("which=%s\n", which);
291 /* We have nothing to move:
292 * when criteria was specified but didn't match any window or
293 * when criteria wasn't specified and we don't have any window focused. */
294 if ((!match_is_empty(current_match) && TAILQ_EMPTY(&owindows)) ||
295 (match_is_empty(current_match) && focused->type == CT_WORKSPACE &&
296 !con_has_children(focused))) {
303 /* get the workspace */
305 if (strcmp(which, "next") == 0)
306 ws = workspace_next();
307 else if (strcmp(which, "prev") == 0)
308 ws = workspace_prev();
309 else if (strcmp(which, "next_on_output") == 0)
310 ws = workspace_next_on_output();
311 else if (strcmp(which, "prev_on_output") == 0)
312 ws = workspace_prev_on_output();
313 else if (strcmp(which, "current") == 0)
314 ws = con_get_workspace(focused);
316 ELOG("BUG: called with which=%s\n", which);
321 TAILQ_FOREACH(current, &owindows, owindows) {
322 DLOG("matching: %p / %s\n", current->con, current->con->name);
323 con_move_to_workspace(current->con, ws, true, false, false);
326 cmd_output->needs_tree_render = true;
327 // XXX: default reply for now, make this a better reply
332 * Implementation of 'move [window|container] [to] workspace back_and_forth'.
335 void cmd_move_con_to_workspace_back_and_forth(I3_CMD) {
339 ws = workspace_back_and_forth_get();
342 yerror("No workspace was previously active.");
348 TAILQ_FOREACH(current, &owindows, owindows) {
349 DLOG("matching: %p / %s\n", current->con, current->con->name);
350 con_move_to_workspace(current->con, ws, true, false, false);
353 cmd_output->needs_tree_render = true;
354 // XXX: default reply for now, make this a better reply
359 * Implementation of 'move [--no-auto-back-and-forth] [window|container] [to] workspace <name>'.
362 void cmd_move_con_to_workspace_name(I3_CMD, const char *name, const char *_no_auto_back_and_forth) {
363 if (strncasecmp(name, "__", strlen("__")) == 0) {
364 LOG("You cannot move containers to i3-internal workspaces (\"%s\").\n", name);
369 const bool no_auto_back_and_forth = (_no_auto_back_and_forth != NULL);
372 /* We have nothing to move:
373 * when criteria was specified but didn't match any window or
374 * when criteria wasn't specified and we don't have any window focused. */
375 if (!match_is_empty(current_match) && TAILQ_EMPTY(&owindows)) {
376 ELOG("No windows match your criteria, cannot move.\n");
379 } else if (match_is_empty(current_match) && focused->type == CT_WORKSPACE &&
380 !con_has_children(focused)) {
385 LOG("should move window to workspace %s\n", name);
386 /* get the workspace */
387 Con *ws = workspace_get(name, NULL);
389 if (!no_auto_back_and_forth)
390 ws = maybe_auto_back_and_forth_workspace(ws);
394 TAILQ_FOREACH(current, &owindows, owindows) {
395 DLOG("matching: %p / %s\n", current->con, current->con->name);
396 con_move_to_workspace(current->con, ws, true, false, false);
399 cmd_output->needs_tree_render = true;
400 // XXX: default reply for now, make this a better reply
405 * Implementation of 'move [--no-auto-back-and-forth] [window|container] [to] workspace number <name>'.
408 void cmd_move_con_to_workspace_number(I3_CMD, const char *which, const char *_no_auto_back_and_forth) {
409 const bool no_auto_back_and_forth = (_no_auto_back_and_forth != NULL);
412 /* We have nothing to move:
413 * when criteria was specified but didn't match any window or
414 * when criteria wasn't specified and we don't have any window focused. */
415 if ((!match_is_empty(current_match) && TAILQ_EMPTY(&owindows)) ||
416 (match_is_empty(current_match) && focused->type == CT_WORKSPACE &&
417 !con_has_children(focused))) {
422 LOG("should move window to workspace %s\n", which);
423 /* get the workspace */
424 Con *output, *workspace = NULL;
426 long parsed_num = ws_name_to_number(which);
428 if (parsed_num == -1) {
429 LOG("Could not parse initial part of \"%s\" as a number.\n", which);
430 yerror("Could not parse number \"%s\"", which);
434 TAILQ_FOREACH(output, &(croot->nodes_head), nodes)
435 GREP_FIRST(workspace, output_get_content(output),
436 child->num == parsed_num);
439 workspace = workspace_get(which, NULL);
442 if (!no_auto_back_and_forth)
443 workspace = maybe_auto_back_and_forth_workspace(workspace);
447 TAILQ_FOREACH(current, &owindows, owindows) {
448 DLOG("matching: %p / %s\n", current->con, current->con->name);
449 con_move_to_workspace(current->con, workspace, true, false, false);
452 cmd_output->needs_tree_render = true;
453 // XXX: default reply for now, make this a better reply
457 static void cmd_resize_floating(I3_CMD, const char *way, const char *direction, Con *floating_con, int px) {
458 LOG("floating resize\n");
459 Rect old_rect = floating_con->rect;
460 Con *focused_con = con_descend_focused(floating_con);
462 /* ensure that resize will take place even if pixel increment is smaller than
463 * height increment or width increment.
465 const i3Window *window = focused_con->window;
466 if (window != NULL) {
467 if (strcmp(direction, "up") == 0 || strcmp(direction, "down") == 0 ||
468 strcmp(direction, "height") == 0) {
470 px = (-px < window->height_increment) ? -window->height_increment : px;
472 px = (px < window->height_increment) ? window->height_increment : px;
473 } else if (strcmp(direction, "left") == 0 || strcmp(direction, "right") == 0) {
475 px = (-px < window->width_increment) ? -window->width_increment : px;
477 px = (px < window->width_increment) ? window->width_increment : px;
481 if (strcmp(direction, "up") == 0) {
482 floating_con->rect.height += px;
483 } else if (strcmp(direction, "down") == 0 || strcmp(direction, "height") == 0) {
484 floating_con->rect.height += px;
485 } else if (strcmp(direction, "left") == 0) {
486 floating_con->rect.width += px;
488 floating_con->rect.width += px;
491 floating_check_size(floating_con);
493 /* Did we actually resize anything or did the size constraints prevent us?
494 * If we could not resize, exit now to not move the window. */
495 if (memcmp(&old_rect, &(floating_con->rect), sizeof(Rect)) == 0)
498 if (strcmp(direction, "up") == 0) {
499 floating_con->rect.y -= (floating_con->rect.height - old_rect.height);
500 } else if (strcmp(direction, "left") == 0) {
501 floating_con->rect.x -= (floating_con->rect.width - old_rect.width);
504 /* If this is a scratchpad window, don't auto center it from now on. */
505 if (floating_con->scratchpad_state == SCRATCHPAD_FRESH)
506 floating_con->scratchpad_state = SCRATCHPAD_CHANGED;
509 static bool cmd_resize_tiling_direction(I3_CMD, Con *current, const char *way, const char *direction, int ppt) {
510 LOG("tiling resize\n");
512 Con *first = current;
513 direction_t search_direction;
514 if (!strcmp(direction, "left"))
515 search_direction = D_LEFT;
516 else if (!strcmp(direction, "right"))
517 search_direction = D_RIGHT;
518 else if (!strcmp(direction, "up"))
519 search_direction = D_UP;
521 search_direction = D_DOWN;
523 bool res = resize_find_tiling_participants(&first, &second, search_direction);
525 LOG("No second container in this direction found.\n");
530 /* get the default percentage */
531 int children = con_num_children(first->parent);
532 LOG("ins. %d children\n", children);
533 double percentage = 1.0 / children;
534 LOG("default percentage = %f\n", percentage);
537 LOG("second->percent = %f\n", second->percent);
538 LOG("first->percent before = %f\n", first->percent);
539 if (first->percent == 0.0)
540 first->percent = percentage;
541 if (second->percent == 0.0)
542 second->percent = percentage;
543 double new_first_percent = first->percent + ((double)ppt / 100.0);
544 double new_second_percent = second->percent - ((double)ppt / 100.0);
545 LOG("new_first_percent = %f\n", new_first_percent);
546 LOG("new_second_percent = %f\n", new_second_percent);
547 /* Ensure that the new percentages are positive and greater than
548 * 0.05 to have a reasonable minimum size. */
549 if (definitelyGreaterThan(new_first_percent, 0.05, DBL_EPSILON) &&
550 definitelyGreaterThan(new_second_percent, 0.05, DBL_EPSILON)) {
551 first->percent += ((double)ppt / 100.0);
552 second->percent -= ((double)ppt / 100.0);
553 LOG("first->percent after = %f\n", first->percent);
554 LOG("second->percent after = %f\n", second->percent);
556 LOG("Not resizing, already at minimum size\n");
562 static bool cmd_resize_tiling_width_height(I3_CMD, Con *current, const char *way, const char *direction, int ppt) {
563 LOG("width/height resize\n");
564 /* get the appropriate current container (skip stacked/tabbed cons) */
565 while (current->parent->layout == L_STACKED ||
566 current->parent->layout == L_TABBED)
567 current = current->parent;
569 /* Then further go up until we find one with the matching orientation. */
570 orientation_t search_orientation =
571 (strcmp(direction, "width") == 0 ? HORIZ : VERT);
573 while (current->type != CT_WORKSPACE &&
574 current->type != CT_FLOATING_CON &&
575 (con_orientation(current->parent) != search_orientation || con_num_children(current->parent) == 1))
576 current = current->parent;
578 /* get the default percentage */
579 int children = con_num_children(current->parent);
580 LOG("ins. %d children\n", children);
581 double percentage = 1.0 / children;
582 LOG("default percentage = %f\n", percentage);
584 orientation_t orientation = con_orientation(current->parent);
586 if ((orientation == HORIZ &&
587 strcmp(direction, "height") == 0) ||
588 (orientation == VERT &&
589 strcmp(direction, "width") == 0)) {
590 LOG("You cannot resize in that direction. Your focus is in a %s split container currently.\n",
591 (orientation == HORIZ ? "horizontal" : "vertical"));
597 LOG("This is the only container, cannot resize.\n");
602 /* Ensure all the other children have a percentage set. */
604 TAILQ_FOREACH(child, &(current->parent->nodes_head), nodes) {
605 LOG("child->percent = %f (child %p)\n", child->percent, child);
606 if (child->percent == 0.0)
607 child->percent = percentage;
610 double new_current_percent = current->percent + ((double)ppt / 100.0);
611 double subtract_percent = ((double)ppt / 100.0) / (children - 1);
612 LOG("new_current_percent = %f\n", new_current_percent);
613 LOG("subtract_percent = %f\n", subtract_percent);
614 /* Ensure that the new percentages are positive and greater than
615 * 0.05 to have a reasonable minimum size. */
616 TAILQ_FOREACH(child, &(current->parent->nodes_head), nodes) {
617 if (child == current)
619 if (!definitelyGreaterThan(child->percent - subtract_percent, 0.05, DBL_EPSILON)) {
620 LOG("Not resizing, already at minimum size (child %p would end up with a size of %.f\n", child, child->percent - subtract_percent);
625 if (!definitelyGreaterThan(new_current_percent, 0.05, DBL_EPSILON)) {
626 LOG("Not resizing, already at minimum size\n");
631 current->percent += ((double)ppt / 100.0);
632 LOG("current->percent after = %f\n", current->percent);
634 TAILQ_FOREACH(child, &(current->parent->nodes_head), nodes) {
635 if (child == current)
637 child->percent -= subtract_percent;
638 LOG("child->percent after (%p) = %f\n", child, child->percent);
645 * Implementation of 'resize grow|shrink <direction> [<px> px] [or <ppt> ppt]'.
648 void cmd_resize(I3_CMD, const char *way, const char *direction, long resize_px, long resize_ppt) {
649 DLOG("resizing in way %s, direction %s, px %ld or ppt %ld\n", way, direction, resize_px, resize_ppt);
650 if (strcmp(way, "shrink") == 0) {
658 TAILQ_FOREACH(current, &owindows, owindows) {
659 /* Don't handle dock windows (issue #1201) */
660 if (current->con->window && current->con->window->dock) {
661 DLOG("This is a dock window. Not resizing (con = %p)\n)", current->con);
666 if ((floating_con = con_inside_floating(current->con))) {
667 cmd_resize_floating(current_match, cmd_output, way, direction, floating_con, resize_px);
669 if (strcmp(direction, "width") == 0 ||
670 strcmp(direction, "height") == 0) {
671 if (!cmd_resize_tiling_width_height(current_match, cmd_output,
672 current->con, way, direction, resize_ppt))
675 if (!cmd_resize_tiling_direction(current_match, cmd_output,
676 current->con, way, direction, resize_ppt))
682 cmd_output->needs_tree_render = true;
683 // XXX: default reply for now, make this a better reply
688 * Implementation of 'resize set <px> [px] <px> [px]'.
691 void cmd_resize_set(I3_CMD, long cwidth, long cheight) {
692 DLOG("resizing to %ldx%ld px\n", cwidth, cheight);
693 if (cwidth <= 0 || cheight <= 0) {
694 ELOG("Resize failed: dimensions cannot be negative (was %ldx%ld)\n", cwidth, cheight);
701 TAILQ_FOREACH(current, &owindows, owindows) {
703 if ((floating_con = con_inside_floating(current->con))) {
704 floating_resize(floating_con, cwidth, cheight);
706 ELOG("Resize failed: %p not a floating container\n", current->con);
710 cmd_output->needs_tree_render = true;
711 // XXX: default reply for now, make this a better reply
716 * Implementation of 'border normal|pixel [<n>]', 'border none|1pixel|toggle'.
719 void cmd_border(I3_CMD, const char *border_style_str, long border_width) {
720 DLOG("border style should be changed to %s with border width %ld\n", border_style_str, border_width);
725 TAILQ_FOREACH(current, &owindows, owindows) {
726 DLOG("matching: %p / %s\n", current->con, current->con->name);
727 int border_style = current->con->border_style;
728 int con_border_width = border_width;
730 if (strcmp(border_style_str, "toggle") == 0) {
733 if (border_style == BS_NORMAL)
734 con_border_width = 2;
735 else if (border_style == BS_NONE)
736 con_border_width = 0;
737 else if (border_style == BS_PIXEL)
738 con_border_width = 1;
740 if (strcmp(border_style_str, "normal") == 0) {
741 border_style = BS_NORMAL;
742 } else if (strcmp(border_style_str, "pixel") == 0) {
743 border_style = BS_PIXEL;
744 } else if (strcmp(border_style_str, "1pixel") == 0) {
745 border_style = BS_PIXEL;
746 con_border_width = 1;
747 } else if (strcmp(border_style_str, "none") == 0) {
748 border_style = BS_NONE;
750 ELOG("BUG: called with border_style=%s\n", border_style_str);
756 con_set_border_style(current->con, border_style, logical_px(con_border_width));
759 cmd_output->needs_tree_render = true;
760 // XXX: default reply for now, make this a better reply
765 * Implementation of 'nop <comment>'.
768 void cmd_nop(I3_CMD, const char *comment) {
769 LOG("-------------------------------------------------\n");
770 LOG(" NOP: %s\n", comment);
771 LOG("-------------------------------------------------\n");
775 * Implementation of 'append_layout <path>'.
778 void cmd_append_layout(I3_CMD, const char *cpath) {
779 char *path = sstrdup(cpath);
780 LOG("Appending layout \"%s\"\n", path);
782 /* Make sure we allow paths like '~/.i3/layout.json' */
783 path = resolve_tilde(path);
785 json_content_t content = json_determine_content(path);
786 LOG("JSON content = %d\n", content);
787 if (content == JSON_CONTENT_UNKNOWN) {
788 ELOG("Could not determine the contents of \"%s\", not loading.\n", path);
789 yerror("Could not determine the contents of \"%s\".", path);
794 Con *parent = focused;
795 if (content == JSON_CONTENT_WORKSPACE) {
796 parent = output_get_content(con_get_output(parent));
798 /* We need to append the layout to a split container, since a leaf
799 * container must not have any children (by definition).
800 * Note that we explicitly check for workspaces, since they are okay for
801 * this purpose, but con_accepts_window() returns false for workspaces. */
802 while (parent->type != CT_WORKSPACE && !con_accepts_window(parent))
803 parent = parent->parent;
805 DLOG("Appending to parent=%p instead of focused=%p\n", parent, focused);
806 char *errormsg = NULL;
807 tree_append_json(parent, path, &errormsg);
808 if (errormsg != NULL) {
811 /* Note that we continue executing since tree_append_json() has
812 * side-effects — user-provided layouts can be partly valid, partly
813 * invalid, leading to half of the placeholder containers being
819 // XXX: This is a bit of a kludge. Theoretically, render_con(parent,
820 // false); should be enough, but when sending 'workspace 4; append_layout
821 // /tmp/foo.json', the needs_tree_render == true of the workspace command
822 // is not executed yet and will be batched with append_layout’s
823 // needs_tree_render after the parser finished. We should check if that is
825 render_con(croot, false);
827 restore_open_placeholder_windows(parent);
829 if (content == JSON_CONTENT_WORKSPACE)
830 ipc_send_workspace_event("restored", parent, NULL);
833 cmd_output->needs_tree_render = true;
837 * Implementation of 'workspace next|prev|next_on_output|prev_on_output'.
840 void cmd_workspace(I3_CMD, const char *which) {
843 DLOG("which=%s\n", which);
845 if (con_get_fullscreen_con(croot, CF_GLOBAL)) {
846 LOG("Cannot switch workspace while in global fullscreen\n");
851 if (strcmp(which, "next") == 0)
852 ws = workspace_next();
853 else if (strcmp(which, "prev") == 0)
854 ws = workspace_prev();
855 else if (strcmp(which, "next_on_output") == 0)
856 ws = workspace_next_on_output();
857 else if (strcmp(which, "prev_on_output") == 0)
858 ws = workspace_prev_on_output();
860 ELOG("BUG: called with which=%s\n", which);
867 cmd_output->needs_tree_render = true;
868 // XXX: default reply for now, make this a better reply
873 * Implementation of 'workspace [--no-auto-back-and-forth] number <name>'
876 void cmd_workspace_number(I3_CMD, const char *which, const char *_no_auto_back_and_forth) {
877 const bool no_auto_back_and_forth = (_no_auto_back_and_forth != NULL);
878 Con *output, *workspace = NULL;
880 if (con_get_fullscreen_con(croot, CF_GLOBAL)) {
881 LOG("Cannot switch workspace while in global fullscreen\n");
886 long parsed_num = ws_name_to_number(which);
888 if (parsed_num == -1) {
889 LOG("Could not parse initial part of \"%s\" as a number.\n", which);
890 yerror("Could not parse number \"%s\"", which);
894 TAILQ_FOREACH(output, &(croot->nodes_head), nodes)
895 GREP_FIRST(workspace, output_get_content(output),
896 child->num == parsed_num);
899 LOG("There is no workspace with number %ld, creating a new one.\n", parsed_num);
901 workspace_show_by_name(which);
902 cmd_output->needs_tree_render = true;
905 if (!no_auto_back_and_forth && maybe_back_and_forth(cmd_output, workspace->name))
907 workspace_show(workspace);
909 cmd_output->needs_tree_render = true;
910 // XXX: default reply for now, make this a better reply
915 * Implementation of 'workspace back_and_forth'.
918 void cmd_workspace_back_and_forth(I3_CMD) {
919 if (con_get_fullscreen_con(croot, CF_GLOBAL)) {
920 LOG("Cannot switch workspace while in global fullscreen\n");
925 workspace_back_and_forth();
927 cmd_output->needs_tree_render = true;
928 // XXX: default reply for now, make this a better reply
933 * Implementation of 'workspace [--no-auto-back-and-forth] <name>'
936 void cmd_workspace_name(I3_CMD, const char *name, const char *_no_auto_back_and_forth) {
937 const bool no_auto_back_and_forth = (_no_auto_back_and_forth != NULL);
939 if (strncasecmp(name, "__", strlen("__")) == 0) {
940 LOG("You cannot switch to the i3-internal workspaces (\"%s\").\n", name);
945 if (con_get_fullscreen_con(croot, CF_GLOBAL)) {
946 LOG("Cannot switch workspace while in global fullscreen\n");
951 DLOG("should switch to workspace %s\n", name);
952 if (!no_auto_back_and_forth && maybe_back_and_forth(cmd_output, name))
954 workspace_show_by_name(name);
956 cmd_output->needs_tree_render = true;
957 // XXX: default reply for now, make this a better reply
962 * Implementation of 'mark [--add|--replace] [--toggle] <mark>'
965 void cmd_mark(I3_CMD, const char *mark, const char *mode, const char *toggle) {
968 owindow *current = TAILQ_FIRST(&owindows);
969 if (current == NULL) {
974 /* Marks must be unique, i.e., no two windows must have the same mark. */
975 if (current != TAILQ_LAST(&owindows, owindows_head)) {
976 yerror("A mark must not be put onto more than one window");
980 DLOG("matching: %p / %s\n", current->con, current->con->name);
982 mark_mode_t mark_mode = (mode == NULL || strcmp(mode, "--replace") == 0) ? MM_REPLACE : MM_ADD;
983 if (toggle != NULL) {
984 con_mark_toggle(current->con, mark, mark_mode);
986 con_mark(current->con, mark, mark_mode);
989 cmd_output->needs_tree_render = true;
990 // XXX: default reply for now, make this a better reply
995 * Implementation of 'unmark [mark]'
998 void cmd_unmark(I3_CMD, const char *mark) {
999 if (match_is_empty(current_match)) {
1000 con_unmark(NULL, mark);
1003 TAILQ_FOREACH(current, &owindows, owindows) {
1004 con_unmark(current->con, mark);
1008 cmd_output->needs_tree_render = true;
1009 // XXX: default reply for now, make this a better reply
1014 * Implementation of 'mode <string>'.
1017 void cmd_mode(I3_CMD, const char *mode) {
1018 DLOG("mode=%s\n", mode);
1021 // XXX: default reply for now, make this a better reply
1026 * Implementation of 'move [window|container] [to] output <str>'.
1029 void cmd_move_con_to_output(I3_CMD, const char *name) {
1030 DLOG("Should move window to output \"%s\".\n", name);
1034 bool had_error = false;
1035 TAILQ_FOREACH(current, &owindows, owindows) {
1036 DLOG("matching: %p / %s\n", current->con, current->con->name);
1038 Output *current_output = get_output_of_con(current->con);
1039 assert(current_output != NULL);
1041 Output *output = get_output_from_string(current_output, name);
1042 if (output == NULL) {
1043 ELOG("Could not find output \"%s\", skipping.\n", name);
1049 GREP_FIRST(ws, output_get_content(output->con), workspace_is_visible(child));
1051 ELOG("Could not find a visible workspace on output %p.\n", output);
1056 con_move_to_workspace(current->con, ws, true, false, false);
1059 cmd_output->needs_tree_render = true;
1060 ysuccess(!had_error);
1064 * Implementation of 'move [container|window] [to] mark <str>'.
1067 void cmd_move_con_to_mark(I3_CMD, const char *mark) {
1068 DLOG("moving window to mark \"%s\"\n", mark);
1074 TAILQ_FOREACH(current, &owindows, owindows) {
1075 DLOG("moving matched window %p / %s to mark \"%s\"\n", current->con, current->con->name, mark);
1076 result &= con_move_to_mark(current->con, mark);
1079 cmd_output->needs_tree_render = true;
1084 * Implementation of 'floating enable|disable|toggle'
1087 void cmd_floating(I3_CMD, const char *floating_mode) {
1090 DLOG("floating_mode=%s\n", floating_mode);
1094 TAILQ_FOREACH(current, &owindows, owindows) {
1095 DLOG("matching: %p / %s\n", current->con, current->con->name);
1096 if (strcmp(floating_mode, "toggle") == 0) {
1097 DLOG("should toggle mode\n");
1098 toggle_floating_mode(current->con, false);
1100 DLOG("should switch mode to %s\n", floating_mode);
1101 if (strcmp(floating_mode, "enable") == 0) {
1102 floating_enable(current->con, false);
1104 floating_disable(current->con, false);
1109 cmd_output->needs_tree_render = true;
1110 // XXX: default reply for now, make this a better reply
1115 * Implementation of 'move workspace to [output] <str>'.
1118 void cmd_move_workspace_to_output(I3_CMD, const char *name) {
1119 DLOG("should move workspace to output %s\n", name);
1124 TAILQ_FOREACH(current, &owindows, owindows) {
1125 Con *ws = con_get_workspace(current->con);
1126 bool success = workspace_move_to_output(ws, name);
1128 ELOG("Failed to move workspace to output.\n");
1134 cmd_output->needs_tree_render = true;
1135 // XXX: default reply for now, make this a better reply
1140 * Implementation of 'split v|h|t|vertical|horizontal|toggle'.
1143 void cmd_split(I3_CMD, const char *direction) {
1147 LOG("splitting in direction %c\n", direction[0]);
1148 TAILQ_FOREACH(current, &owindows, owindows) {
1149 if (con_is_docked(current->con)) {
1150 ELOG("Cannot split a docked container, skipping.\n");
1154 DLOG("matching: %p / %s\n", current->con, current->con->name);
1155 if (direction[0] == 't') {
1156 layout_t current_layout;
1157 if (current->con->type == CT_WORKSPACE) {
1158 current_layout = current->con->layout;
1160 current_layout = current->con->parent->layout;
1162 /* toggling split orientation */
1163 if (current_layout == L_SPLITH) {
1164 tree_split(current->con, VERT);
1166 tree_split(current->con, HORIZ);
1169 tree_split(current->con, (direction[0] == 'v' ? VERT : HORIZ));
1172 DLOG("matching: %p / %s\n", current->con, current->con->name);
1173 tree_split(current->con, (direction[0] == 'v' ? VERT : HORIZ));
1176 cmd_output->needs_tree_render = true;
1177 // XXX: default reply for now, make this a better reply
1182 * Implementation of 'kill [window|client]'.
1185 void cmd_kill(I3_CMD, const char *kill_mode_str) {
1186 if (kill_mode_str == NULL)
1187 kill_mode_str = "window";
1189 DLOG("kill_mode=%s\n", kill_mode_str);
1192 if (strcmp(kill_mode_str, "window") == 0)
1193 kill_mode = KILL_WINDOW;
1194 else if (strcmp(kill_mode_str, "client") == 0)
1195 kill_mode = KILL_CLIENT;
1197 ELOG("BUG: called with kill_mode=%s\n", kill_mode_str);
1205 TAILQ_FOREACH(current, &owindows, owindows) {
1206 con_close(current->con, kill_mode);
1209 cmd_output->needs_tree_render = true;
1210 // XXX: default reply for now, make this a better reply
1215 * Implementation of 'exec [--no-startup-id] <command>'.
1218 void cmd_exec(I3_CMD, const char *nosn, const char *command) {
1219 bool no_startup_id = (nosn != NULL);
1221 DLOG("should execute %s, no_startup_id = %d\n", command, no_startup_id);
1222 start_application(command, no_startup_id);
1224 // XXX: default reply for now, make this a better reply
1229 * Implementation of 'focus left|right|up|down'.
1232 void cmd_focus_direction(I3_CMD, const char *direction) {
1233 DLOG("direction = *%s*\n", direction);
1235 if (strcmp(direction, "left") == 0)
1236 tree_next('p', HORIZ);
1237 else if (strcmp(direction, "right") == 0)
1238 tree_next('n', HORIZ);
1239 else if (strcmp(direction, "up") == 0)
1240 tree_next('p', VERT);
1241 else if (strcmp(direction, "down") == 0)
1242 tree_next('n', VERT);
1244 ELOG("Invalid focus direction (%s)\n", direction);
1249 cmd_output->needs_tree_render = true;
1250 // XXX: default reply for now, make this a better reply
1255 * Implementation of 'focus tiling|floating|mode_toggle'.
1258 void cmd_focus_window_mode(I3_CMD, const char *window_mode) {
1259 DLOG("window_mode = %s\n", window_mode);
1261 Con *ws = con_get_workspace(focused);
1263 if (strcmp(window_mode, "mode_toggle") == 0) {
1264 if (con_inside_floating(focused))
1265 window_mode = "tiling";
1267 window_mode = "floating";
1270 TAILQ_FOREACH(current, &(ws->focus_head), focused) {
1271 if ((strcmp(window_mode, "floating") == 0 && current->type != CT_FLOATING_CON) ||
1272 (strcmp(window_mode, "tiling") == 0 && current->type == CT_FLOATING_CON))
1275 con_focus(con_descend_focused(current));
1280 cmd_output->needs_tree_render = true;
1281 // XXX: default reply for now, make this a better reply
1286 * Implementation of 'focus parent|child'.
1289 void cmd_focus_level(I3_CMD, const char *level) {
1290 DLOG("level = %s\n", level);
1291 bool success = false;
1293 /* Focusing the parent can only be allowed if the newly
1294 * focused container won't escape the fullscreen container. */
1295 if (strcmp(level, "parent") == 0) {
1296 if (focused && focused->parent) {
1297 if (con_fullscreen_permits_focusing(focused->parent))
1298 success = level_up();
1300 ELOG("'focus parent': Currently in fullscreen, not going up\n");
1304 /* Focusing a child should always be allowed. */
1306 success = level_down();
1308 cmd_output->needs_tree_render = success;
1309 // XXX: default reply for now, make this a better reply
1314 * Implementation of 'focus'.
1317 void cmd_focus(I3_CMD) {
1318 DLOG("current_match = %p\n", current_match);
1320 if (match_is_empty(current_match)) {
1321 ELOG("You have to specify which window/container should be focused.\n");
1322 ELOG("Example: [class=\"urxvt\" title=\"irssi\"] focus\n");
1324 yerror("You have to specify which window/container should be focused");
1329 Con *__i3_scratch = workspace_get("__i3_scratch", NULL);
1332 TAILQ_FOREACH(current, &owindows, owindows) {
1333 Con *ws = con_get_workspace(current->con);
1334 /* If no workspace could be found, this was a dock window.
1335 * Just skip it, you cannot focus dock windows. */
1339 /* Check the fullscreen focus constraints. */
1340 if (!con_fullscreen_permits_focusing(current->con)) {
1341 LOG("Cannot change focus while in fullscreen mode (fullscreen rules).\n");
1346 /* In case this is a scratchpad window, call scratchpad_show(). */
1347 if (ws == __i3_scratch) {
1348 scratchpad_show(current->con);
1350 /* While for the normal focus case we can change focus multiple
1351 * times and only a single window ends up focused, we could show
1352 * multiple scratchpad windows. So, rather break here. */
1356 /* If the container is not on the current workspace,
1357 * workspace_show() will switch to a different workspace and (if
1358 * enabled) trigger a mouse pointer warp to the currently focused
1359 * container (!) on the target workspace.
1361 * Therefore, before calling workspace_show(), we make sure that
1362 * 'current' will be focused on the workspace. However, we cannot
1363 * just con_focus(current) because then the pointer will not be
1364 * warped at all (the code thinks we are already there).
1366 * So we focus 'current' to make it the currently focused window of
1367 * the target workspace, then revert focus. */
1368 Con *currently_focused = focused;
1369 con_focus(current->con);
1370 con_focus(currently_focused);
1372 /* Now switch to the workspace, then focus */
1374 LOG("focusing %p / %s\n", current->con, current->con->name);
1375 con_focus(current->con);
1380 LOG("WARNING: Your criteria for the focus command matches %d containers, "
1381 "while only exactly one container can be focused at a time.\n",
1384 cmd_output->needs_tree_render = true;
1385 ysuccess(count > 0);
1389 * Implementation of 'fullscreen enable|toggle [global]' and
1390 * 'fullscreen disable'
1393 void cmd_fullscreen(I3_CMD, const char *action, const char *fullscreen_mode) {
1394 fullscreen_mode_t mode = strcmp(fullscreen_mode, "global") == 0 ? CF_GLOBAL : CF_OUTPUT;
1395 DLOG("%s fullscreen, mode = %s\n", action, fullscreen_mode);
1400 TAILQ_FOREACH(current, &owindows, owindows) {
1401 DLOG("matching: %p / %s\n", current->con, current->con->name);
1402 if (strcmp(action, "toggle") == 0) {
1403 con_toggle_fullscreen(current->con, mode);
1404 } else if (strcmp(action, "enable") == 0) {
1405 con_enable_fullscreen(current->con, mode);
1406 } else if (strcmp(action, "disable") == 0) {
1407 con_disable_fullscreen(current->con);
1411 cmd_output->needs_tree_render = true;
1412 // XXX: default reply for now, make this a better reply
1417 * Implementation of 'sticky enable|disable|toggle'.
1420 void cmd_sticky(I3_CMD, const char *action) {
1421 DLOG("%s sticky on window\n", action);
1425 TAILQ_FOREACH(current, &owindows, owindows) {
1426 if (current->con->window == NULL) {
1427 ELOG("only containers holding a window can be made sticky, skipping con = %p\n", current->con);
1430 DLOG("setting sticky for container = %p / %s\n", current->con, current->con->name);
1432 bool sticky = false;
1433 if (strcmp(action, "enable") == 0)
1435 else if (strcmp(action, "disable") == 0)
1437 else if (strcmp(action, "toggle") == 0)
1438 sticky = !current->con->sticky;
1440 current->con->sticky = sticky;
1441 ewmh_update_sticky(current->con->window->id, sticky);
1444 /* A window we made sticky might not be on a visible workspace right now, so we need to make
1445 * sure it gets pushed to the front now. */
1446 output_push_sticky_windows(focused);
1448 ewmh_update_wm_desktop();
1450 cmd_output->needs_tree_render = true;
1455 * Implementation of 'move <direction> [<pixels> [px]]'.
1458 void cmd_move_direction(I3_CMD, const char *direction, long move_px) {
1462 Con *initially_focused = focused;
1464 TAILQ_FOREACH(current, &owindows, owindows) {
1465 DLOG("moving in direction %s, px %ld\n", direction, move_px);
1466 if (con_is_floating(current->con)) {
1467 DLOG("floating move with %ld pixels\n", move_px);
1468 Rect newrect = current->con->parent->rect;
1469 if (strcmp(direction, "left") == 0) {
1470 newrect.x -= move_px;
1471 } else if (strcmp(direction, "right") == 0) {
1472 newrect.x += move_px;
1473 } else if (strcmp(direction, "up") == 0) {
1474 newrect.y -= move_px;
1475 } else if (strcmp(direction, "down") == 0) {
1476 newrect.y += move_px;
1478 floating_reposition(current->con->parent, newrect);
1480 tree_move(current->con, (strcmp(direction, "right") == 0 ? D_RIGHT : (strcmp(direction, "left") == 0 ? D_LEFT : (strcmp(direction, "up") == 0 ? D_UP : D_DOWN))));
1481 cmd_output->needs_tree_render = true;
1485 /* the move command should not disturb focus */
1486 if (focused != initially_focused)
1487 con_focus(initially_focused);
1489 // XXX: default reply for now, make this a better reply
1494 * Implementation of 'layout default|stacked|stacking|tabbed|splitv|splith'.
1497 void cmd_layout(I3_CMD, const char *layout_str) {
1500 if (strcmp(layout_str, "stacking") == 0)
1501 layout_str = "stacked";
1503 /* default is a special case which will be handled in con_set_layout(). */
1504 if (strcmp(layout_str, "default") == 0)
1506 else if (strcmp(layout_str, "stacked") == 0)
1508 else if (strcmp(layout_str, "tabbed") == 0)
1510 else if (strcmp(layout_str, "splitv") == 0)
1512 else if (strcmp(layout_str, "splith") == 0)
1515 ELOG("Unknown layout \"%s\", this is a mismatch between code and parser spec.\n", layout_str);
1519 DLOG("changing layout to %s (%d)\n", layout_str, layout);
1522 TAILQ_FOREACH(current, &owindows, owindows) {
1523 if (con_is_docked(current->con)) {
1524 ELOG("cannot change layout of a docked container, skipping it.\n");
1528 DLOG("matching: %p / %s\n", current->con, current->con->name);
1529 con_set_layout(current->con, layout);
1532 cmd_output->needs_tree_render = true;
1533 // XXX: default reply for now, make this a better reply
1538 * Implementation of 'layout toggle [all|split]'.
1541 void cmd_layout_toggle(I3_CMD, const char *toggle_mode) {
1544 if (toggle_mode == NULL)
1545 toggle_mode = "default";
1547 DLOG("toggling layout (mode = %s)\n", toggle_mode);
1549 /* check if the match is empty, not if the result is empty */
1550 if (match_is_empty(current_match))
1551 con_toggle_layout(focused, toggle_mode);
1553 TAILQ_FOREACH(current, &owindows, owindows) {
1554 DLOG("matching: %p / %s\n", current->con, current->con->name);
1555 con_toggle_layout(current->con, toggle_mode);
1559 cmd_output->needs_tree_render = true;
1560 // XXX: default reply for now, make this a better reply
1565 * Implementation of 'exit'.
1568 void cmd_exit(I3_CMD) {
1569 LOG("Exiting due to user command.\n");
1570 #ifdef I3_ASAN_ENABLED
1571 __lsan_do_leak_check();
1574 unlink(config.ipc_socket_path);
1575 xcb_disconnect(conn);
1582 * Implementation of 'reload'.
1585 void cmd_reload(I3_CMD) {
1587 kill_nagbar(&config_error_nagbar_pid, false);
1588 kill_nagbar(&command_error_nagbar_pid, false);
1589 load_configuration(conn, NULL, true);
1591 /* Send an IPC event just in case the ws names have changed */
1592 ipc_send_workspace_event("reload", NULL, NULL);
1593 /* Send an update event for the barconfig just in case it has changed */
1596 // XXX: default reply for now, make this a better reply
1601 * Implementation of 'restart'.
1604 void cmd_restart(I3_CMD) {
1605 LOG("restarting i3\n");
1607 unlink(config.ipc_socket_path);
1608 /* We need to call this manually since atexit handlers don’t get called
1610 purge_zerobyte_logfile();
1613 // XXX: default reply for now, make this a better reply
1618 * Implementation of 'open'.
1621 void cmd_open(I3_CMD) {
1622 LOG("opening new container\n");
1623 Con *con = tree_open_con(NULL, NULL);
1624 con->layout = L_SPLITH;
1631 y(integer, (long int)con);
1634 cmd_output->needs_tree_render = true;
1638 * Implementation of 'focus output <output>'.
1641 void cmd_focus_output(I3_CMD, const char *name) {
1644 DLOG("name = %s\n", name);
1648 /* get the output */
1649 Output *current_output = NULL;
1652 TAILQ_FOREACH(current, &owindows, owindows)
1653 current_output = get_output_of_con(current->con);
1654 assert(current_output != NULL);
1656 output = get_output_from_string(current_output, name);
1659 LOG("No such output found.\n");
1664 /* get visible workspace on output */
1666 GREP_FIRST(ws, output_get_content(output->con), workspace_is_visible(child));
1674 cmd_output->needs_tree_render = true;
1675 // XXX: default reply for now, make this a better reply
1680 * Implementation of 'move [window|container] [to] [absolute] position <px> [px] <px> [px]
1683 void cmd_move_window_to_position(I3_CMD, const char *method, long x, long y) {
1684 bool has_error = false;
1689 TAILQ_FOREACH(current, &owindows, owindows) {
1690 if (!con_is_floating(current->con)) {
1691 ELOG("Cannot change position. The window/container is not floating\n");
1694 yerror("Cannot change position of a window/container because it is not floating.");
1701 if (strcmp(method, "absolute") == 0) {
1702 current->con->parent->rect.x = x;
1703 current->con->parent->rect.y = y;
1705 DLOG("moving to absolute position %ld %ld\n", x, y);
1706 floating_maybe_reassign_ws(current->con->parent);
1707 cmd_output->needs_tree_render = true;
1710 if (strcmp(method, "position") == 0) {
1711 Rect newrect = current->con->parent->rect;
1713 DLOG("moving to position %ld %ld\n", x, y);
1717 floating_reposition(current->con->parent, newrect);
1721 // XXX: default reply for now, make this a better reply
1727 * Implementation of 'move [window|container] [to] [absolute] position center
1730 void cmd_move_window_to_center(I3_CMD, const char *method) {
1731 bool has_error = false;
1735 TAILQ_FOREACH(current, &owindows, owindows) {
1736 Con *floating_con = con_inside_floating(current->con);
1737 if (floating_con == NULL) {
1738 ELOG("con %p / %s is not floating, cannot move it to the center.\n",
1739 current->con, current->con->name);
1742 yerror("Cannot change position of a window/container because it is not floating.");
1749 if (strcmp(method, "absolute") == 0) {
1750 DLOG("moving to absolute center\n");
1751 floating_center(floating_con, croot->rect);
1753 floating_maybe_reassign_ws(floating_con);
1754 cmd_output->needs_tree_render = true;
1757 if (strcmp(method, "position") == 0) {
1758 DLOG("moving to center\n");
1759 floating_center(floating_con, con_get_workspace(floating_con)->rect);
1761 cmd_output->needs_tree_render = true;
1765 // XXX: default reply for now, make this a better reply
1771 * Implementation of 'move [window|container] [to] position mouse'
1774 void cmd_move_window_to_mouse(I3_CMD) {
1778 TAILQ_FOREACH(current, &owindows, owindows) {
1779 Con *floating_con = con_inside_floating(current->con);
1780 if (floating_con == NULL) {
1781 DLOG("con %p / %s is not floating, cannot move it to the mouse position.\n",
1782 current->con, current->con->name);
1786 DLOG("moving floating container %p / %s to cursor position\n", floating_con, floating_con->name);
1787 floating_move_to_pointer(floating_con);
1790 cmd_output->needs_tree_render = true;
1795 * Implementation of 'move scratchpad'.
1798 void cmd_move_scratchpad(I3_CMD) {
1799 DLOG("should move window to scratchpad\n");
1804 TAILQ_FOREACH(current, &owindows, owindows) {
1805 DLOG("matching: %p / %s\n", current->con, current->con->name);
1806 scratchpad_move(current->con);
1809 cmd_output->needs_tree_render = true;
1810 // XXX: default reply for now, make this a better reply
1815 * Implementation of 'scratchpad show'.
1818 void cmd_scratchpad_show(I3_CMD) {
1819 DLOG("should show scratchpad window\n");
1822 if (match_is_empty(current_match)) {
1823 scratchpad_show(NULL);
1825 TAILQ_FOREACH(current, &owindows, owindows) {
1826 DLOG("matching: %p / %s\n", current->con, current->con->name);
1827 scratchpad_show(current->con);
1831 cmd_output->needs_tree_render = true;
1832 // XXX: default reply for now, make this a better reply
1837 * Implementation of 'title_format <format>'
1840 void cmd_title_format(I3_CMD, const char *format) {
1841 DLOG("setting title_format to \"%s\"\n", format);
1845 TAILQ_FOREACH(current, &owindows, owindows) {
1846 DLOG("setting title_format for %p / %s\n", current->con, current->con->name);
1847 FREE(current->con->title_format);
1849 /* If we only display the title without anything else, we can skip the parsing step,
1850 * so we remove the title format altogether. */
1851 if (strcasecmp(format, "%title") != 0) {
1852 current->con->title_format = sstrdup(format);
1854 if (current->con->window != NULL) {
1855 i3String *formatted_title = con_parse_title_format(current->con);
1856 ewmh_update_visible_name(current->con->window->id, i3string_as_utf8(formatted_title));
1857 I3STRING_FREE(formatted_title);
1860 if (current->con->window != NULL) {
1861 /* We can remove _NET_WM_VISIBLE_NAME since we don't display a custom title. */
1862 ewmh_update_visible_name(current->con->window->id, NULL);
1866 if (current->con->window != NULL) {
1867 /* Make sure the window title is redrawn immediately. */
1868 current->con->window->name_x_changed = true;
1870 /* For windowless containers we also need to force the redrawing. */
1871 FREE(current->con->deco_render_params);
1875 cmd_output->needs_tree_render = true;
1880 * Implementation of 'rename workspace [<name>] to <name>'
1883 void cmd_rename_workspace(I3_CMD, const char *old_name, const char *new_name) {
1884 if (strncasecmp(new_name, "__", strlen("__")) == 0) {
1885 LOG("Cannot rename workspace to \"%s\": names starting with __ are i3-internal.\n", new_name);
1890 LOG("Renaming workspace \"%s\" to \"%s\"\n", old_name, new_name);
1892 LOG("Renaming current workspace to \"%s\"\n", new_name);
1895 Con *output, *workspace = NULL;
1897 TAILQ_FOREACH(output, &(croot->nodes_head), nodes)
1898 GREP_FIRST(workspace, output_get_content(output),
1899 !strcasecmp(child->name, old_name));
1901 workspace = con_get_workspace(focused);
1902 old_name = workspace->name;
1906 yerror("Old workspace \"%s\" not found", old_name);
1910 Con *check_dest = NULL;
1911 TAILQ_FOREACH(output, &(croot->nodes_head), nodes)
1912 GREP_FIRST(check_dest, output_get_content(output),
1913 !strcasecmp(child->name, new_name));
1915 /* If check_dest == workspace, the user might be changing the case of the
1916 * workspace, or it might just be a no-op. */
1917 if (check_dest != NULL && check_dest != workspace) {
1918 yerror("New workspace \"%s\" already exists", new_name);
1922 /* Change the name and try to parse it as a number. */
1923 /* old_name might refer to workspace->name, so copy it before free()ing */
1924 char *old_name_copy = sstrdup(old_name);
1925 FREE(workspace->name);
1926 workspace->name = sstrdup(new_name);
1928 workspace->num = ws_name_to_number(new_name);
1929 LOG("num = %d\n", workspace->num);
1931 /* By re-attaching, the sort order will be correct afterwards. */
1932 Con *previously_focused = focused;
1933 Con *parent = workspace->parent;
1934 con_detach(workspace);
1935 con_attach(workspace, parent, false);
1937 /* Move the workspace to the correct output if it has an assignment */
1938 struct Workspace_Assignment *assignment = NULL;
1939 TAILQ_FOREACH(assignment, &ws_assignments, ws_assignments) {
1940 if (assignment->output == NULL)
1942 if (strcmp(assignment->name, workspace->name) != 0 && (!name_is_digits(assignment->name) || ws_name_to_number(assignment->name) != workspace->num)) {
1946 workspace_move_to_output(workspace, assignment->output);
1948 if (previously_focused)
1949 workspace_show(con_get_workspace(previously_focused));
1954 /* Restore the previous focus since con_attach messes with the focus. */
1955 con_focus(previously_focused);
1957 cmd_output->needs_tree_render = true;
1960 ipc_send_workspace_event("rename", workspace, NULL);
1961 ewmh_update_desktop_names();
1962 ewmh_update_desktop_viewport();
1963 ewmh_update_current_desktop();
1965 startup_sequence_rename_workspace(old_name_copy, new_name);
1966 free(old_name_copy);
1970 * Implementation of 'bar mode dock|hide|invisible|toggle [<bar_id>]'
1973 bool cmd_bar_mode(const char *bar_mode, const char *bar_id) {
1975 bool toggle = false;
1976 if (strcmp(bar_mode, "dock") == 0)
1978 else if (strcmp(bar_mode, "hide") == 0)
1980 else if (strcmp(bar_mode, "invisible") == 0)
1982 else if (strcmp(bar_mode, "toggle") == 0)
1985 ELOG("Unknown bar mode \"%s\", this is a mismatch between code and parser spec.\n", bar_mode);
1989 bool changed_sth = false;
1990 Barconfig *current = NULL;
1991 TAILQ_FOREACH(current, &barconfigs, configs) {
1992 if (bar_id && strcmp(current->id, bar_id) != 0)
1996 mode = (current->mode + 1) % 2;
1998 DLOG("Changing bar mode of bar_id '%s' to '%s (%d)'\n", current->id, bar_mode, mode);
1999 current->mode = mode;
2006 if (bar_id && !changed_sth) {
2007 DLOG("Changing bar mode of bar_id %s failed, bar_id not found.\n", bar_id);
2015 * Implementation of 'bar hidden_state hide|show|toggle [<bar_id>]'
2018 bool cmd_bar_hidden_state(const char *bar_hidden_state, const char *bar_id) {
2019 int hidden_state = S_SHOW;
2020 bool toggle = false;
2021 if (strcmp(bar_hidden_state, "hide") == 0)
2022 hidden_state = S_HIDE;
2023 else if (strcmp(bar_hidden_state, "show") == 0)
2024 hidden_state = S_SHOW;
2025 else if (strcmp(bar_hidden_state, "toggle") == 0)
2028 ELOG("Unknown bar state \"%s\", this is a mismatch between code and parser spec.\n", bar_hidden_state);
2032 bool changed_sth = false;
2033 Barconfig *current = NULL;
2034 TAILQ_FOREACH(current, &barconfigs, configs) {
2035 if (bar_id && strcmp(current->id, bar_id) != 0)
2039 hidden_state = (current->hidden_state + 1) % 2;
2041 DLOG("Changing bar hidden_state of bar_id '%s' to '%s (%d)'\n", current->id, bar_hidden_state, hidden_state);
2042 current->hidden_state = hidden_state;
2049 if (bar_id && !changed_sth) {
2050 DLOG("Changing bar hidden_state of bar_id %s failed, bar_id not found.\n", bar_id);
2058 * Implementation of 'bar (hidden_state hide|show|toggle)|(mode dock|hide|invisible|toggle) [<bar_id>]'
2061 void cmd_bar(I3_CMD, const char *bar_type, const char *bar_value, const char *bar_id) {
2063 if (strcmp(bar_type, "mode") == 0)
2064 ret = cmd_bar_mode(bar_value, bar_id);
2065 else if (strcmp(bar_type, "hidden_state") == 0)
2066 ret = cmd_bar_hidden_state(bar_value, bar_id);
2068 ELOG("Unknown bar option type \"%s\", this is a mismatch between code and parser spec.\n", bar_type);
2080 * Implementation of 'shmlog <size>|toggle|on|off'
2083 void cmd_shmlog(I3_CMD, const char *argument) {
2084 if (!strcmp(argument, "toggle"))
2085 /* Toggle shm log, if size is not 0. If it is 0, set it to default. */
2086 shmlog_size = shmlog_size ? -shmlog_size : default_shmlog_size;
2087 else if (!strcmp(argument, "on"))
2088 shmlog_size = default_shmlog_size;
2089 else if (!strcmp(argument, "off"))
2092 /* If shm logging now, restart logging with the new size. */
2093 if (shmlog_size > 0) {
2095 LOG("Restarting shm logging...\n");
2098 shmlog_size = atoi(argument);
2099 /* Make a weakly attempt at ensuring the argument is valid. */
2100 if (shmlog_size <= 0)
2101 shmlog_size = default_shmlog_size;
2103 LOG("%s shm logging\n", shmlog_size > 0 ? "Enabling" : "Disabling");
2105 update_shmlog_atom();
2106 // XXX: default reply for now, make this a better reply
2111 * Implementation of 'debuglog toggle|on|off'
2114 void cmd_debuglog(I3_CMD, const char *argument) {
2115 bool logging = get_debug_logging();
2116 if (!strcmp(argument, "toggle")) {
2117 LOG("%s debug logging\n", logging ? "Disabling" : "Enabling");
2118 set_debug_logging(!logging);
2119 } else if (!strcmp(argument, "on") && !logging) {
2120 LOG("Enabling debug logging\n");
2121 set_debug_logging(true);
2122 } else if (!strcmp(argument, "off") && logging) {
2123 LOG("Disabling debug logging\n");
2124 set_debug_logging(false);
2126 // XXX: default reply for now, make this a better reply