2 * vim:ts=4:sw=4:expandtab
4 * i3 - an improved dynamic tiling window manager
5 * © 2009-2012 Michael Stapelberg and contributors (see also: LICENSE)
7 * commands.c: all command functions (see commands_parser.c)
15 // Macros to make the YAJL API a bit easier to use.
16 #define y(x, ...) yajl_gen_ ## x (cmd_output->json_gen, ##__VA_ARGS__)
17 #define ystr(str) yajl_gen_string(cmd_output->json_gen, (unsigned char*)str, strlen(str))
18 #define ysuccess(success) do { \
25 /** When the command did not include match criteria (!), we use the currently
26 * focused container. Do not confuse this case with a command which included
27 * criteria but which did not match any windows. This macro has to be called in
30 #define HANDLE_EMPTY_MATCH do { \
31 if (match_is_empty(current_match)) { \
32 owindow *ow = smalloc(sizeof(owindow)); \
34 TAILQ_INIT(&owindows); \
35 TAILQ_INSERT_TAIL(&owindows, ow, owindows); \
39 static owindows_head owindows;
42 * Returns true if a is definitely greater than b (using the given epsilon)
45 static bool definitelyGreaterThan(float a, float b, float epsilon) {
46 return (a - b) > ( (fabs(a) < fabs(b) ? fabs(b) : fabs(a)) * epsilon);
50 * Returns an 'output' corresponding to one of left/right/down/up or a specific
54 static Output *get_output_from_string(Output *current_output, const char *output_str) {
57 if (strcasecmp(output_str, "left") == 0) {
58 output = get_output_next(D_LEFT, current_output);
60 output = get_output_most(D_RIGHT, current_output);
61 } else if (strcasecmp(output_str, "right") == 0) {
62 output = get_output_next(D_RIGHT, current_output);
64 output = get_output_most(D_LEFT, current_output);
65 } else if (strcasecmp(output_str, "up") == 0) {
66 output = get_output_next(D_UP, current_output);
68 output = get_output_most(D_DOWN, current_output);
69 } else if (strcasecmp(output_str, "down") == 0) {
70 output = get_output_next(D_DOWN, current_output);
72 output = get_output_most(D_UP, current_output);
73 } else output = get_output_by_name(output_str);
79 * Checks whether we switched to a new workspace and returns false in that case,
80 * signaling that further workspace switching should be done by the calling function
81 * If not, calls workspace_back_and_forth() if workspace_auto_back_and_forth is set
82 * and return true, signaling that no further workspace switching should occur in the calling function.
85 static bool maybe_back_and_forth(struct CommandResult *cmd_output, char *name) {
86 Con *ws = con_get_workspace(focused);
88 /* If we switched to a different workspace, do nothing */
89 if (strcmp(ws->name, name) != 0)
92 DLOG("This workspace is already focused.\n");
93 if (config.workspace_auto_back_and_forth) {
94 workspace_back_and_forth();
95 cmd_output->needs_tree_render = true;
100 // This code is commented out because we might recycle it for popping up error
101 // messages on parser errors.
103 static pid_t migration_pid = -1;
106 * Handler which will be called when we get a SIGCHLD for the nagbar, meaning
107 * it exited (or could not be started, depending on the exit code).
110 static void nagbar_exited(EV_P_ ev_child *watcher, int revents) {
111 ev_child_stop(EV_A_ watcher);
112 if (!WIFEXITED(watcher->rstatus)) {
113 fprintf(stderr, "ERROR: i3-nagbar did not exit normally.\n");
117 int exitcode = WEXITSTATUS(watcher->rstatus);
118 printf("i3-nagbar process exited with status %d\n", exitcode);
120 fprintf(stderr, "ERROR: i3-nagbar could not be found. Is it correctly installed on your system?\n");
126 /* We need ev >= 4 for the following code. Since it is not *that* important (it
127 * only makes sure that there are no i3-nagbar instances left behind) we still
128 * support old systems with libev 3. */
129 #if EV_VERSION_MAJOR >= 4
131 * Cleanup handler. Will be called when i3 exits. Kills i3-nagbar with signal
132 * SIGKILL (9) to make sure there are no left-over i3-nagbar processes.
135 static void nagbar_cleanup(EV_P_ ev_cleanup *watcher, int revent) {
136 if (migration_pid != -1) {
137 LOG("Sending SIGKILL (9) to i3-nagbar with PID %d\n", migration_pid);
138 kill(migration_pid, SIGKILL);
143 void cmd_MIGRATION_start_nagbar(void) {
144 if (migration_pid != -1) {
145 fprintf(stderr, "i3-nagbar already running.\n");
148 fprintf(stderr, "Starting i3-nagbar, command parsing differs from expected output.\n");
149 ELOG("Please report this on IRC or in the bugtracker. Make sure to include the full debug level logfile:\n");
150 ELOG("i3-dump-log | gzip -9c > /tmp/i3.log.gz\n");
151 ELOG("FYI: Your i3 version is " I3_VERSION "\n");
152 migration_pid = fork();
153 if (migration_pid == -1) {
154 warn("Could not fork()");
159 if (migration_pid == 0) {
161 sasprintf(&pageraction, "i3-sensible-terminal -e i3-sensible-pager \"%s\"", errorfilename);
163 NULL, /* will be replaced by the executable path */
167 "You found a parsing error. Please, please, please, report it!",
173 exec_i3_utility("i3-nagbar", argv);
177 /* install a child watcher */
178 ev_child *child = smalloc(sizeof(ev_child));
179 ev_child_init(child, &nagbar_exited, migration_pid, 0);
180 ev_child_start(main_loop, child);
182 /* We need ev >= 4 for the following code. Since it is not *that* important (it
183 * only makes sure that there are no i3-nagbar instances left behind) we still
184 * support old systems with libev 3. */
185 #if EV_VERSION_MAJOR >= 4
186 /* install a cleanup watcher (will be called when i3 exits and i3-nagbar is
188 ev_cleanup *cleanup = smalloc(sizeof(ev_cleanup));
189 ev_cleanup_init(cleanup, nagbar_cleanup);
190 ev_cleanup_start(main_loop, cleanup);
196 /*******************************************************************************
197 * Criteria functions.
198 ******************************************************************************/
201 * Initializes the specified 'Match' data structure and the initial state of
202 * commands.c for matching target windows of a command.
205 void cmd_criteria_init(I3_CMD) {
209 DLOG("Initializing criteria, current_match = %p\n", current_match);
210 match_init(current_match);
211 while (!TAILQ_EMPTY(&owindows)) {
212 ow = TAILQ_FIRST(&owindows);
213 TAILQ_REMOVE(&owindows, ow, owindows);
216 TAILQ_INIT(&owindows);
218 TAILQ_FOREACH(con, &all_cons, all_cons) {
219 ow = smalloc(sizeof(owindow));
221 TAILQ_INSERT_TAIL(&owindows, ow, owindows);
226 * A match specification just finished (the closing square bracket was found),
227 * so we filter the list of owindows.
230 void cmd_criteria_match_windows(I3_CMD) {
231 owindow *next, *current;
233 DLOG("match specification finished, matching...\n");
234 /* copy the old list head to iterate through it and start with a fresh
235 * list which will contain only matching windows */
236 struct owindows_head old = owindows;
237 TAILQ_INIT(&owindows);
238 for (next = TAILQ_FIRST(&old); next != TAILQ_END(&old);) {
239 /* make a copy of the next pointer and advance the pointer to the
240 * next element as we are going to invalidate the element’s
241 * next/prev pointers by calling TAILQ_INSERT_TAIL later */
243 next = TAILQ_NEXT(next, owindows);
245 DLOG("checking if con %p / %s matches\n", current->con, current->con->name);
246 if (current_match->con_id != NULL) {
247 if (current_match->con_id == current->con) {
248 DLOG("matches container!\n");
249 TAILQ_INSERT_TAIL(&owindows, current, owindows);
251 } else if (current_match->mark != NULL && current->con->mark != NULL &&
252 regex_matches(current_match->mark, current->con->mark)) {
253 DLOG("match by mark\n");
254 TAILQ_INSERT_TAIL(&owindows, current, owindows);
256 if (current->con->window == NULL)
258 if (match_matches_window(current_match, current->con->window)) {
259 DLOG("matches window!\n");
260 TAILQ_INSERT_TAIL(&owindows, current, owindows);
262 DLOG("doesnt match\n");
268 TAILQ_FOREACH(current, &owindows, owindows) {
269 DLOG("matching: %p / %s\n", current->con, current->con->name);
274 * Interprets a ctype=cvalue pair and adds it to the current match
278 void cmd_criteria_add(I3_CMD, char *ctype, char *cvalue) {
279 DLOG("ctype=*%s*, cvalue=*%s*\n", ctype, cvalue);
281 if (strcmp(ctype, "class") == 0) {
282 current_match->class = regex_new(cvalue);
286 if (strcmp(ctype, "instance") == 0) {
287 current_match->instance = regex_new(cvalue);
291 if (strcmp(ctype, "window_role") == 0) {
292 current_match->role = regex_new(cvalue);
296 if (strcmp(ctype, "con_id") == 0) {
298 long parsed = strtol(cvalue, &end, 10);
299 if (parsed == LONG_MIN ||
300 parsed == LONG_MAX ||
302 (end && *end != '\0')) {
303 ELOG("Could not parse con id \"%s\"\n", cvalue);
305 current_match->con_id = (Con*)parsed;
306 printf("id as int = %p\n", current_match->con_id);
311 if (strcmp(ctype, "id") == 0) {
313 long parsed = strtol(cvalue, &end, 10);
314 if (parsed == LONG_MIN ||
315 parsed == LONG_MAX ||
317 (end && *end != '\0')) {
318 ELOG("Could not parse window id \"%s\"\n", cvalue);
320 current_match->id = parsed;
321 printf("window id as int = %d\n", current_match->id);
326 if (strcmp(ctype, "con_mark") == 0) {
327 current_match->mark = regex_new(cvalue);
331 if (strcmp(ctype, "title") == 0) {
332 current_match->title = regex_new(cvalue);
336 if (strcmp(ctype, "urgent") == 0) {
337 if (strcasecmp(cvalue, "latest") == 0 ||
338 strcasecmp(cvalue, "newest") == 0 ||
339 strcasecmp(cvalue, "recent") == 0 ||
340 strcasecmp(cvalue, "last") == 0) {
341 current_match->urgent = U_LATEST;
342 } else if (strcasecmp(cvalue, "oldest") == 0 ||
343 strcasecmp(cvalue, "first") == 0) {
344 current_match->urgent = U_OLDEST;
349 ELOG("Unknown criterion: %s\n", ctype);
353 * Implementation of 'move [window|container] [to] workspace
354 * next|prev|next_on_output|prev_on_output|current'.
357 void cmd_move_con_to_workspace(I3_CMD, char *which) {
360 DLOG("which=%s\n", which);
362 /* We have nothing to move:
363 * when criteria was specified but didn't match any window or
364 * when criteria wasn't specified and we don't have any window focused. */
365 if ((!match_is_empty(current_match) && TAILQ_EMPTY(&owindows)) ||
366 (match_is_empty(current_match) && focused->type == CT_WORKSPACE)) {
373 /* get the workspace */
375 if (strcmp(which, "next") == 0)
376 ws = workspace_next();
377 else if (strcmp(which, "prev") == 0)
378 ws = workspace_prev();
379 else if (strcmp(which, "next_on_output") == 0)
380 ws = workspace_next_on_output();
381 else if (strcmp(which, "prev_on_output") == 0)
382 ws = workspace_prev_on_output();
383 else if (strcmp(which, "current") == 0)
384 ws = con_get_workspace(focused);
386 ELOG("BUG: called with which=%s\n", which);
391 TAILQ_FOREACH(current, &owindows, owindows) {
392 DLOG("matching: %p / %s\n", current->con, current->con->name);
393 con_move_to_workspace(current->con, ws, true, false);
396 cmd_output->needs_tree_render = true;
397 // XXX: default reply for now, make this a better reply
402 * Implementation of 'move [window|container] [to] workspace <name>'.
405 void cmd_move_con_to_workspace_name(I3_CMD, char *name) {
406 if (strncasecmp(name, "__i3_", strlen("__i3_")) == 0) {
407 LOG("You cannot switch to the i3 internal workspaces.\n");
414 /* We have nothing to move:
415 * when criteria was specified but didn't match any window or
416 * when criteria wasn't specified and we don't have any window focused. */
417 if ((!match_is_empty(current_match) && TAILQ_EMPTY(&owindows)) ||
418 (match_is_empty(current_match) && focused->type == CT_WORKSPACE)) {
423 LOG("should move window to workspace %s\n", name);
424 /* get the workspace */
425 Con *ws = workspace_get(name, NULL);
429 TAILQ_FOREACH(current, &owindows, owindows) {
430 DLOG("matching: %p / %s\n", current->con, current->con->name);
431 con_move_to_workspace(current->con, ws, true, false);
434 cmd_output->needs_tree_render = true;
435 // XXX: default reply for now, make this a better reply
440 * Implementation of 'move [window|container] [to] workspace number <number>'.
443 void cmd_move_con_to_workspace_number(I3_CMD, char *which) {
446 /* We have nothing to move:
447 * when criteria was specified but didn't match any window or
448 * when criteria wasn't specified and we don't have any window focused. */
449 if ((!match_is_empty(current_match) && TAILQ_EMPTY(&owindows)) ||
450 (match_is_empty(current_match) && focused->type == CT_WORKSPACE)) {
455 LOG("should move window to workspace with number %d\n", which);
456 /* get the workspace */
457 Con *output, *workspace = NULL;
460 long parsed_num = strtol(which, &endptr, 10);
461 if (parsed_num == LONG_MIN ||
462 parsed_num == LONG_MAX ||
465 LOG("Could not parse \"%s\" as a number.\n", which);
470 // TODO: better error message
471 ystr("Could not parse number");
476 TAILQ_FOREACH(output, &(croot->nodes_head), nodes)
477 GREP_FIRST(workspace, output_get_content(output),
478 child->num == parsed_num);
485 // TODO: better error message
486 ystr("No such workspace");
493 TAILQ_FOREACH(current, &owindows, owindows) {
494 DLOG("matching: %p / %s\n", current->con, current->con->name);
495 con_move_to_workspace(current->con, workspace, true, false);
498 cmd_output->needs_tree_render = true;
499 // XXX: default reply for now, make this a better reply
503 static void cmd_resize_floating(I3_CMD, char *way, char *direction, Con *floating_con, int px) {
504 LOG("floating resize\n");
505 if (strcmp(direction, "up") == 0) {
506 floating_con->rect.y -= px;
507 floating_con->rect.height += px;
508 } else if (strcmp(direction, "down") == 0) {
509 floating_con->rect.height += px;
510 } else if (strcmp(direction, "left") == 0) {
511 floating_con->rect.x -= px;
512 floating_con->rect.width += px;
514 floating_con->rect.width += px;
518 static bool cmd_resize_tiling_direction(I3_CMD, char *way, char *direction, int ppt) {
519 LOG("tiling resize\n");
520 /* get the appropriate current container (skip stacked/tabbed cons) */
521 Con *current = focused;
522 while (current->parent->layout == L_STACKED ||
523 current->parent->layout == L_TABBED)
524 current = current->parent;
526 /* Then further go up until we find one with the matching orientation. */
527 orientation_t search_orientation =
528 (strcmp(direction, "left") == 0 || strcmp(direction, "right") == 0 ? HORIZ : VERT);
530 while (current->type != CT_WORKSPACE &&
531 current->type != CT_FLOATING_CON &&
532 current->parent->orientation != search_orientation)
533 current = current->parent;
535 /* get the default percentage */
536 int children = con_num_children(current->parent);
538 LOG("ins. %d children\n", children);
539 double percentage = 1.0 / children;
540 LOG("default percentage = %f\n", percentage);
542 orientation_t orientation = current->parent->orientation;
544 if ((orientation == HORIZ &&
545 (strcmp(direction, "up") == 0 || strcmp(direction, "down") == 0)) ||
546 (orientation == VERT &&
547 (strcmp(direction, "left") == 0 || strcmp(direction, "right") == 0))) {
548 LOG("You cannot resize in that direction. Your focus is in a %s split container currently.\n",
549 (orientation == HORIZ ? "horizontal" : "vertical"));
554 if (strcmp(direction, "up") == 0 || strcmp(direction, "left") == 0) {
555 other = TAILQ_PREV(current, nodes_head, nodes);
557 other = TAILQ_NEXT(current, nodes);
559 if (other == TAILQ_END(workspaces)) {
560 LOG("No other container in this direction found, cannot resize.\n");
564 LOG("other->percent = %f\n", other->percent);
565 LOG("current->percent before = %f\n", current->percent);
566 if (current->percent == 0.0)
567 current->percent = percentage;
568 if (other->percent == 0.0)
569 other->percent = percentage;
570 double new_current_percent = current->percent + ((double)ppt / 100.0);
571 double new_other_percent = other->percent - ((double)ppt / 100.0);
572 LOG("new_current_percent = %f\n", new_current_percent);
573 LOG("new_other_percent = %f\n", new_other_percent);
574 /* Ensure that the new percentages are positive and greater than
575 * 0.05 to have a reasonable minimum size. */
576 if (definitelyGreaterThan(new_current_percent, 0.05, DBL_EPSILON) &&
577 definitelyGreaterThan(new_other_percent, 0.05, DBL_EPSILON)) {
578 current->percent += ((double)ppt / 100.0);
579 other->percent -= ((double)ppt / 100.0);
580 LOG("current->percent after = %f\n", current->percent);
581 LOG("other->percent after = %f\n", other->percent);
583 LOG("Not resizing, already at minimum size\n");
589 static bool cmd_resize_tiling_width_height(I3_CMD, char *way, char *direction, int ppt) {
590 LOG("width/height resize\n");
591 /* get the appropriate current container (skip stacked/tabbed cons) */
592 Con *current = focused;
593 while (current->parent->layout == L_STACKED ||
594 current->parent->layout == L_TABBED)
595 current = current->parent;
597 /* Then further go up until we find one with the matching orientation. */
598 orientation_t search_orientation =
599 (strcmp(direction, "width") == 0 ? HORIZ : VERT);
601 while (current->type != CT_WORKSPACE &&
602 current->type != CT_FLOATING_CON &&
603 current->parent->orientation != search_orientation)
604 current = current->parent;
606 /* get the default percentage */
607 int children = con_num_children(current->parent);
608 LOG("ins. %d children\n", children);
609 double percentage = 1.0 / children;
610 LOG("default percentage = %f\n", percentage);
612 orientation_t orientation = current->parent->orientation;
614 if ((orientation == HORIZ &&
615 strcmp(direction, "height") == 0) ||
616 (orientation == VERT &&
617 strcmp(direction, "width") == 0)) {
618 LOG("You cannot resize in that direction. Your focus is in a %s split container currently.\n",
619 (orientation == HORIZ ? "horizontal" : "vertical"));
625 LOG("This is the only container, cannot resize.\n");
630 /* Ensure all the other children have a percentage set. */
632 TAILQ_FOREACH(child, &(current->parent->nodes_head), nodes) {
633 LOG("child->percent = %f (child %p)\n", child->percent, child);
634 if (child->percent == 0.0)
635 child->percent = percentage;
638 double new_current_percent = current->percent + ((double)ppt / 100.0);
639 double subtract_percent = ((double)ppt / 100.0) / (children - 1);
640 LOG("new_current_percent = %f\n", new_current_percent);
641 LOG("subtract_percent = %f\n", subtract_percent);
642 /* Ensure that the new percentages are positive and greater than
643 * 0.05 to have a reasonable minimum size. */
644 TAILQ_FOREACH(child, &(current->parent->nodes_head), nodes) {
645 if (child == current)
647 if (!definitelyGreaterThan(child->percent - subtract_percent, 0.05, DBL_EPSILON)) {
648 LOG("Not resizing, already at minimum size (child %p would end up with a size of %.f\n", child, child->percent - subtract_percent);
653 if (!definitelyGreaterThan(new_current_percent, 0.05, DBL_EPSILON)) {
654 LOG("Not resizing, already at minimum size\n");
659 current->percent += ((double)ppt / 100.0);
660 LOG("current->percent after = %f\n", current->percent);
662 TAILQ_FOREACH(child, &(current->parent->nodes_head), nodes) {
663 if (child == current)
665 child->percent -= subtract_percent;
666 LOG("child->percent after (%p) = %f\n", child, child->percent);
673 * Implementation of 'resize grow|shrink <direction> [<px> px] [or <ppt> ppt]'.
676 void cmd_resize(I3_CMD, char *way, char *direction, char *resize_px, char *resize_ppt) {
677 /* resize <grow|shrink> <direction> [<px> px] [or <ppt> ppt] */
678 DLOG("resizing in way %s, direction %s, px %s or ppt %s\n", way, direction, resize_px, resize_ppt);
679 // 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
680 int px = atoi(resize_px);
681 int ppt = atoi(resize_ppt);
682 if (strcmp(way, "shrink") == 0) {
688 if ((floating_con = con_inside_floating(focused))) {
689 cmd_resize_floating(current_match, cmd_output, way, direction, floating_con, px);
691 if (strcmp(direction, "width") == 0 ||
692 strcmp(direction, "height") == 0) {
693 if (!cmd_resize_tiling_width_height(current_match, cmd_output, way, direction, ppt))
696 if (!cmd_resize_tiling_direction(current_match, cmd_output, way, direction, ppt))
701 cmd_output->needs_tree_render = true;
702 // XXX: default reply for now, make this a better reply
707 * Implementation of 'border normal|none|1pixel|toggle'.
710 void cmd_border(I3_CMD, char *border_style_str) {
711 DLOG("border style should be changed to %s\n", border_style_str);
716 TAILQ_FOREACH(current, &owindows, owindows) {
717 DLOG("matching: %p / %s\n", current->con, current->con->name);
718 int border_style = current->con->border_style;
719 if (strcmp(border_style_str, "toggle") == 0) {
723 if (strcmp(border_style_str, "normal") == 0)
724 border_style = BS_NORMAL;
725 else if (strcmp(border_style_str, "none") == 0)
726 border_style = BS_NONE;
727 else if (strcmp(border_style_str, "1pixel") == 0)
728 border_style = BS_1PIXEL;
730 ELOG("BUG: called with border_style=%s\n", border_style_str);
735 con_set_border_style(current->con, border_style);
738 cmd_output->needs_tree_render = true;
739 // XXX: default reply for now, make this a better reply
744 * Implementation of 'nop <comment>'.
747 void cmd_nop(I3_CMD, char *comment) {
748 LOG("-------------------------------------------------\n");
749 LOG(" NOP: %s\n", comment);
750 LOG("-------------------------------------------------\n");
754 * Implementation of 'append_layout <path>'.
757 void cmd_append_layout(I3_CMD, char *path) {
758 LOG("Appending layout \"%s\"\n", path);
759 tree_append_json(path);
761 cmd_output->needs_tree_render = true;
762 // XXX: default reply for now, make this a better reply
767 * Implementation of 'workspace next|prev|next_on_output|prev_on_output'.
770 void cmd_workspace(I3_CMD, char *which) {
773 DLOG("which=%s\n", which);
775 if (strcmp(which, "next") == 0)
776 ws = workspace_next();
777 else if (strcmp(which, "prev") == 0)
778 ws = workspace_prev();
779 else if (strcmp(which, "next_on_output") == 0)
780 ws = workspace_next_on_output();
781 else if (strcmp(which, "prev_on_output") == 0)
782 ws = workspace_prev_on_output();
784 ELOG("BUG: called with which=%s\n", which);
791 cmd_output->needs_tree_render = true;
792 // XXX: default reply for now, make this a better reply
797 * Implementation of 'workspace number <number>'
800 void cmd_workspace_number(I3_CMD, char *which) {
801 Con *output, *workspace = NULL;
804 long parsed_num = strtol(which, &endptr, 10);
805 if (parsed_num == LONG_MIN ||
806 parsed_num == LONG_MAX ||
809 LOG("Could not parse \"%s\" as a number.\n", which);
814 // TODO: better error message
815 ystr("Could not parse number");
821 TAILQ_FOREACH(output, &(croot->nodes_head), nodes)
822 GREP_FIRST(workspace, output_get_content(output),
823 child->num == parsed_num);
826 LOG("There is no workspace with number %d, creating a new one.\n", parsed_num);
828 /* terminate the which string after the endposition of the number */
830 if (maybe_back_and_forth(cmd_output, which))
832 workspace_show_by_name(which);
833 cmd_output->needs_tree_render = true;
836 if (maybe_back_and_forth(cmd_output, which))
838 workspace_show(workspace);
840 cmd_output->needs_tree_render = true;
841 // XXX: default reply for now, make this a better reply
846 * Implementation of 'workspace back_and_forth'.
849 void cmd_workspace_back_and_forth(I3_CMD) {
850 workspace_back_and_forth();
852 cmd_output->needs_tree_render = true;
853 // XXX: default reply for now, make this a better reply
858 * Implementation of 'workspace <name>'
861 void cmd_workspace_name(I3_CMD, char *name) {
862 if (strncasecmp(name, "__i3_", strlen("__i3_")) == 0) {
863 LOG("You cannot switch to the i3 internal workspaces.\n");
868 DLOG("should switch to workspace %s\n", name);
869 if (maybe_back_and_forth(cmd_output, name))
871 workspace_show_by_name(name);
873 cmd_output->needs_tree_render = true;
874 // XXX: default reply for now, make this a better reply
879 * Implementation of 'mark <mark>'
882 void cmd_mark(I3_CMD, char *mark) {
883 DLOG("Clearing all windows which have that mark first\n");
886 TAILQ_FOREACH(con, &all_cons, all_cons) {
887 if (con->mark && strcmp(con->mark, mark) == 0)
891 DLOG("marking window with str %s\n", mark);
896 TAILQ_FOREACH(current, &owindows, owindows) {
897 DLOG("matching: %p / %s\n", current->con, current->con->name);
898 current->con->mark = sstrdup(mark);
901 cmd_output->needs_tree_render = true;
902 // XXX: default reply for now, make this a better reply
907 * Implementation of 'mode <string>'.
910 void cmd_mode(I3_CMD, char *mode) {
911 DLOG("mode=%s\n", mode);
914 // XXX: default reply for now, make this a better reply
919 * Implementation of 'move [window|container] [to] output <str>'.
922 void cmd_move_con_to_output(I3_CMD, char *name) {
925 DLOG("should move window to output %s\n", name);
930 Output *current_output = NULL;
933 // TODO: fix the handling of criteria
934 TAILQ_FOREACH(current, &owindows, owindows)
935 current_output = get_output_containing(current->con->rect.x, current->con->rect.y);
937 assert(current_output != NULL);
939 // TODO: clean this up with commands.spec as soon as we switched away from the lex/yacc command parser
940 if (strcasecmp(name, "up") == 0)
941 output = get_output_next(D_UP, current_output);
942 else if (strcasecmp(name, "down") == 0)
943 output = get_output_next(D_DOWN, current_output);
944 else if (strcasecmp(name, "left") == 0)
945 output = get_output_next(D_LEFT, current_output);
946 else if (strcasecmp(name, "right") == 0)
947 output = get_output_next(D_RIGHT, current_output);
949 output = get_output_by_name(name);
952 LOG("No such output found.\n");
957 /* get visible workspace on output */
959 GREP_FIRST(ws, output_get_content(output->con), workspace_is_visible(child));
965 TAILQ_FOREACH(current, &owindows, owindows) {
966 DLOG("matching: %p / %s\n", current->con, current->con->name);
967 con_move_to_workspace(current->con, ws, true, false);
970 cmd_output->needs_tree_render = true;
971 // XXX: default reply for now, make this a better reply
976 * Implementation of 'floating enable|disable|toggle'
979 void cmd_floating(I3_CMD, char *floating_mode) {
982 DLOG("floating_mode=%s\n", floating_mode);
986 TAILQ_FOREACH(current, &owindows, owindows) {
987 DLOG("matching: %p / %s\n", current->con, current->con->name);
988 if (strcmp(floating_mode, "toggle") == 0) {
989 DLOG("should toggle mode\n");
990 toggle_floating_mode(current->con, false);
992 DLOG("should switch mode to %s\n", floating_mode);
993 if (strcmp(floating_mode, "enable") == 0) {
994 floating_enable(current->con, false);
996 floating_disable(current->con, false);
1001 cmd_output->needs_tree_render = true;
1002 // XXX: default reply for now, make this a better reply
1007 * Implementation of 'move workspace to [output] <str>'.
1010 void cmd_move_workspace_to_output(I3_CMD, char *name) {
1011 DLOG("should move workspace to output %s\n", name);
1016 TAILQ_FOREACH(current, &owindows, owindows) {
1017 Output *current_output = get_output_containing(current->con->rect.x,
1018 current->con->rect.y);
1019 Output *output = get_output_from_string(current_output, name);
1021 LOG("No such output\n");
1026 Con *content = output_get_content(output->con);
1027 LOG("got output %p with content %p\n", output, content);
1029 Con *ws = con_get_workspace(current->con);
1030 LOG("should move workspace %p / %s\n", ws, ws->name);
1032 if (con_num_children(ws->parent) == 1) {
1033 LOG("Creating a new workspace to replace \"%s\" (last on its output).\n", ws->name);
1035 /* check if we can find a workspace assigned to this output */
1036 bool used_assignment = false;
1037 struct Workspace_Assignment *assignment;
1038 TAILQ_FOREACH(assignment, &ws_assignments, ws_assignments) {
1039 if (strcmp(assignment->output, current_output->name) != 0)
1042 /* check if this workspace is already attached to the tree */
1043 Con *workspace = NULL, *out;
1044 TAILQ_FOREACH(out, &(croot->nodes_head), nodes)
1045 GREP_FIRST(workspace, output_get_content(out),
1046 !strcasecmp(child->name, assignment->name));
1047 if (workspace != NULL)
1050 /* so create the workspace referenced to by this assignment */
1051 LOG("Creating workspace from assignment %s.\n", assignment->name);
1052 workspace_get(assignment->name, NULL);
1053 used_assignment = true;
1057 /* if we couldn't create the workspace using an assignment, create
1058 * it on the output */
1059 if (!used_assignment)
1060 create_workspace_on_output(current_output, ws->parent);
1062 /* notify the IPC listeners */
1063 ipc_send_event("workspace", I3_IPC_EVENT_WORKSPACE, "{\"change\":\"init\"}");
1066 /* detach from the old output and attach to the new output */
1067 bool workspace_was_visible = workspace_is_visible(ws);
1068 Con *old_content = ws->parent;
1070 if (workspace_was_visible) {
1071 /* The workspace which we just detached was visible, so focus
1072 * the next one in the focus-stack. */
1073 Con *focus_ws = TAILQ_FIRST(&(old_content->focus_head));
1074 LOG("workspace was visible, focusing %p / %s now\n", focus_ws, focus_ws->name);
1075 workspace_show(focus_ws);
1077 con_attach(ws, content, false);
1079 /* fix the coordinates of the floating containers */
1081 TAILQ_FOREACH(floating_con, &(ws->floating_head), floating_windows)
1082 floating_fix_coordinates(floating_con, &(old_content->rect), &(content->rect));
1084 ipc_send_event("workspace", I3_IPC_EVENT_WORKSPACE, "{\"change\":\"move\"}");
1085 if (workspace_was_visible) {
1086 /* Focus the moved workspace on the destination output. */
1091 cmd_output->needs_tree_render = true;
1092 // XXX: default reply for now, make this a better reply
1097 * Implementation of 'split v|h|vertical|horizontal'.
1100 void cmd_split(I3_CMD, char *direction) {
1101 /* TODO: use matches */
1102 LOG("splitting in direction %c\n", direction[0]);
1103 tree_split(focused, (direction[0] == 'v' ? VERT : HORIZ));
1105 cmd_output->needs_tree_render = true;
1106 // XXX: default reply for now, make this a better reply
1111 * Implementaiton of 'kill [window|client]'.
1114 void cmd_kill(I3_CMD, char *kill_mode_str) {
1115 if (kill_mode_str == NULL)
1116 kill_mode_str = "window";
1119 DLOG("kill_mode=%s\n", kill_mode_str);
1122 if (strcmp(kill_mode_str, "window") == 0)
1123 kill_mode = KILL_WINDOW;
1124 else if (strcmp(kill_mode_str, "client") == 0)
1125 kill_mode = KILL_CLIENT;
1127 ELOG("BUG: called with kill_mode=%s\n", kill_mode_str);
1132 /* check if the match is empty, not if the result is empty */
1133 if (match_is_empty(current_match))
1134 tree_close_con(kill_mode);
1136 TAILQ_FOREACH(current, &owindows, owindows) {
1137 DLOG("matching: %p / %s\n", current->con, current->con->name);
1138 tree_close(current->con, kill_mode, false, false);
1142 cmd_output->needs_tree_render = true;
1143 // XXX: default reply for now, make this a better reply
1148 * Implementation of 'exec [--no-startup-id] <command>'.
1151 void cmd_exec(I3_CMD, char *nosn, char *command) {
1152 bool no_startup_id = (nosn != NULL);
1154 DLOG("should execute %s, no_startup_id = %d\n", command, no_startup_id);
1155 start_application(command, no_startup_id);
1157 // XXX: default reply for now, make this a better reply
1162 * Implementation of 'focus left|right|up|down'.
1165 void cmd_focus_direction(I3_CMD, char *direction) {
1167 focused->type != CT_WORKSPACE &&
1168 focused->fullscreen_mode != CF_NONE) {
1169 LOG("Cannot change focus while in fullscreen mode.\n");
1174 DLOG("direction = *%s*\n", direction);
1176 if (strcmp(direction, "left") == 0)
1177 tree_next('p', HORIZ);
1178 else if (strcmp(direction, "right") == 0)
1179 tree_next('n', HORIZ);
1180 else if (strcmp(direction, "up") == 0)
1181 tree_next('p', VERT);
1182 else if (strcmp(direction, "down") == 0)
1183 tree_next('n', VERT);
1185 ELOG("Invalid focus direction (%s)\n", direction);
1190 cmd_output->needs_tree_render = true;
1191 // XXX: default reply for now, make this a better reply
1196 * Implementation of 'focus tiling|floating|mode_toggle'.
1199 void cmd_focus_window_mode(I3_CMD, char *window_mode) {
1201 focused->type != CT_WORKSPACE &&
1202 focused->fullscreen_mode != CF_NONE) {
1203 LOG("Cannot change focus while in fullscreen mode.\n");
1208 DLOG("window_mode = %s\n", window_mode);
1210 Con *ws = con_get_workspace(focused);
1213 if (strcmp(window_mode, "mode_toggle") == 0) {
1214 current = TAILQ_FIRST(&(ws->focus_head));
1215 if (current != NULL && current->type == CT_FLOATING_CON)
1216 window_mode = "tiling";
1217 else window_mode = "floating";
1219 TAILQ_FOREACH(current, &(ws->focus_head), focused) {
1220 if ((strcmp(window_mode, "floating") == 0 && current->type != CT_FLOATING_CON) ||
1221 (strcmp(window_mode, "tiling") == 0 && current->type == CT_FLOATING_CON))
1224 con_focus(con_descend_focused(current));
1229 cmd_output->needs_tree_render = true;
1230 // XXX: default reply for now, make this a better reply
1235 * Implementation of 'focus parent|child'.
1238 void cmd_focus_level(I3_CMD, char *level) {
1239 DLOG("level = %s\n", level);
1240 bool success = false;
1242 /* Focusing the parent can only be allowed if the newly
1243 * focused container won't escape the fullscreen container. */
1244 if (strcmp(level, "parent") == 0) {
1245 if (focused && focused->parent) {
1246 if (con_fullscreen_permits_focusing(focused->parent))
1247 success = level_up();
1249 LOG("Currently in fullscreen, not going up\n");
1253 /* Focusing a child should always be allowed. */
1254 else success = level_down();
1256 cmd_output->needs_tree_render = success;
1257 // XXX: default reply for now, make this a better reply
1262 * Implementation of 'focus'.
1265 void cmd_focus(I3_CMD) {
1266 DLOG("current_match = %p\n", current_match);
1268 if (match_is_empty(current_match)) {
1269 ELOG("You have to specify which window/container should be focused.\n");
1270 ELOG("Example: [class=\"urxvt\" title=\"irssi\"] focus\n");
1276 ystr("You have to specify which window/container should be focused");
1284 TAILQ_FOREACH(current, &owindows, owindows) {
1285 Con *ws = con_get_workspace(current->con);
1286 /* If no workspace could be found, this was a dock window.
1287 * Just skip it, you cannot focus dock windows. */
1291 /* Check the fullscreen focus constraints. */
1292 if (!con_fullscreen_permits_focusing(current->con)) {
1293 LOG("Cannot change focus while in fullscreen mode (fullscreen rules).\n");
1298 /* If the container is not on the current workspace,
1299 * workspace_show() will switch to a different workspace and (if
1300 * enabled) trigger a mouse pointer warp to the currently focused
1301 * container (!) on the target workspace.
1303 * Therefore, before calling workspace_show(), we make sure that
1304 * 'current' will be focused on the workspace. However, we cannot
1305 * just con_focus(current) because then the pointer will not be
1306 * warped at all (the code thinks we are already there).
1308 * So we focus 'current' to make it the currently focused window of
1309 * the target workspace, then revert focus. */
1310 Con *currently_focused = focused;
1311 con_focus(current->con);
1312 con_focus(currently_focused);
1314 /* Now switch to the workspace, then focus */
1316 LOG("focusing %p / %s\n", current->con, current->con->name);
1317 con_focus(current->con);
1322 LOG("WARNING: Your criteria for the focus command matches %d containers, "
1323 "while only exactly one container can be focused at a time.\n", count);
1325 cmd_output->needs_tree_render = true;
1326 // XXX: default reply for now, make this a better reply
1331 * Implementation of 'fullscreen [global]'.
1334 void cmd_fullscreen(I3_CMD, char *fullscreen_mode) {
1335 if (fullscreen_mode == NULL)
1336 fullscreen_mode = "output";
1337 DLOG("toggling fullscreen, mode = %s\n", fullscreen_mode);
1342 TAILQ_FOREACH(current, &owindows, owindows) {
1343 printf("matching: %p / %s\n", current->con, current->con->name);
1344 con_toggle_fullscreen(current->con, (strcmp(fullscreen_mode, "global") == 0 ? CF_GLOBAL : CF_OUTPUT));
1347 cmd_output->needs_tree_render = true;
1348 // XXX: default reply for now, make this a better reply
1353 * Implementation of 'move <direction> [<pixels> [px]]'.
1356 void cmd_move_direction(I3_CMD, char *direction, char *move_px) {
1357 // 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
1358 int px = atoi(move_px);
1360 /* TODO: make 'move' work with criteria. */
1361 DLOG("moving in direction %s, px %s\n", direction, move_px);
1362 if (con_is_floating(focused)) {
1363 DLOG("floating move with %d pixels\n", px);
1364 Rect newrect = focused->parent->rect;
1365 if (strcmp(direction, "left") == 0) {
1367 } else if (strcmp(direction, "right") == 0) {
1369 } else if (strcmp(direction, "up") == 0) {
1371 } else if (strcmp(direction, "down") == 0) {
1374 floating_reposition(focused->parent, newrect);
1376 tree_move((strcmp(direction, "right") == 0 ? D_RIGHT :
1377 (strcmp(direction, "left") == 0 ? D_LEFT :
1378 (strcmp(direction, "up") == 0 ? D_UP :
1380 cmd_output->needs_tree_render = true;
1383 // XXX: default reply for now, make this a better reply
1388 * Implementation of 'layout default|stacked|stacking|tabbed'.
1391 void cmd_layout(I3_CMD, char *layout_str) {
1392 if (strcmp(layout_str, "stacking") == 0)
1393 layout_str = "stacked";
1394 DLOG("changing layout to %s\n", layout_str);
1396 int layout = (strcmp(layout_str, "default") == 0 ? L_DEFAULT :
1397 (strcmp(layout_str, "stacked") == 0 ? L_STACKED :
1400 /* check if the match is empty, not if the result is empty */
1401 if (match_is_empty(current_match))
1402 con_set_layout(focused->parent, layout);
1404 TAILQ_FOREACH(current, &owindows, owindows) {
1405 DLOG("matching: %p / %s\n", current->con, current->con->name);
1406 con_set_layout(current->con, layout);
1410 cmd_output->needs_tree_render = true;
1411 // XXX: default reply for now, make this a better reply
1416 * Implementaiton of 'exit'.
1419 void cmd_exit(I3_CMD) {
1420 LOG("Exiting due to user command.\n");
1421 xcb_disconnect(conn);
1428 * Implementaiton of 'reload'.
1431 void cmd_reload(I3_CMD) {
1433 kill_configerror_nagbar(false);
1434 load_configuration(conn, NULL, true);
1436 /* Send an IPC event just in case the ws names have changed */
1437 ipc_send_event("workspace", I3_IPC_EVENT_WORKSPACE, "{\"change\":\"reload\"}");
1439 // XXX: default reply for now, make this a better reply
1444 * Implementaiton of 'restart'.
1447 void cmd_restart(I3_CMD) {
1448 LOG("restarting i3\n");
1451 // XXX: default reply for now, make this a better reply
1456 * Implementaiton of 'open'.
1459 void cmd_open(I3_CMD) {
1460 LOG("opening new container\n");
1461 Con *con = tree_open_con(NULL, NULL);
1468 y(integer, (long int)con);
1471 cmd_output->needs_tree_render = true;
1475 * Implementation of 'focus output <output>'.
1478 void cmd_focus_output(I3_CMD, char *name) {
1481 DLOG("name = %s\n", name);
1485 /* get the output */
1486 Output *current_output = NULL;
1489 TAILQ_FOREACH(current, &owindows, owindows)
1490 current_output = get_output_containing(current->con->rect.x, current->con->rect.y);
1491 assert(current_output != NULL);
1493 output = get_output_from_string(current_output, name);
1496 LOG("No such output found.\n");
1501 /* get visible workspace on output */
1503 GREP_FIRST(ws, output_get_content(output->con), workspace_is_visible(child));
1511 cmd_output->needs_tree_render = true;
1512 // XXX: default reply for now, make this a better reply
1517 * Implementation of 'move [window|container] [to] [absolute] position <px> [px] <px> [px]
1520 void cmd_move_window_to_position(I3_CMD, char *method, char *cx, char *cy) {
1525 if (!con_is_floating(focused)) {
1526 ELOG("Cannot change position. The window/container is not floating\n");
1531 ystr("Cannot change position. The window/container is not floating.");
1536 if (strcmp(method, "absolute") == 0) {
1537 focused->parent->rect.x = x;
1538 focused->parent->rect.y = y;
1540 DLOG("moving to absolute position %d %d\n", x, y);
1541 floating_maybe_reassign_ws(focused->parent);
1542 cmd_output->needs_tree_render = true;
1545 if (strcmp(method, "position") == 0) {
1546 Rect newrect = focused->parent->rect;
1548 DLOG("moving to position %d %d\n", x, y);
1552 floating_reposition(focused->parent, newrect);
1555 // XXX: default reply for now, make this a better reply
1560 * Implementation of 'move [window|container] [to] [absolute] position center
1563 void cmd_move_window_to_center(I3_CMD, char *method) {
1565 if (!con_is_floating(focused)) {
1566 ELOG("Cannot change position. The window/container is not floating\n");
1571 ystr("Cannot change position. The window/container is not floating.");
1575 if (strcmp(method, "absolute") == 0) {
1576 Rect *rect = &focused->parent->rect;
1578 DLOG("moving to absolute center\n");
1579 rect->x = croot->rect.width/2 - rect->width/2;
1580 rect->y = croot->rect.height/2 - rect->height/2;
1582 floating_maybe_reassign_ws(focused->parent);
1583 cmd_output->needs_tree_render = true;
1586 if (strcmp(method, "position") == 0) {
1587 Rect *wsrect = &con_get_workspace(focused)->rect;
1588 Rect newrect = focused->parent->rect;
1590 DLOG("moving to center\n");
1591 newrect.x = wsrect->width/2 - newrect.width/2;
1592 newrect.y = wsrect->height/2 - newrect.height/2;
1594 floating_reposition(focused->parent, newrect);
1597 // XXX: default reply for now, make this a better reply
1602 * Implementation of 'move scratchpad'.
1605 void cmd_move_scratchpad(I3_CMD) {
1606 DLOG("should move window to scratchpad\n");
1611 TAILQ_FOREACH(current, &owindows, owindows) {
1612 DLOG("matching: %p / %s\n", current->con, current->con->name);
1613 scratchpad_move(current->con);
1616 cmd_output->needs_tree_render = true;
1617 // XXX: default reply for now, make this a better reply
1622 * Implementation of 'scratchpad show'.
1625 void cmd_scratchpad_show(I3_CMD) {
1626 DLOG("should show scratchpad window\n");
1629 if (match_is_empty(current_match)) {
1630 scratchpad_show(NULL);
1632 TAILQ_FOREACH(current, &owindows, owindows) {
1633 DLOG("matching: %p / %s\n", current->con, current->con->name);
1634 scratchpad_show(current->con);
1638 cmd_output->needs_tree_render = true;
1639 // XXX: default reply for now, make this a better reply
1644 * Implementation of 'rename workspace <name> to <name>'
1647 void cmd_rename_workspace(I3_CMD, char *old_name, char *new_name) {
1648 LOG("Renaming workspace \"%s\" to \"%s\"\n", old_name, new_name);
1650 Con *output, *workspace = NULL;
1651 TAILQ_FOREACH(output, &(croot->nodes_head), nodes)
1652 GREP_FIRST(workspace, output_get_content(output),
1653 !strcasecmp(child->name, old_name));
1656 // TODO: we should include the old workspace name here and use yajl for
1657 // generating the reply.
1662 // TODO: better error message
1663 ystr("Old workspace not found");
1668 Con *check_dest = NULL;
1669 TAILQ_FOREACH(output, &(croot->nodes_head), nodes)
1670 GREP_FIRST(check_dest, output_get_content(output),
1671 !strcasecmp(child->name, new_name));
1673 if (check_dest != NULL) {
1674 // TODO: we should include the new workspace name here and use yajl for
1675 // generating the reply.
1680 // TODO: better error message
1681 ystr("New workspace already exists");
1686 /* Change the name and try to parse it as a number. */
1687 FREE(workspace->name);
1688 workspace->name = sstrdup(new_name);
1689 char *endptr = NULL;
1690 long parsed_num = strtol(new_name, &endptr, 10);
1691 if (parsed_num == LONG_MIN ||
1692 parsed_num == LONG_MAX ||
1695 workspace->num = -1;
1696 else workspace->num = parsed_num;
1697 LOG("num = %d\n", workspace->num);
1699 /* By re-attaching, the sort order will be correct afterwards. */
1700 Con *previously_focused = focused;
1701 Con *parent = workspace->parent;
1702 con_detach(workspace);
1703 con_attach(workspace, parent, false);
1704 /* Restore the previous focus since con_attach messes with the focus. */
1705 con_focus(previously_focused);
1707 cmd_output->needs_tree_render = true;
1710 ipc_send_event("workspace", I3_IPC_EVENT_WORKSPACE, "{\"change\":\"rename\"}");