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)
18 // Macros to make the YAJL API a bit easier to use.
19 #define y(x, ...) (cmd_output->json_gen != NULL ? yajl_gen_##x(cmd_output->json_gen, ##__VA_ARGS__) : 0)
20 #define ystr(str) (cmd_output->json_gen != NULL ? yajl_gen_string(cmd_output->json_gen, (unsigned char *)str, strlen(str)) : 0)
21 #define ysuccess(success) \
23 if (cmd_output->json_gen != NULL) { \
30 #define yerror(format, ...) \
32 if (cmd_output->json_gen != NULL) { \
34 sasprintf(&message, format, ##__VA_ARGS__); \
45 /** When the command did not include match criteria (!), we use the currently
46 * focused container. Do not confuse this case with a command which included
47 * criteria but which did not match any windows. This macro has to be called in
50 #define HANDLE_EMPTY_MATCH \
52 if (match_is_empty(current_match)) { \
53 owindow *ow = smalloc(sizeof(owindow)); \
55 TAILQ_INIT(&owindows); \
56 TAILQ_INSERT_TAIL(&owindows, ow, owindows); \
61 * Returns true if a is definitely greater than b (using the given epsilon)
64 static bool definitelyGreaterThan(float a, float b, float epsilon) {
65 return (a - b) > ((fabs(a) < fabs(b) ? fabs(b) : fabs(a)) * epsilon);
69 * Returns the output containing the given container.
71 static Output *get_output_of_con(Con *con) {
72 Con *output_con = con_get_output(con);
73 Output *output = get_output_by_name(output_con->name);
74 assert(output != NULL);
80 * Checks whether we switched to a new workspace and returns false in that case,
81 * signaling that further workspace switching should be done by the calling function
82 * If not, calls workspace_back_and_forth() if workspace_auto_back_and_forth is set
83 * and return true, signaling that no further workspace switching should occur in the calling function.
86 static bool maybe_back_and_forth(struct CommandResultIR *cmd_output, char *name) {
87 Con *ws = con_get_workspace(focused);
89 /* If we switched to a different workspace, do nothing */
90 if (strcmp(ws->name, name) != 0)
93 DLOG("This workspace is already focused.\n");
94 if (config.workspace_auto_back_and_forth) {
95 workspace_back_and_forth();
96 cmd_output->needs_tree_render = true;
102 * Return the passed workspace unless it is the current one and auto back and
103 * forth is enabled, in which case the back_and_forth workspace is returned.
105 static Con *maybe_auto_back_and_forth_workspace(Con *workspace) {
108 if (!config.workspace_auto_back_and_forth)
111 current = con_get_workspace(focused);
113 if (current == workspace) {
114 baf = workspace_back_and_forth_get();
116 DLOG("Substituting workspace with back_and_forth, as it is focused.\n");
124 // This code is commented out because we might recycle it for popping up error
125 // messages on parser errors.
127 static pid_t migration_pid = -1;
130 * Handler which will be called when we get a SIGCHLD for the nagbar, meaning
131 * it exited (or could not be started, depending on the exit code).
134 static void nagbar_exited(EV_P_ ev_child *watcher, int revents) {
135 ev_child_stop(EV_A_ watcher);
136 if (!WIFEXITED(watcher->rstatus)) {
137 fprintf(stderr, "ERROR: i3-nagbar did not exit normally.\n");
141 int exitcode = WEXITSTATUS(watcher->rstatus);
142 printf("i3-nagbar process exited with status %d\n", exitcode);
144 fprintf(stderr, "ERROR: i3-nagbar could not be found. Is it correctly installed on your system?\n");
150 /* We need ev >= 4 for the following code. Since it is not *that* important (it
151 * only makes sure that there are no i3-nagbar instances left behind) we still
152 * support old systems with libev 3. */
153 #if EV_VERSION_MAJOR >= 4
155 * Cleanup handler. Will be called when i3 exits. Kills i3-nagbar with signal
156 * SIGKILL (9) to make sure there are no left-over i3-nagbar processes.
159 static void nagbar_cleanup(EV_P_ ev_cleanup *watcher, int revent) {
160 if (migration_pid != -1) {
161 LOG("Sending SIGKILL (9) to i3-nagbar with PID %d\n", migration_pid);
162 kill(migration_pid, SIGKILL);
167 void cmd_MIGRATION_start_nagbar(void) {
168 if (migration_pid != -1) {
169 fprintf(stderr, "i3-nagbar already running.\n");
172 fprintf(stderr, "Starting i3-nagbar, command parsing differs from expected output.\n");
173 ELOG("Please report this on IRC or in the bugtracker. Make sure to include the full debug level logfile:\n");
174 ELOG("i3-dump-log | gzip -9c > /tmp/i3.log.gz\n");
175 ELOG("FYI: Your i3 version is " I3_VERSION "\n");
176 migration_pid = fork();
177 if (migration_pid == -1) {
178 warn("Could not fork()");
183 if (migration_pid == 0) {
185 sasprintf(&pageraction, "i3-sensible-terminal -e i3-sensible-pager \"%s\"", errorfilename);
187 NULL, /* will be replaced by the executable path */
191 "You found a parsing error. Please, please, please, report it!",
197 exec_i3_utility("i3-nagbar", argv);
201 /* install a child watcher */
202 ev_child *child = smalloc(sizeof(ev_child));
203 ev_child_init(child, &nagbar_exited, migration_pid, 0);
204 ev_child_start(main_loop, child);
206 /* We need ev >= 4 for the following code. Since it is not *that* important (it
207 * only makes sure that there are no i3-nagbar instances left behind) we still
208 * support old systems with libev 3. */
209 #if EV_VERSION_MAJOR >= 4
210 /* install a cleanup watcher (will be called when i3 exits and i3-nagbar is
212 ev_cleanup *cleanup = smalloc(sizeof(ev_cleanup));
213 ev_cleanup_init(cleanup, nagbar_cleanup);
214 ev_cleanup_start(main_loop, cleanup);
220 /*******************************************************************************
221 * Criteria functions.
222 ******************************************************************************/
225 * Helper data structure for an operation window (window on which the operation
226 * will be performed). Used to build the TAILQ owindows.
229 typedef struct owindow {
231 TAILQ_ENTRY(owindow) owindows;
234 typedef TAILQ_HEAD(owindows_head, owindow) owindows_head;
236 static owindows_head owindows;
239 * Initializes the specified 'Match' data structure and the initial state of
240 * commands.c for matching target windows of a command.
243 void cmd_criteria_init(I3_CMD) {
247 DLOG("Initializing criteria, current_match = %p\n", current_match);
248 match_free(current_match);
249 match_init(current_match);
250 while (!TAILQ_EMPTY(&owindows)) {
251 ow = TAILQ_FIRST(&owindows);
252 TAILQ_REMOVE(&owindows, ow, owindows);
255 TAILQ_INIT(&owindows);
257 TAILQ_FOREACH(con, &all_cons, all_cons) {
258 ow = smalloc(sizeof(owindow));
260 TAILQ_INSERT_TAIL(&owindows, ow, owindows);
265 * A match specification just finished (the closing square bracket was found),
266 * so we filter the list of owindows.
269 void cmd_criteria_match_windows(I3_CMD) {
270 owindow *next, *current;
272 DLOG("match specification finished, matching...\n");
273 /* copy the old list head to iterate through it and start with a fresh
274 * list which will contain only matching windows */
275 struct owindows_head old = owindows;
276 TAILQ_INIT(&owindows);
277 for (next = TAILQ_FIRST(&old); next != TAILQ_END(&old);) {
278 /* make a copy of the next pointer and advance the pointer to the
279 * next element as we are going to invalidate the element’s
280 * next/prev pointers by calling TAILQ_INSERT_TAIL later */
282 next = TAILQ_NEXT(next, owindows);
284 DLOG("checking if con %p / %s matches\n", current->con, current->con->name);
285 if (current_match->con_id != NULL) {
286 if (current_match->con_id == current->con) {
287 DLOG("matches container!\n");
288 TAILQ_INSERT_TAIL(&owindows, current, owindows);
290 DLOG("doesnt match\n");
293 } else if (current_match->mark != NULL && current->con->mark != NULL &&
294 regex_matches(current_match->mark, current->con->mark)) {
295 DLOG("match by mark\n");
296 TAILQ_INSERT_TAIL(&owindows, current, owindows);
298 if (current->con->window && match_matches_window(current_match, current->con->window)) {
299 DLOG("matches window!\n");
300 TAILQ_INSERT_TAIL(&owindows, current, owindows);
302 DLOG("doesnt match\n");
308 TAILQ_FOREACH(current, &owindows, owindows) {
309 DLOG("matching: %p / %s\n", current->con, current->con->name);
314 * Interprets a ctype=cvalue pair and adds it to the current match
318 void cmd_criteria_add(I3_CMD, char *ctype, char *cvalue) {
319 DLOG("ctype=*%s*, cvalue=*%s*\n", ctype, cvalue);
321 if (strcmp(ctype, "class") == 0) {
322 current_match->class = regex_new(cvalue);
326 if (strcmp(ctype, "instance") == 0) {
327 current_match->instance = regex_new(cvalue);
331 if (strcmp(ctype, "window_role") == 0) {
332 current_match->window_role = regex_new(cvalue);
336 if (strcmp(ctype, "con_id") == 0) {
338 long parsed = strtol(cvalue, &end, 0);
339 if (parsed == LONG_MIN ||
340 parsed == LONG_MAX ||
342 (end && *end != '\0')) {
343 ELOG("Could not parse con id \"%s\"\n", cvalue);
345 current_match->con_id = (Con *)parsed;
346 DLOG("id as int = %p\n", current_match->con_id);
351 if (strcmp(ctype, "id") == 0) {
353 long parsed = strtol(cvalue, &end, 0);
354 if (parsed == LONG_MIN ||
355 parsed == LONG_MAX ||
357 (end && *end != '\0')) {
358 ELOG("Could not parse window id \"%s\"\n", cvalue);
360 current_match->id = parsed;
361 DLOG("window id as int = %d\n", current_match->id);
366 if (strcmp(ctype, "window_type") == 0) {
367 if (strcasecmp(cvalue, "normal") == 0)
368 current_match->window_type = A__NET_WM_WINDOW_TYPE_NORMAL;
369 else if (strcasecmp(cvalue, "dialog") == 0)
370 current_match->window_type = A__NET_WM_WINDOW_TYPE_DIALOG;
371 else if (strcasecmp(cvalue, "utility") == 0)
372 current_match->window_type = A__NET_WM_WINDOW_TYPE_UTILITY;
373 else if (strcasecmp(cvalue, "toolbar") == 0)
374 current_match->window_type = A__NET_WM_WINDOW_TYPE_TOOLBAR;
375 else if (strcasecmp(cvalue, "splash") == 0)
376 current_match->window_type = A__NET_WM_WINDOW_TYPE_SPLASH;
377 else if (strcasecmp(cvalue, "menu") == 0)
378 current_match->window_type = A__NET_WM_WINDOW_TYPE_MENU;
379 else if (strcasecmp(cvalue, "dropdown_menu") == 0)
380 current_match->window_type = A__NET_WM_WINDOW_TYPE_DROPDOWN_MENU;
381 else if (strcasecmp(cvalue, "popup_menu") == 0)
382 current_match->window_type = A__NET_WM_WINDOW_TYPE_POPUP_MENU;
383 else if (strcasecmp(cvalue, "tooltip") == 0)
384 current_match->window_type = A__NET_WM_WINDOW_TYPE_TOOLTIP;
386 ELOG("unknown window_type value \"%s\"\n", cvalue);
391 if (strcmp(ctype, "con_mark") == 0) {
392 current_match->mark = regex_new(cvalue);
396 if (strcmp(ctype, "title") == 0) {
397 current_match->title = regex_new(cvalue);
401 if (strcmp(ctype, "urgent") == 0) {
402 if (strcasecmp(cvalue, "latest") == 0 ||
403 strcasecmp(cvalue, "newest") == 0 ||
404 strcasecmp(cvalue, "recent") == 0 ||
405 strcasecmp(cvalue, "last") == 0) {
406 current_match->urgent = U_LATEST;
407 } else if (strcasecmp(cvalue, "oldest") == 0 ||
408 strcasecmp(cvalue, "first") == 0) {
409 current_match->urgent = U_OLDEST;
414 if (strcmp(ctype, "workspace") == 0) {
415 current_match->workspace = regex_new(cvalue);
419 ELOG("Unknown criterion: %s\n", ctype);
423 * Implementation of 'move [window|container] [to] workspace
424 * next|prev|next_on_output|prev_on_output|current'.
427 void cmd_move_con_to_workspace(I3_CMD, char *which) {
430 DLOG("which=%s\n", which);
432 /* We have nothing to move:
433 * when criteria was specified but didn't match any window or
434 * when criteria wasn't specified and we don't have any window focused. */
435 if ((!match_is_empty(current_match) && TAILQ_EMPTY(&owindows)) ||
436 (match_is_empty(current_match) && focused->type == CT_WORKSPACE &&
437 !con_has_children(focused))) {
444 /* get the workspace */
446 if (strcmp(which, "next") == 0)
447 ws = workspace_next();
448 else if (strcmp(which, "prev") == 0)
449 ws = workspace_prev();
450 else if (strcmp(which, "next_on_output") == 0)
451 ws = workspace_next_on_output();
452 else if (strcmp(which, "prev_on_output") == 0)
453 ws = workspace_prev_on_output();
454 else if (strcmp(which, "current") == 0)
455 ws = con_get_workspace(focused);
457 ELOG("BUG: called with which=%s\n", which);
462 TAILQ_FOREACH(current, &owindows, owindows) {
463 DLOG("matching: %p / %s\n", current->con, current->con->name);
464 con_move_to_workspace(current->con, ws, true, false, false);
467 cmd_output->needs_tree_render = true;
468 // XXX: default reply for now, make this a better reply
473 * Implementation of 'move [window|container] [to] workspace back_and_forth'.
476 void cmd_move_con_to_workspace_back_and_forth(I3_CMD) {
480 ws = workspace_back_and_forth_get();
483 yerror("No workspace was previously active.");
489 TAILQ_FOREACH(current, &owindows, owindows) {
490 DLOG("matching: %p / %s\n", current->con, current->con->name);
491 con_move_to_workspace(current->con, ws, true, false, false);
494 cmd_output->needs_tree_render = true;
495 // XXX: default reply for now, make this a better reply
500 * Implementation of 'move [window|container] [to] workspace <name>'.
503 void cmd_move_con_to_workspace_name(I3_CMD, char *name) {
504 if (strncasecmp(name, "__", strlen("__")) == 0) {
505 LOG("You cannot move containers to i3-internal workspaces (\"%s\").\n", name);
512 /* We have nothing to move:
513 * when criteria was specified but didn't match any window or
514 * when criteria wasn't specified and we don't have any window focused. */
515 if (!match_is_empty(current_match) && TAILQ_EMPTY(&owindows)) {
516 ELOG("No windows match your criteria, cannot move.\n");
519 } else if (match_is_empty(current_match) && focused->type == CT_WORKSPACE &&
520 !con_has_children(focused)) {
525 LOG("should move window to workspace %s\n", name);
526 /* get the workspace */
527 Con *ws = workspace_get(name, NULL);
529 ws = maybe_auto_back_and_forth_workspace(ws);
533 TAILQ_FOREACH(current, &owindows, owindows) {
534 DLOG("matching: %p / %s\n", current->con, current->con->name);
535 con_move_to_workspace(current->con, ws, true, false, false);
538 cmd_output->needs_tree_render = true;
539 // XXX: default reply for now, make this a better reply
544 * Implementation of 'move [window|container] [to] workspace number <name>'.
547 void cmd_move_con_to_workspace_number(I3_CMD, char *which) {
550 /* We have nothing to move:
551 * when criteria was specified but didn't match any window or
552 * when criteria wasn't specified and we don't have any window focused. */
553 if ((!match_is_empty(current_match) && TAILQ_EMPTY(&owindows)) ||
554 (match_is_empty(current_match) && focused->type == CT_WORKSPACE &&
555 !con_has_children(focused))) {
560 LOG("should move window to workspace %s\n", which);
561 /* get the workspace */
562 Con *output, *workspace = NULL;
564 long parsed_num = ws_name_to_number(which);
566 if (parsed_num == -1) {
567 LOG("Could not parse initial part of \"%s\" as a number.\n", which);
568 yerror("Could not parse number \"%s\"", which);
572 TAILQ_FOREACH(output, &(croot->nodes_head), nodes)
573 GREP_FIRST(workspace, output_get_content(output),
574 child->num == parsed_num);
577 workspace = workspace_get(which, NULL);
580 workspace = maybe_auto_back_and_forth_workspace(workspace);
584 TAILQ_FOREACH(current, &owindows, owindows) {
585 DLOG("matching: %p / %s\n", current->con, current->con->name);
586 con_move_to_workspace(current->con, workspace, true, false, false);
589 cmd_output->needs_tree_render = true;
590 // XXX: default reply for now, make this a better reply
594 static void cmd_resize_floating(I3_CMD, char *way, char *direction, Con *floating_con, int px) {
595 LOG("floating resize\n");
596 Rect old_rect = floating_con->rect;
597 Con *focused_con = con_descend_focused(floating_con);
599 /* ensure that resize will take place even if pixel increment is smaller than
600 * height increment or width increment.
602 const i3Window *window = focused_con->window;
603 if (window != NULL) {
604 if (strcmp(direction, "up") == 0 || strcmp(direction, "down") == 0 ||
605 strcmp(direction, "height") == 0) {
607 px = (-px < window->height_increment) ? -window->height_increment : px;
609 px = (px < window->height_increment) ? window->height_increment : px;
610 } else if (strcmp(direction, "left") == 0 || strcmp(direction, "right") == 0) {
612 px = (-px < window->width_increment) ? -window->width_increment : px;
614 px = (px < window->width_increment) ? window->width_increment : px;
618 if (strcmp(direction, "up") == 0) {
619 floating_con->rect.height += px;
620 } else if (strcmp(direction, "down") == 0 || strcmp(direction, "height") == 0) {
621 floating_con->rect.height += px;
622 } else if (strcmp(direction, "left") == 0) {
623 floating_con->rect.width += px;
625 floating_con->rect.width += px;
628 floating_check_size(floating_con);
630 /* Did we actually resize anything or did the size constraints prevent us?
631 * If we could not resize, exit now to not move the window. */
632 if (memcmp(&old_rect, &(floating_con->rect), sizeof(Rect)) == 0)
635 if (strcmp(direction, "up") == 0) {
636 floating_con->rect.y -= (floating_con->rect.height - old_rect.height);
637 } else if (strcmp(direction, "left") == 0) {
638 floating_con->rect.x -= (floating_con->rect.width - old_rect.width);
641 /* If this is a scratchpad window, don't auto center it from now on. */
642 if (floating_con->scratchpad_state == SCRATCHPAD_FRESH)
643 floating_con->scratchpad_state = SCRATCHPAD_CHANGED;
646 static bool cmd_resize_tiling_direction(I3_CMD, Con *current, char *way, char *direction, int ppt) {
647 LOG("tiling resize\n");
649 Con *first = current;
650 direction_t search_direction;
651 if (!strcmp(direction, "left"))
652 search_direction = D_LEFT;
653 else if (!strcmp(direction, "right"))
654 search_direction = D_RIGHT;
655 else if (!strcmp(direction, "up"))
656 search_direction = D_UP;
658 search_direction = D_DOWN;
660 bool res = resize_find_tiling_participants(&first, &second, search_direction);
662 LOG("No second container in this direction found.\n");
667 /* get the default percentage */
668 int children = con_num_children(first->parent);
669 LOG("ins. %d children\n", children);
670 double percentage = 1.0 / children;
671 LOG("default percentage = %f\n", percentage);
674 LOG("second->percent = %f\n", second->percent);
675 LOG("first->percent before = %f\n", first->percent);
676 if (first->percent == 0.0)
677 first->percent = percentage;
678 if (second->percent == 0.0)
679 second->percent = percentage;
680 double new_first_percent = first->percent + ((double)ppt / 100.0);
681 double new_second_percent = second->percent - ((double)ppt / 100.0);
682 LOG("new_first_percent = %f\n", new_first_percent);
683 LOG("new_second_percent = %f\n", new_second_percent);
684 /* Ensure that the new percentages are positive and greater than
685 * 0.05 to have a reasonable minimum size. */
686 if (definitelyGreaterThan(new_first_percent, 0.05, DBL_EPSILON) &&
687 definitelyGreaterThan(new_second_percent, 0.05, DBL_EPSILON)) {
688 first->percent += ((double)ppt / 100.0);
689 second->percent -= ((double)ppt / 100.0);
690 LOG("first->percent after = %f\n", first->percent);
691 LOG("second->percent after = %f\n", second->percent);
693 LOG("Not resizing, already at minimum size\n");
699 static bool cmd_resize_tiling_width_height(I3_CMD, Con *current, char *way, char *direction, int ppt) {
700 LOG("width/height resize\n");
701 /* get the appropriate current container (skip stacked/tabbed cons) */
702 while (current->parent->layout == L_STACKED ||
703 current->parent->layout == L_TABBED)
704 current = current->parent;
706 /* Then further go up until we find one with the matching orientation. */
707 orientation_t search_orientation =
708 (strcmp(direction, "width") == 0 ? HORIZ : VERT);
710 while (current->type != CT_WORKSPACE &&
711 current->type != CT_FLOATING_CON &&
712 con_orientation(current->parent) != search_orientation)
713 current = current->parent;
715 /* get the default percentage */
716 int children = con_num_children(current->parent);
717 LOG("ins. %d children\n", children);
718 double percentage = 1.0 / children;
719 LOG("default percentage = %f\n", percentage);
721 orientation_t orientation = con_orientation(current->parent);
723 if ((orientation == HORIZ &&
724 strcmp(direction, "height") == 0) ||
725 (orientation == VERT &&
726 strcmp(direction, "width") == 0)) {
727 LOG("You cannot resize in that direction. Your focus is in a %s split container currently.\n",
728 (orientation == HORIZ ? "horizontal" : "vertical"));
734 LOG("This is the only container, cannot resize.\n");
739 /* Ensure all the other children have a percentage set. */
741 TAILQ_FOREACH(child, &(current->parent->nodes_head), nodes) {
742 LOG("child->percent = %f (child %p)\n", child->percent, child);
743 if (child->percent == 0.0)
744 child->percent = percentage;
747 double new_current_percent = current->percent + ((double)ppt / 100.0);
748 double subtract_percent = ((double)ppt / 100.0) / (children - 1);
749 LOG("new_current_percent = %f\n", new_current_percent);
750 LOG("subtract_percent = %f\n", subtract_percent);
751 /* Ensure that the new percentages are positive and greater than
752 * 0.05 to have a reasonable minimum size. */
753 TAILQ_FOREACH(child, &(current->parent->nodes_head), nodes) {
754 if (child == current)
756 if (!definitelyGreaterThan(child->percent - subtract_percent, 0.05, DBL_EPSILON)) {
757 LOG("Not resizing, already at minimum size (child %p would end up with a size of %.f\n", child, child->percent - subtract_percent);
762 if (!definitelyGreaterThan(new_current_percent, 0.05, DBL_EPSILON)) {
763 LOG("Not resizing, already at minimum size\n");
768 current->percent += ((double)ppt / 100.0);
769 LOG("current->percent after = %f\n", current->percent);
771 TAILQ_FOREACH(child, &(current->parent->nodes_head), nodes) {
772 if (child == current)
774 child->percent -= subtract_percent;
775 LOG("child->percent after (%p) = %f\n", child, child->percent);
782 * Implementation of 'resize grow|shrink <direction> [<px> px] [or <ppt> ppt]'.
785 void cmd_resize(I3_CMD, char *way, char *direction, char *resize_px, char *resize_ppt) {
786 /* resize <grow|shrink> <direction> [<px> px] [or <ppt> ppt] */
787 DLOG("resizing in way %s, direction %s, px %s or ppt %s\n", way, direction, resize_px, resize_ppt);
788 // TODO: We could either handle this in the parser itself as a separate token (and make the stack typed) or we need a better way to convert a string to a number with error checking
789 int px = atoi(resize_px);
790 int ppt = atoi(resize_ppt);
791 if (strcmp(way, "shrink") == 0) {
799 TAILQ_FOREACH(current, &owindows, owindows) {
800 /* Don't handle dock windows (issue #1201) */
801 if (current->con->window && current->con->window->dock) {
802 DLOG("This is a dock window. Not resizing (con = %p)\n)", current->con);
807 if ((floating_con = con_inside_floating(current->con))) {
808 cmd_resize_floating(current_match, cmd_output, way, direction, floating_con, px);
810 if (strcmp(direction, "width") == 0 ||
811 strcmp(direction, "height") == 0) {
812 if (!cmd_resize_tiling_width_height(current_match, cmd_output, current->con, way, direction, ppt))
815 if (!cmd_resize_tiling_direction(current_match, cmd_output, current->con, way, direction, ppt))
821 cmd_output->needs_tree_render = true;
822 // XXX: default reply for now, make this a better reply
827 * Implementation of 'resize set <px> [px] <px> [px]'.
830 void cmd_size(I3_CMD, char *cwidth, char *cheight) {
831 DLOG("resizing to %sx%s px\n", cwidth, cheight);
832 // TODO: We could either handle this in the parser itself as a separate token (and make the stack typed) or we need a better way to convert a string to a number with error checking
833 int x = atoi(cwidth);
834 int y = atoi(cheight);
835 if (x <= 0 || y <= 0) {
836 ELOG("Resize failed: dimensions cannot be negative (was %sx%s)\n", cwidth, cheight);
843 TAILQ_FOREACH(current, &owindows, owindows) {
845 if ((floating_con = con_inside_floating(current->con))) {
846 floating_resize(floating_con, x, y);
848 ELOG("Resize failed: %p not a floating container\n", current->con);
852 cmd_output->needs_tree_render = true;
853 // XXX: default reply for now, make this a better reply
858 * Implementation of 'border normal|pixel [<n>]', 'border none|1pixel|toggle'.
861 void cmd_border(I3_CMD, char *border_style_str, char *border_width) {
862 DLOG("border style should be changed to %s with border width %s\n", border_style_str, border_width);
867 TAILQ_FOREACH(current, &owindows, owindows) {
868 DLOG("matching: %p / %s\n", current->con, current->con->name);
869 int border_style = current->con->border_style;
871 int tmp_border_width = -1;
872 tmp_border_width = strtol(border_width, &end, 10);
873 if (end == border_width) {
874 /* no valid digits found */
875 tmp_border_width = -1;
877 if (strcmp(border_style_str, "toggle") == 0) {
880 if (border_style == BS_NORMAL)
881 tmp_border_width = 2;
882 else if (border_style == BS_NONE)
883 tmp_border_width = 0;
884 else if (border_style == BS_PIXEL)
885 tmp_border_width = 1;
887 if (strcmp(border_style_str, "normal") == 0)
888 border_style = BS_NORMAL;
889 else if (strcmp(border_style_str, "pixel") == 0)
890 border_style = BS_PIXEL;
891 else if (strcmp(border_style_str, "1pixel") == 0) {
892 border_style = BS_PIXEL;
893 tmp_border_width = 1;
894 } else if (strcmp(border_style_str, "none") == 0)
895 border_style = BS_NONE;
897 ELOG("BUG: called with border_style=%s\n", border_style_str);
902 con_set_border_style(current->con, border_style, tmp_border_width);
905 cmd_output->needs_tree_render = true;
906 // XXX: default reply for now, make this a better reply
911 * Implementation of 'nop <comment>'.
914 void cmd_nop(I3_CMD, char *comment) {
915 LOG("-------------------------------------------------\n");
916 LOG(" NOP: %s\n", comment);
917 LOG("-------------------------------------------------\n");
921 * Implementation of 'append_layout <path>'.
924 void cmd_append_layout(I3_CMD, char *path) {
925 LOG("Appending layout \"%s\"\n", path);
927 /* Make sure we allow paths like '~/.i3/layout.json' */
928 path = resolve_tilde(path);
930 json_content_t content = json_determine_content(path);
931 LOG("JSON content = %d\n", content);
932 if (content == JSON_CONTENT_UNKNOWN) {
933 ELOG("Could not determine the contents of \"%s\", not loading.\n", path);
934 yerror("Could not determine the contents of \"%s\".", path);
939 Con *parent = focused;
940 if (content == JSON_CONTENT_WORKSPACE) {
941 parent = output_get_content(con_get_output(parent));
943 /* We need to append the layout to a split container, since a leaf
944 * container must not have any children (by definition).
945 * Note that we explicitly check for workspaces, since they are okay for
946 * this purpose, but con_accepts_window() returns false for workspaces. */
947 while (parent->type != CT_WORKSPACE && !con_accepts_window(parent))
948 parent = parent->parent;
950 DLOG("Appending to parent=%p instead of focused=%p\n", parent, focused);
951 char *errormsg = NULL;
952 tree_append_json(parent, path, &errormsg);
953 if (errormsg != NULL) {
956 /* Note that we continue executing since tree_append_json() has
957 * side-effects — user-provided layouts can be partly valid, partly
958 * invalid, leading to half of the placeholder containers being
964 // XXX: This is a bit of a kludge. Theoretically, render_con(parent,
965 // false); should be enough, but when sending 'workspace 4; append_layout
966 // /tmp/foo.json', the needs_tree_render == true of the workspace command
967 // is not executed yet and will be batched with append_layout’s
968 // needs_tree_render after the parser finished. We should check if that is
970 render_con(croot, false);
972 restore_open_placeholder_windows(parent);
974 if (content == JSON_CONTENT_WORKSPACE)
975 ipc_send_workspace_event("restored", parent, NULL);
978 cmd_output->needs_tree_render = true;
982 * Implementation of 'workspace next|prev|next_on_output|prev_on_output'.
985 void cmd_workspace(I3_CMD, char *which) {
988 DLOG("which=%s\n", which);
990 if (con_get_fullscreen_con(croot, CF_GLOBAL)) {
991 LOG("Cannot switch workspace while in global fullscreen\n");
996 if (strcmp(which, "next") == 0)
997 ws = workspace_next();
998 else if (strcmp(which, "prev") == 0)
999 ws = workspace_prev();
1000 else if (strcmp(which, "next_on_output") == 0)
1001 ws = workspace_next_on_output();
1002 else if (strcmp(which, "prev_on_output") == 0)
1003 ws = workspace_prev_on_output();
1005 ELOG("BUG: called with which=%s\n", which);
1012 cmd_output->needs_tree_render = true;
1013 // XXX: default reply for now, make this a better reply
1018 * Implementation of 'workspace number <name>'
1021 void cmd_workspace_number(I3_CMD, char *which) {
1022 Con *output, *workspace = NULL;
1024 if (con_get_fullscreen_con(croot, CF_GLOBAL)) {
1025 LOG("Cannot switch workspace while in global fullscreen\n");
1030 long parsed_num = ws_name_to_number(which);
1032 if (parsed_num == -1) {
1033 LOG("Could not parse initial part of \"%s\" as a number.\n", which);
1034 yerror("Could not parse number \"%s\"", which);
1038 TAILQ_FOREACH(output, &(croot->nodes_head), nodes)
1039 GREP_FIRST(workspace, output_get_content(output),
1040 child->num == parsed_num);
1043 LOG("There is no workspace with number %ld, creating a new one.\n", parsed_num);
1045 workspace_show_by_name(which);
1046 cmd_output->needs_tree_render = true;
1049 if (maybe_back_and_forth(cmd_output, workspace->name))
1051 workspace_show(workspace);
1053 cmd_output->needs_tree_render = true;
1054 // XXX: default reply for now, make this a better reply
1059 * Implementation of 'workspace back_and_forth'.
1062 void cmd_workspace_back_and_forth(I3_CMD) {
1063 if (con_get_fullscreen_con(croot, CF_GLOBAL)) {
1064 LOG("Cannot switch workspace while in global fullscreen\n");
1069 workspace_back_and_forth();
1071 cmd_output->needs_tree_render = true;
1072 // XXX: default reply for now, make this a better reply
1077 * Implementation of 'workspace <name>'
1080 void cmd_workspace_name(I3_CMD, char *name) {
1081 if (strncasecmp(name, "__", strlen("__")) == 0) {
1082 LOG("You cannot switch to the i3-internal workspaces (\"%s\").\n", name);
1087 if (con_get_fullscreen_con(croot, CF_GLOBAL)) {
1088 LOG("Cannot switch workspace while in global fullscreen\n");
1093 DLOG("should switch to workspace %s\n", name);
1094 if (maybe_back_and_forth(cmd_output, name))
1096 workspace_show_by_name(name);
1098 cmd_output->needs_tree_render = true;
1099 // XXX: default reply for now, make this a better reply
1104 * Implementation of 'mark [--toggle] <mark>'
1107 void cmd_mark(I3_CMD, char *mark, char *toggle) {
1110 owindow *current = TAILQ_FIRST(&owindows);
1111 if (current == NULL) {
1116 /* Marks must be unique, i.e., no two windows must have the same mark. */
1117 if (current != TAILQ_LAST(&owindows, owindows_head)) {
1118 yerror("A mark must not be put onto more than one window");
1122 DLOG("matching: %p / %s\n", current->con, current->con->name);
1123 current->con->mark_changed = true;
1124 if (toggle != NULL && current->con->mark && strcmp(current->con->mark, mark) == 0) {
1125 DLOG("removing window mark %s\n", mark);
1126 FREE(current->con->mark);
1128 DLOG("marking window with str %s\n", mark);
1129 FREE(current->con->mark);
1130 current->con->mark = sstrdup(mark);
1133 DLOG("Clearing all non-matched windows with this mark\n");
1135 TAILQ_FOREACH(con, &all_cons, all_cons) {
1136 /* Skip matched window, we took care of it already. */
1137 if (current->con == con)
1140 if (con->mark && strcmp(con->mark, mark) == 0) {
1142 con->mark_changed = true;
1146 cmd_output->needs_tree_render = true;
1147 // XXX: default reply for now, make this a better reply
1152 * Implementation of 'unmark [mark]'
1155 void cmd_unmark(I3_CMD, char *mark) {
1158 TAILQ_FOREACH(con, &all_cons, all_cons) {
1159 if (con->mark == NULL)
1163 con->mark_changed = true;
1165 DLOG("Removed all window marks.\n");
1167 Con *con = con_by_mark(mark);
1170 con->mark_changed = true;
1172 DLOG("Removed window mark \"%s\".\n", mark);
1175 cmd_output->needs_tree_render = true;
1176 // XXX: default reply for now, make this a better reply
1181 * Implementation of 'mode <string>'.
1184 void cmd_mode(I3_CMD, char *mode) {
1185 DLOG("mode=%s\n", mode);
1188 // XXX: default reply for now, make this a better reply
1193 * Implementation of 'move [window|container] [to] output <str>'.
1196 void cmd_move_con_to_output(I3_CMD, char *name) {
1199 DLOG("should move window to output %s\n", name);
1203 Output *current_output = NULL;
1204 // TODO: fix the handling of criteria
1205 TAILQ_FOREACH(current, &owindows, owindows)
1206 current_output = get_output_of_con(current->con);
1207 assert(current_output != NULL);
1209 Output *output = get_output_from_string(current_output, name);
1211 LOG("No such output found.\n");
1216 /* get visible workspace on output */
1218 GREP_FIRST(ws, output_get_content(output->con), workspace_is_visible(child));
1224 TAILQ_FOREACH(current, &owindows, owindows) {
1225 DLOG("matching: %p / %s\n", current->con, current->con->name);
1226 con_move_to_workspace(current->con, ws, true, false, false);
1229 cmd_output->needs_tree_render = true;
1230 // XXX: default reply for now, make this a better reply
1235 * Implementation of 'move [container|window] [to] mark <str>'.
1238 void cmd_move_con_to_mark(I3_CMD, char *mark) {
1239 DLOG("moving window to mark \"%s\"\n", mark);
1245 TAILQ_FOREACH(current, &owindows, owindows) {
1246 DLOG("moving matched window %p / %s to mark \"%s\"\n", current->con, current->con->name, mark);
1247 result &= con_move_to_mark(current->con, mark);
1250 cmd_output->needs_tree_render = true;
1255 * Implementation of 'floating enable|disable|toggle'
1258 void cmd_floating(I3_CMD, char *floating_mode) {
1261 DLOG("floating_mode=%s\n", floating_mode);
1265 TAILQ_FOREACH(current, &owindows, owindows) {
1266 DLOG("matching: %p / %s\n", current->con, current->con->name);
1267 if (strcmp(floating_mode, "toggle") == 0) {
1268 DLOG("should toggle mode\n");
1269 toggle_floating_mode(current->con, false);
1271 DLOG("should switch mode to %s\n", floating_mode);
1272 if (strcmp(floating_mode, "enable") == 0) {
1273 floating_enable(current->con, false);
1275 floating_disable(current->con, false);
1280 cmd_output->needs_tree_render = true;
1281 // XXX: default reply for now, make this a better reply
1286 * Implementation of 'move workspace to [output] <str>'.
1289 void cmd_move_workspace_to_output(I3_CMD, char *name) {
1290 DLOG("should move workspace to output %s\n", name);
1295 TAILQ_FOREACH(current, &owindows, owindows) {
1296 Con *ws = con_get_workspace(current->con);
1297 bool success = workspace_move_to_output(ws, name);
1299 ELOG("Failed to move workspace to output.\n");
1305 cmd_output->needs_tree_render = true;
1306 // XXX: default reply for now, make this a better reply
1311 * Implementation of 'split v|h|vertical|horizontal'.
1314 void cmd_split(I3_CMD, char *direction) {
1316 /* TODO: use matches */
1317 LOG("splitting in direction %c\n", direction[0]);
1318 if (match_is_empty(current_match))
1319 tree_split(focused, (direction[0] == 'v' ? VERT : HORIZ));
1321 TAILQ_FOREACH(current, &owindows, owindows) {
1322 DLOG("matching: %p / %s\n", current->con, current->con->name);
1323 tree_split(current->con, (direction[0] == 'v' ? VERT : HORIZ));
1327 cmd_output->needs_tree_render = true;
1328 // XXX: default reply for now, make this a better reply
1333 * Implementation of 'kill [window|client]'.
1336 void cmd_kill(I3_CMD, char *kill_mode_str) {
1337 if (kill_mode_str == NULL)
1338 kill_mode_str = "window";
1341 DLOG("kill_mode=%s\n", kill_mode_str);
1344 if (strcmp(kill_mode_str, "window") == 0)
1345 kill_mode = KILL_WINDOW;
1346 else if (strcmp(kill_mode_str, "client") == 0)
1347 kill_mode = KILL_CLIENT;
1349 ELOG("BUG: called with kill_mode=%s\n", kill_mode_str);
1354 /* check if the match is empty, not if the result is empty */
1355 if (match_is_empty(current_match))
1356 tree_close_con(kill_mode);
1358 TAILQ_FOREACH(current, &owindows, owindows) {
1359 DLOG("matching: %p / %s\n", current->con, current->con->name);
1360 tree_close(current->con, kill_mode, false, false);
1364 cmd_output->needs_tree_render = true;
1365 // XXX: default reply for now, make this a better reply
1370 * Implementation of 'exec [--no-startup-id] <command>'.
1373 void cmd_exec(I3_CMD, char *nosn, char *command) {
1374 bool no_startup_id = (nosn != NULL);
1376 DLOG("should execute %s, no_startup_id = %d\n", command, no_startup_id);
1377 start_application(command, no_startup_id);
1379 // XXX: default reply for now, make this a better reply
1384 * Implementation of 'focus left|right|up|down'.
1387 void cmd_focus_direction(I3_CMD, char *direction) {
1388 DLOG("direction = *%s*\n", direction);
1390 if (strcmp(direction, "left") == 0)
1391 tree_next('p', HORIZ);
1392 else if (strcmp(direction, "right") == 0)
1393 tree_next('n', HORIZ);
1394 else if (strcmp(direction, "up") == 0)
1395 tree_next('p', VERT);
1396 else if (strcmp(direction, "down") == 0)
1397 tree_next('n', VERT);
1399 ELOG("Invalid focus direction (%s)\n", direction);
1404 cmd_output->needs_tree_render = true;
1405 // XXX: default reply for now, make this a better reply
1410 * Implementation of 'focus tiling|floating|mode_toggle'.
1413 void cmd_focus_window_mode(I3_CMD, char *window_mode) {
1414 DLOG("window_mode = %s\n", window_mode);
1416 Con *ws = con_get_workspace(focused);
1418 if (strcmp(window_mode, "mode_toggle") == 0) {
1419 if (con_inside_floating(focused))
1420 window_mode = "tiling";
1422 window_mode = "floating";
1425 TAILQ_FOREACH(current, &(ws->focus_head), focused) {
1426 if ((strcmp(window_mode, "floating") == 0 && current->type != CT_FLOATING_CON) ||
1427 (strcmp(window_mode, "tiling") == 0 && current->type == CT_FLOATING_CON))
1430 con_focus(con_descend_focused(current));
1435 cmd_output->needs_tree_render = true;
1436 // XXX: default reply for now, make this a better reply
1441 * Implementation of 'focus parent|child'.
1444 void cmd_focus_level(I3_CMD, char *level) {
1445 DLOG("level = %s\n", level);
1446 bool success = false;
1448 /* Focusing the parent can only be allowed if the newly
1449 * focused container won't escape the fullscreen container. */
1450 if (strcmp(level, "parent") == 0) {
1451 if (focused && focused->parent) {
1452 if (con_fullscreen_permits_focusing(focused->parent))
1453 success = level_up();
1455 ELOG("'focus parent': Currently in fullscreen, not going up\n");
1459 /* Focusing a child should always be allowed. */
1461 success = level_down();
1463 cmd_output->needs_tree_render = success;
1464 // XXX: default reply for now, make this a better reply
1469 * Implementation of 'focus'.
1472 void cmd_focus(I3_CMD) {
1473 DLOG("current_match = %p\n", current_match);
1475 if (match_is_empty(current_match)) {
1476 ELOG("You have to specify which window/container should be focused.\n");
1477 ELOG("Example: [class=\"urxvt\" title=\"irssi\"] focus\n");
1479 yerror("You have to specify which window/container should be focused");
1484 Con *__i3_scratch = workspace_get("__i3_scratch", NULL);
1487 TAILQ_FOREACH(current, &owindows, owindows) {
1488 Con *ws = con_get_workspace(current->con);
1489 /* If no workspace could be found, this was a dock window.
1490 * Just skip it, you cannot focus dock windows. */
1494 /* Check the fullscreen focus constraints. */
1495 if (!con_fullscreen_permits_focusing(current->con)) {
1496 LOG("Cannot change focus while in fullscreen mode (fullscreen rules).\n");
1501 /* In case this is a scratchpad window, call scratchpad_show(). */
1502 if (ws == __i3_scratch) {
1503 scratchpad_show(current->con);
1505 /* While for the normal focus case we can change focus multiple
1506 * times and only a single window ends up focused, we could show
1507 * multiple scratchpad windows. So, rather break here. */
1511 /* If the container is not on the current workspace,
1512 * workspace_show() will switch to a different workspace and (if
1513 * enabled) trigger a mouse pointer warp to the currently focused
1514 * container (!) on the target workspace.
1516 * Therefore, before calling workspace_show(), we make sure that
1517 * 'current' will be focused on the workspace. However, we cannot
1518 * just con_focus(current) because then the pointer will not be
1519 * warped at all (the code thinks we are already there).
1521 * So we focus 'current' to make it the currently focused window of
1522 * the target workspace, then revert focus. */
1523 Con *currently_focused = focused;
1524 con_focus(current->con);
1525 con_focus(currently_focused);
1527 /* Now switch to the workspace, then focus */
1529 LOG("focusing %p / %s\n", current->con, current->con->name);
1530 con_focus(current->con);
1535 LOG("WARNING: Your criteria for the focus command matches %d containers, "
1536 "while only exactly one container can be focused at a time.\n",
1539 cmd_output->needs_tree_render = true;
1540 ysuccess(count > 0);
1544 * Implementation of 'fullscreen enable|toggle [global]' and
1545 * 'fullscreen disable'
1548 void cmd_fullscreen(I3_CMD, char *action, char *fullscreen_mode) {
1549 fullscreen_mode_t mode = strcmp(fullscreen_mode, "global") == 0 ? CF_GLOBAL : CF_OUTPUT;
1550 DLOG("%s fullscreen, mode = %s\n", action, fullscreen_mode);
1555 TAILQ_FOREACH(current, &owindows, owindows) {
1556 DLOG("matching: %p / %s\n", current->con, current->con->name);
1557 if (strcmp(action, "toggle") == 0) {
1558 con_toggle_fullscreen(current->con, mode);
1559 } else if (strcmp(action, "enable") == 0) {
1560 con_enable_fullscreen(current->con, mode);
1561 } else if (strcmp(action, "disable") == 0) {
1562 con_disable_fullscreen(current->con);
1566 cmd_output->needs_tree_render = true;
1567 // XXX: default reply for now, make this a better reply
1572 * Implementation of 'sticky enable|disable|toggle'.
1575 void cmd_sticky(I3_CMD, char *action) {
1576 DLOG("%s sticky on window\n", action);
1580 TAILQ_FOREACH(current, &owindows, owindows) {
1581 if (current->con->window == NULL) {
1582 ELOG("only containers holding a window can be made sticky, skipping con = %p\n", current->con);
1585 DLOG("setting sticky for container = %p / %s\n", current->con, current->con->name);
1587 bool sticky = false;
1588 if (strcmp(action, "enable") == 0)
1590 else if (strcmp(action, "disable") == 0)
1592 else if (strcmp(action, "toggle") == 0)
1593 sticky = !current->con->sticky;
1595 current->con->sticky = sticky;
1596 ewmh_update_sticky(current->con->window->id, sticky);
1599 /* A window we made sticky might not be on a visible workspace right now, so we need to make
1600 * sure it gets pushed to the front now. */
1601 output_push_sticky_windows(focused);
1603 cmd_output->needs_tree_render = true;
1608 * Implementation of 'move <direction> [<pixels> [px]]'.
1611 void cmd_move_direction(I3_CMD, char *direction, char *move_px) {
1612 // TODO: We could either handle this in the parser itself as a separate token (and make the stack typed) or we need a better way to convert a string to a number with error checking
1613 int px = atoi(move_px);
1618 Con *initially_focused = focused;
1620 TAILQ_FOREACH(current, &owindows, owindows) {
1621 DLOG("moving in direction %s, px %s\n", direction, move_px);
1622 if (con_is_floating(current->con)) {
1623 DLOG("floating move with %d pixels\n", px);
1624 Rect newrect = current->con->parent->rect;
1625 if (strcmp(direction, "left") == 0) {
1627 } else if (strcmp(direction, "right") == 0) {
1629 } else if (strcmp(direction, "up") == 0) {
1631 } else if (strcmp(direction, "down") == 0) {
1634 floating_reposition(current->con->parent, newrect);
1636 tree_move(current->con, (strcmp(direction, "right") == 0 ? D_RIGHT : (strcmp(direction, "left") == 0 ? D_LEFT : (strcmp(direction, "up") == 0 ? D_UP : D_DOWN))));
1637 cmd_output->needs_tree_render = true;
1641 /* the move command should not disturb focus */
1642 if (focused != initially_focused)
1643 con_focus(initially_focused);
1645 // XXX: default reply for now, make this a better reply
1650 * Implementation of 'layout default|stacked|stacking|tabbed|splitv|splith'.
1653 void cmd_layout(I3_CMD, char *layout_str) {
1654 if (strcmp(layout_str, "stacking") == 0)
1655 layout_str = "stacked";
1658 /* default is a special case which will be handled in con_set_layout(). */
1659 if (strcmp(layout_str, "default") == 0)
1661 else if (strcmp(layout_str, "stacked") == 0)
1663 else if (strcmp(layout_str, "tabbed") == 0)
1665 else if (strcmp(layout_str, "splitv") == 0)
1667 else if (strcmp(layout_str, "splith") == 0)
1670 ELOG("Unknown layout \"%s\", this is a mismatch between code and parser spec.\n", layout_str);
1674 DLOG("changing layout to %s (%d)\n", layout_str, layout);
1676 /* check if the match is empty, not if the result is empty */
1677 if (match_is_empty(current_match))
1678 con_set_layout(focused, layout);
1680 TAILQ_FOREACH(current, &owindows, owindows) {
1681 DLOG("matching: %p / %s\n", current->con, current->con->name);
1682 con_set_layout(current->con, layout);
1686 cmd_output->needs_tree_render = true;
1687 // XXX: default reply for now, make this a better reply
1692 * Implementation of 'layout toggle [all|split]'.
1695 void cmd_layout_toggle(I3_CMD, char *toggle_mode) {
1698 if (toggle_mode == NULL)
1699 toggle_mode = "default";
1701 DLOG("toggling layout (mode = %s)\n", toggle_mode);
1703 /* check if the match is empty, not if the result is empty */
1704 if (match_is_empty(current_match))
1705 con_toggle_layout(focused, toggle_mode);
1707 TAILQ_FOREACH(current, &owindows, owindows) {
1708 DLOG("matching: %p / %s\n", current->con, current->con->name);
1709 con_toggle_layout(current->con, toggle_mode);
1713 cmd_output->needs_tree_render = true;
1714 // XXX: default reply for now, make this a better reply
1719 * Implementation of 'exit'.
1722 void cmd_exit(I3_CMD) {
1723 LOG("Exiting due to user command.\n");
1725 unlink(config.ipc_socket_path);
1726 xcb_disconnect(conn);
1733 * Implementation of 'reload'.
1736 void cmd_reload(I3_CMD) {
1738 kill_nagbar(&config_error_nagbar_pid, false);
1739 kill_nagbar(&command_error_nagbar_pid, false);
1740 load_configuration(conn, NULL, true);
1742 /* Send an IPC event just in case the ws names have changed */
1743 ipc_send_workspace_event("reload", NULL, NULL);
1744 /* Send an update event for the barconfig just in case it has changed */
1747 // XXX: default reply for now, make this a better reply
1752 * Implementation of 'restart'.
1755 void cmd_restart(I3_CMD) {
1756 LOG("restarting i3\n");
1758 unlink(config.ipc_socket_path);
1759 /* We need to call this manually since atexit handlers don’t get called
1761 purge_zerobyte_logfile();
1764 // XXX: default reply for now, make this a better reply
1769 * Implementation of 'open'.
1772 void cmd_open(I3_CMD) {
1773 LOG("opening new container\n");
1774 Con *con = tree_open_con(NULL, NULL);
1775 con->layout = L_SPLITH;
1782 y(integer, (long int)con);
1785 cmd_output->needs_tree_render = true;
1789 * Implementation of 'focus output <output>'.
1792 void cmd_focus_output(I3_CMD, char *name) {
1795 DLOG("name = %s\n", name);
1799 /* get the output */
1800 Output *current_output = NULL;
1803 TAILQ_FOREACH(current, &owindows, owindows)
1804 current_output = get_output_of_con(current->con);
1805 assert(current_output != NULL);
1807 output = get_output_from_string(current_output, name);
1810 LOG("No such output found.\n");
1815 /* get visible workspace on output */
1817 GREP_FIRST(ws, output_get_content(output->con), workspace_is_visible(child));
1825 cmd_output->needs_tree_render = true;
1826 // XXX: default reply for now, make this a better reply
1831 * Implementation of 'move [window|container] [to] [absolute] position <px> [px] <px> [px]
1834 void cmd_move_window_to_position(I3_CMD, char *method, char *cx, char *cy) {
1837 bool has_error = false;
1842 TAILQ_FOREACH(current, &owindows, owindows) {
1843 if (!con_is_floating(current->con)) {
1844 ELOG("Cannot change position. The window/container is not floating\n");
1847 yerror("Cannot change position of a window/container because it is not floating.");
1854 if (strcmp(method, "absolute") == 0) {
1855 current->con->parent->rect.x = x;
1856 current->con->parent->rect.y = y;
1858 DLOG("moving to absolute position %d %d\n", x, y);
1859 floating_maybe_reassign_ws(current->con->parent);
1860 cmd_output->needs_tree_render = true;
1863 if (strcmp(method, "position") == 0) {
1864 Rect newrect = current->con->parent->rect;
1866 DLOG("moving to position %d %d\n", x, y);
1870 floating_reposition(current->con->parent, newrect);
1874 // XXX: default reply for now, make this a better reply
1880 * Implementation of 'move [window|container] [to] [absolute] position center
1883 void cmd_move_window_to_center(I3_CMD, char *method) {
1884 if (!con_is_floating(focused)) {
1885 ELOG("Cannot change position. The window/container is not floating\n");
1886 yerror("Cannot change position. The window/container is not floating.");
1890 if (strcmp(method, "absolute") == 0) {
1891 DLOG("moving to absolute center\n");
1892 floating_center(focused->parent, croot->rect);
1894 floating_maybe_reassign_ws(focused->parent);
1895 cmd_output->needs_tree_render = true;
1898 if (strcmp(method, "position") == 0) {
1899 DLOG("moving to center\n");
1900 floating_center(focused->parent, con_get_workspace(focused)->rect);
1902 cmd_output->needs_tree_render = true;
1905 // XXX: default reply for now, make this a better reply
1910 * Implementation of 'move [window|container] [to] position mouse'
1913 void cmd_move_window_to_mouse(I3_CMD) {
1917 TAILQ_FOREACH(current, &owindows, owindows) {
1918 Con *floating_con = con_inside_floating(current->con);
1919 if (floating_con == NULL) {
1920 DLOG("con %p / %s is not floating, cannot move it to the mouse position.\n",
1921 current->con, current->con->name);
1925 DLOG("moving floating container %p / %s to cursor position\n", floating_con, floating_con->name);
1926 floating_move_to_pointer(floating_con);
1929 cmd_output->needs_tree_render = true;
1934 * Implementation of 'move scratchpad'.
1937 void cmd_move_scratchpad(I3_CMD) {
1938 DLOG("should move window to scratchpad\n");
1943 TAILQ_FOREACH(current, &owindows, owindows) {
1944 DLOG("matching: %p / %s\n", current->con, current->con->name);
1945 scratchpad_move(current->con);
1948 cmd_output->needs_tree_render = true;
1949 // XXX: default reply for now, make this a better reply
1954 * Implementation of 'scratchpad show'.
1957 void cmd_scratchpad_show(I3_CMD) {
1958 DLOG("should show scratchpad window\n");
1961 if (match_is_empty(current_match)) {
1962 scratchpad_show(NULL);
1964 TAILQ_FOREACH(current, &owindows, owindows) {
1965 DLOG("matching: %p / %s\n", current->con, current->con->name);
1966 scratchpad_show(current->con);
1970 cmd_output->needs_tree_render = true;
1971 // XXX: default reply for now, make this a better reply
1976 * Implementation of 'title_format <format>'
1979 void cmd_title_format(I3_CMD, char *format) {
1980 DLOG("setting title_format to \"%s\"\n", format);
1984 TAILQ_FOREACH(current, &owindows, owindows) {
1985 if (current->con->window == NULL)
1988 DLOG("setting title_format for %p / %s\n", current->con, current->con->name);
1989 FREE(current->con->window->title_format);
1991 /* If we only display the title without anything else, we can skip the parsing step,
1992 * so we remove the title format altogether. */
1993 if (strcasecmp(format, "%title") != 0) {
1994 current->con->window->title_format = sstrdup(format);
1996 i3String *formatted_title = window_parse_title_format(current->con->window);
1997 ewmh_update_visible_name(current->con->window->id, i3string_as_utf8(formatted_title));
1998 I3STRING_FREE(formatted_title);
2000 /* We can remove _NET_WM_VISIBLE_NAME since we don't display a custom title. */
2001 ewmh_update_visible_name(current->con->window->id, NULL);
2004 /* Make sure the window title is redrawn immediately. */
2005 current->con->window->name_x_changed = true;
2008 cmd_output->needs_tree_render = true;
2013 * Implementation of 'rename workspace [<name>] to <name>'
2016 void cmd_rename_workspace(I3_CMD, char *old_name, char *new_name) {
2017 if (strncasecmp(new_name, "__", strlen("__")) == 0) {
2018 LOG("Cannot rename workspace to \"%s\": names starting with __ are i3-internal.\n", new_name);
2023 LOG("Renaming workspace \"%s\" to \"%s\"\n", old_name, new_name);
2025 LOG("Renaming current workspace to \"%s\"\n", new_name);
2028 Con *output, *workspace = NULL;
2030 TAILQ_FOREACH(output, &(croot->nodes_head), nodes)
2031 GREP_FIRST(workspace, output_get_content(output),
2032 !strcasecmp(child->name, old_name));
2034 workspace = con_get_workspace(focused);
2035 old_name = workspace->name;
2039 yerror("Old workspace \"%s\" not found", old_name);
2043 Con *check_dest = NULL;
2044 TAILQ_FOREACH(output, &(croot->nodes_head), nodes)
2045 GREP_FIRST(check_dest, output_get_content(output),
2046 !strcasecmp(child->name, new_name));
2048 if (check_dest != NULL) {
2049 yerror("New workspace \"%s\" already exists", new_name);
2053 /* Change the name and try to parse it as a number. */
2054 FREE(workspace->name);
2055 workspace->name = sstrdup(new_name);
2057 workspace->num = ws_name_to_number(new_name);
2058 LOG("num = %d\n", workspace->num);
2060 /* By re-attaching, the sort order will be correct afterwards. */
2061 Con *previously_focused = focused;
2062 Con *parent = workspace->parent;
2063 con_detach(workspace);
2064 con_attach(workspace, parent, false);
2066 /* Move the workspace to the correct output if it has an assignment */
2067 struct Workspace_Assignment *assignment = NULL;
2068 TAILQ_FOREACH(assignment, &ws_assignments, ws_assignments) {
2069 if (assignment->output == NULL)
2071 if (strcmp(assignment->name, workspace->name) != 0 && (!name_is_digits(assignment->name) || ws_name_to_number(assignment->name) != workspace->num)) {
2075 workspace_move_to_output(workspace, assignment->output);
2077 if (previously_focused)
2078 workspace_show(con_get_workspace(previously_focused));
2083 /* Restore the previous focus since con_attach messes with the focus. */
2084 con_focus(previously_focused);
2086 cmd_output->needs_tree_render = true;
2089 ipc_send_workspace_event("rename", workspace, NULL);
2090 ewmh_update_desktop_names();
2091 ewmh_update_desktop_viewport();
2092 ewmh_update_current_desktop();
2094 startup_sequence_rename_workspace(old_name, new_name);
2098 * Implementation of 'bar mode dock|hide|invisible|toggle [<bar_id>]'
2101 bool cmd_bar_mode(char *bar_mode, char *bar_id) {
2103 bool toggle = false;
2104 if (strcmp(bar_mode, "dock") == 0)
2106 else if (strcmp(bar_mode, "hide") == 0)
2108 else if (strcmp(bar_mode, "invisible") == 0)
2110 else if (strcmp(bar_mode, "toggle") == 0)
2113 ELOG("Unknown bar mode \"%s\", this is a mismatch between code and parser spec.\n", bar_mode);
2117 bool changed_sth = false;
2118 Barconfig *current = NULL;
2119 TAILQ_FOREACH(current, &barconfigs, configs) {
2120 if (bar_id && strcmp(current->id, bar_id) != 0)
2124 mode = (current->mode + 1) % 2;
2126 DLOG("Changing bar mode of bar_id '%s' to '%s (%d)'\n", current->id, bar_mode, mode);
2127 current->mode = mode;
2134 if (bar_id && !changed_sth) {
2135 DLOG("Changing bar mode of bar_id %s failed, bar_id not found.\n", bar_id);
2143 * Implementation of 'bar hidden_state hide|show|toggle [<bar_id>]'
2146 bool cmd_bar_hidden_state(char *bar_hidden_state, char *bar_id) {
2147 int hidden_state = S_SHOW;
2148 bool toggle = false;
2149 if (strcmp(bar_hidden_state, "hide") == 0)
2150 hidden_state = S_HIDE;
2151 else if (strcmp(bar_hidden_state, "show") == 0)
2152 hidden_state = S_SHOW;
2153 else if (strcmp(bar_hidden_state, "toggle") == 0)
2156 ELOG("Unknown bar state \"%s\", this is a mismatch between code and parser spec.\n", bar_hidden_state);
2160 bool changed_sth = false;
2161 Barconfig *current = NULL;
2162 TAILQ_FOREACH(current, &barconfigs, configs) {
2163 if (bar_id && strcmp(current->id, bar_id) != 0)
2167 hidden_state = (current->hidden_state + 1) % 2;
2169 DLOG("Changing bar hidden_state of bar_id '%s' to '%s (%d)'\n", current->id, bar_hidden_state, hidden_state);
2170 current->hidden_state = hidden_state;
2177 if (bar_id && !changed_sth) {
2178 DLOG("Changing bar hidden_state of bar_id %s failed, bar_id not found.\n", bar_id);
2186 * Implementation of 'bar (hidden_state hide|show|toggle)|(mode dock|hide|invisible|toggle) [<bar_id>]'
2189 void cmd_bar(I3_CMD, char *bar_type, char *bar_value, char *bar_id) {
2191 if (strcmp(bar_type, "mode") == 0)
2192 ret = cmd_bar_mode(bar_value, bar_id);
2193 else if (strcmp(bar_type, "hidden_state") == 0)
2194 ret = cmd_bar_hidden_state(bar_value, bar_id);
2196 ELOG("Unknown bar option type \"%s\", this is a mismatch between code and parser spec.\n", bar_type);
2208 * Implementation of 'shmlog <size>|toggle|on|off'
2211 void cmd_shmlog(I3_CMD, char *argument) {
2212 if (!strcmp(argument, "toggle"))
2213 /* Toggle shm log, if size is not 0. If it is 0, set it to default. */
2214 shmlog_size = shmlog_size ? -shmlog_size : default_shmlog_size;
2215 else if (!strcmp(argument, "on"))
2216 shmlog_size = default_shmlog_size;
2217 else if (!strcmp(argument, "off"))
2220 /* If shm logging now, restart logging with the new size. */
2221 if (shmlog_size > 0) {
2223 LOG("Restarting shm logging...\n");
2226 shmlog_size = atoi(argument);
2227 /* Make a weakly attempt at ensuring the argument is valid. */
2228 if (shmlog_size <= 0)
2229 shmlog_size = default_shmlog_size;
2231 LOG("%s shm logging\n", shmlog_size > 0 ? "Enabling" : "Disabling");
2233 update_shmlog_atom();
2234 // XXX: default reply for now, make this a better reply
2239 * Implementation of 'debuglog toggle|on|off'
2242 void cmd_debuglog(I3_CMD, char *argument) {
2243 bool logging = get_debug_logging();
2244 if (!strcmp(argument, "toggle")) {
2245 LOG("%s debug logging\n", logging ? "Disabling" : "Enabling");
2246 set_debug_logging(!logging);
2247 } else if (!strcmp(argument, "on") && !logging) {
2248 LOG("Enabling debug logging\n");
2249 set_debug_logging(true);
2250 } else if (!strcmp(argument, "off") && logging) {
2251 LOG("Disabling debug logging\n");
2252 set_debug_logging(false);
2254 // XXX: default reply for now, make this a better reply