2 #define I3__FILE__ "config_directives.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 * config_directives.c: all config storing functions (see config_parser.c)
17 /*******************************************************************************
19 ******************************************************************************/
21 static int criteria_next_state;
24 * Initializes the specified 'Match' data structure and the initial state of
25 * commands.c for matching target windows of a command.
28 CFGFUN(criteria_init, int _state) {
29 criteria_next_state = _state;
31 DLOG("Initializing criteria, current_match = %p, state = %d\n", current_match, _state);
32 match_init(current_match);
35 CFGFUN(criteria_pop_state) {
36 result->next_state = criteria_next_state;
40 * Interprets a ctype=cvalue pair and adds it to the current match
44 CFGFUN(criteria_add, const char *ctype, const char *cvalue) {
45 DLOG("ctype=*%s*, cvalue=*%s*\n", ctype, cvalue);
47 if (strcmp(ctype, "class") == 0) {
48 current_match->class = regex_new(cvalue);
52 if (strcmp(ctype, "instance") == 0) {
53 current_match->instance = regex_new(cvalue);
57 if (strcmp(ctype, "window_role") == 0) {
58 current_match->window_role = regex_new(cvalue);
62 if (strcmp(ctype, "con_id") == 0) {
64 long parsed = strtol(cvalue, &end, 10);
65 if (parsed == LONG_MIN ||
68 (end && *end != '\0')) {
69 ELOG("Could not parse con id \"%s\"\n", cvalue);
71 current_match->con_id = (Con *)parsed;
72 DLOG("id as int = %p\n", current_match->con_id);
77 if (strcmp(ctype, "id") == 0) {
79 long parsed = strtol(cvalue, &end, 10);
80 if (parsed == LONG_MIN ||
83 (end && *end != '\0')) {
84 ELOG("Could not parse window id \"%s\"\n", cvalue);
86 current_match->id = parsed;
87 DLOG("window id as int = %d\n", current_match->id);
92 if (strcmp(ctype, "window_type") == 0) {
93 if (strcasecmp(cvalue, "normal") == 0)
94 current_match->window_type = A__NET_WM_WINDOW_TYPE_NORMAL;
95 else if (strcasecmp(cvalue, "dialog") == 0)
96 current_match->window_type = A__NET_WM_WINDOW_TYPE_DIALOG;
97 else if (strcasecmp(cvalue, "utility") == 0)
98 current_match->window_type = A__NET_WM_WINDOW_TYPE_UTILITY;
99 else if (strcasecmp(cvalue, "toolbar") == 0)
100 current_match->window_type = A__NET_WM_WINDOW_TYPE_TOOLBAR;
101 else if (strcasecmp(cvalue, "splash") == 0)
102 current_match->window_type = A__NET_WM_WINDOW_TYPE_SPLASH;
103 else if (strcasecmp(cvalue, "menu") == 0)
104 current_match->window_type = A__NET_WM_WINDOW_TYPE_MENU;
105 else if (strcasecmp(cvalue, "dropdown_menu") == 0)
106 current_match->window_type = A__NET_WM_WINDOW_TYPE_DROPDOWN_MENU;
107 else if (strcasecmp(cvalue, "popup_menu") == 0)
108 current_match->window_type = A__NET_WM_WINDOW_TYPE_POPUP_MENU;
109 else if (strcasecmp(cvalue, "tooltip") == 0)
110 current_match->window_type = A__NET_WM_WINDOW_TYPE_TOOLTIP;
112 ELOG("unknown window_type value \"%s\"\n", cvalue);
117 if (strcmp(ctype, "con_mark") == 0) {
118 current_match->mark = regex_new(cvalue);
122 if (strcmp(ctype, "title") == 0) {
123 current_match->title = regex_new(cvalue);
127 if (strcmp(ctype, "urgent") == 0) {
128 if (strcasecmp(cvalue, "latest") == 0 ||
129 strcasecmp(cvalue, "newest") == 0 ||
130 strcasecmp(cvalue, "recent") == 0 ||
131 strcasecmp(cvalue, "last") == 0) {
132 current_match->urgent = U_LATEST;
133 } else if (strcasecmp(cvalue, "oldest") == 0 ||
134 strcasecmp(cvalue, "first") == 0) {
135 current_match->urgent = U_OLDEST;
140 if (strcmp(ctype, "workspace") == 0) {
141 current_match->workspace = regex_new(cvalue);
145 ELOG("Unknown criterion: %s\n", ctype);
148 /* TODO: refactor the above criteria code into a single file (with src/commands.c). */
150 /*******************************************************************************
152 ******************************************************************************/
154 static bool eval_boolstr(const char *str) {
155 return (strcasecmp(str, "1") == 0 ||
156 strcasecmp(str, "yes") == 0 ||
157 strcasecmp(str, "true") == 0 ||
158 strcasecmp(str, "on") == 0 ||
159 strcasecmp(str, "enable") == 0 ||
160 strcasecmp(str, "active") == 0);
164 * A utility function to convert a string of modifiers to the corresponding bit
167 uint32_t modifiers_from_str(const char *str) {
168 /* It might be better to use strtok() here, but the simpler strstr() should
173 if (strstr(str, "Mod1") != NULL)
175 if (strstr(str, "Mod2") != NULL)
177 if (strstr(str, "Mod3") != NULL)
179 if (strstr(str, "Mod4") != NULL)
181 if (strstr(str, "Mod5") != NULL)
183 if (strstr(str, "Control") != NULL ||
184 strstr(str, "Ctrl") != NULL)
185 result |= BIND_CONTROL;
186 if (strstr(str, "Shift") != NULL)
187 result |= BIND_SHIFT;
188 if (strstr(str, "Mode_switch") != NULL)
189 result |= BIND_MODE_SWITCH;
193 static char *font_pattern;
195 CFGFUN(font, const char *font) {
196 config.font = load_font(font, true);
197 set_font(&config.font);
199 /* Save the font pattern for using it as bar font later on */
201 font_pattern = sstrdup(font);
204 CFGFUN(binding, const char *bindtype, const char *modifiers, const char *key, const char *release, const char *border, const char *whole_window, const char *command) {
205 configure_binding(bindtype, modifiers, key, release, border, whole_window, command, DEFAULT_BINDING_MODE);
208 /*******************************************************************************
210 ******************************************************************************/
212 static char *current_mode;
214 CFGFUN(mode_binding, const char *bindtype, const char *modifiers, const char *key, const char *release, const char *border, const char *whole_window, const char *command) {
215 configure_binding(bindtype, modifiers, key, release, border, whole_window, command, current_mode);
218 CFGFUN(enter_mode, const char *modename) {
219 if (strcasecmp(modename, DEFAULT_BINDING_MODE) == 0) {
220 ELOG("You cannot use the name %s for your mode\n", DEFAULT_BINDING_MODE);
223 DLOG("\t now in mode %s\n", modename);
225 current_mode = sstrdup(modename);
228 CFGFUN(exec, const char *exectype, const char *no_startup_id, const char *command) {
229 struct Autostart *new = smalloc(sizeof(struct Autostart));
230 new->command = sstrdup(command);
231 new->no_startup_id = (no_startup_id != NULL);
232 if (strcmp(exectype, "exec") == 0) {
233 TAILQ_INSERT_TAIL(&autostarts, new, autostarts);
235 TAILQ_INSERT_TAIL(&autostarts_always, new, autostarts_always);
239 CFGFUN(for_window, const char *command) {
240 if (match_is_empty(current_match)) {
241 ELOG("Match is empty, ignoring this for_window statement\n");
244 DLOG("\t should execute command %s for the criteria mentioned above\n", command);
245 Assignment *assignment = scalloc(sizeof(Assignment));
246 assignment->type = A_COMMAND;
247 match_copy(&(assignment->match), current_match);
248 assignment->dest.command = sstrdup(command);
249 TAILQ_INSERT_TAIL(&assignments, assignment, assignments);
252 CFGFUN(floating_minimum_size, const long width, const long height) {
253 config.floating_minimum_width = width;
254 config.floating_minimum_height = height;
257 CFGFUN(floating_maximum_size, const long width, const long height) {
258 config.floating_maximum_width = width;
259 config.floating_maximum_height = height;
262 CFGFUN(floating_modifier, const char *modifiers) {
263 config.floating_modifier = modifiers_from_str(modifiers);
266 CFGFUN(default_orientation, const char *orientation) {
267 if (strcmp(orientation, "horizontal") == 0)
268 config.default_orientation = HORIZ;
269 else if (strcmp(orientation, "vertical") == 0)
270 config.default_orientation = VERT;
272 config.default_orientation = NO_ORIENTATION;
275 CFGFUN(workspace_layout, const char *layout) {
276 if (strcmp(layout, "default") == 0)
277 config.default_layout = L_DEFAULT;
278 else if (strcmp(layout, "stacking") == 0 ||
279 strcmp(layout, "stacked") == 0)
280 config.default_layout = L_STACKED;
282 config.default_layout = L_TABBED;
285 CFGFUN(new_window, const char *windowtype, const char *border, const long width) {
289 if (strcmp(border, "1pixel") == 0) {
290 border_style = BS_PIXEL;
292 } else if (strcmp(border, "none") == 0) {
293 border_style = BS_NONE;
295 } else if (strcmp(border, "pixel") == 0) {
296 border_style = BS_PIXEL;
297 border_width = width;
299 border_style = BS_NORMAL;
300 border_width = width;
303 if (strcmp(windowtype, "new_window") == 0) {
304 DLOG("default tiled border style = %d and border width = %d (%d physical px)\n",
305 border_style, border_width, logical_px(border_width));
306 config.default_border = border_style;
307 config.default_border_width = logical_px(border_width);
309 DLOG("default floating border style = %d and border width = %d (%d physical px)\n",
310 border_style, border_width, logical_px(border_width));
311 config.default_floating_border = border_style;
312 config.default_floating_border_width = logical_px(border_width);
316 CFGFUN(hide_edge_borders, const char *borders) {
317 if (strcmp(borders, "vertical") == 0)
318 config.hide_edge_borders = ADJ_LEFT_SCREEN_EDGE | ADJ_RIGHT_SCREEN_EDGE;
319 else if (strcmp(borders, "horizontal") == 0)
320 config.hide_edge_borders = ADJ_UPPER_SCREEN_EDGE | ADJ_LOWER_SCREEN_EDGE;
321 else if (strcmp(borders, "both") == 0)
322 config.hide_edge_borders = ADJ_LEFT_SCREEN_EDGE | ADJ_RIGHT_SCREEN_EDGE | ADJ_UPPER_SCREEN_EDGE | ADJ_LOWER_SCREEN_EDGE;
323 else if (strcmp(borders, "none") == 0)
324 config.hide_edge_borders = ADJ_NONE;
325 else if (eval_boolstr(borders))
326 config.hide_edge_borders = ADJ_LEFT_SCREEN_EDGE | ADJ_RIGHT_SCREEN_EDGE;
328 config.hide_edge_borders = ADJ_NONE;
331 CFGFUN(focus_follows_mouse, const char *value) {
332 config.disable_focus_follows_mouse = !eval_boolstr(value);
335 CFGFUN(mouse_warping, const char *value) {
336 if (strcmp(value, "none") == 0)
337 config.mouse_warping = POINTER_WARPING_NONE;
338 else if (strcmp(value, "output") == 0)
339 config.mouse_warping = POINTER_WARPING_OUTPUT;
342 CFGFUN(force_xinerama, const char *value) {
343 config.force_xinerama = eval_boolstr(value);
346 CFGFUN(force_focus_wrapping, const char *value) {
347 config.force_focus_wrapping = eval_boolstr(value);
350 CFGFUN(workspace_back_and_forth, const char *value) {
351 config.workspace_auto_back_and_forth = eval_boolstr(value);
354 CFGFUN(fake_outputs, const char *outputs) {
355 config.fake_outputs = sstrdup(outputs);
358 CFGFUN(force_display_urgency_hint, const long duration_ms) {
359 config.workspace_urgency_timer = duration_ms / 1000.0;
362 CFGFUN(delay_exit_on_zero_displays, const long duration_ms) {
363 config.zero_disp_exit_timer_ms = duration_ms;
366 CFGFUN(focus_on_window_activation, const char *mode) {
367 if (strcmp(mode, "smart") == 0)
368 config.focus_on_window_activation = FOWA_SMART;
369 else if (strcmp(mode, "urgent") == 0)
370 config.focus_on_window_activation = FOWA_URGENT;
371 else if (strcmp(mode, "focus") == 0)
372 config.focus_on_window_activation = FOWA_FOCUS;
373 else if (strcmp(mode, "none") == 0)
374 config.focus_on_window_activation = FOWA_NONE;
376 ELOG("Unknown focus_on_window_activation mode \"%s\", ignoring it.\n", mode);
380 DLOG("Set new focus_on_window_activation mode = %i.\n", config.focus_on_window_activation);
383 CFGFUN(show_marks, const char *value) {
384 config.show_marks = eval_boolstr(value);
387 CFGFUN(workspace, const char *workspace, const char *output) {
388 DLOG("Assigning workspace \"%s\" to output \"%s\"\n", workspace, output);
389 /* Check for earlier assignments of the same workspace so that we
390 * don’t have assignments of a single workspace to different
392 struct Workspace_Assignment *assignment;
393 bool duplicate = false;
394 TAILQ_FOREACH(assignment, &ws_assignments, ws_assignments) {
395 if (strcasecmp(assignment->name, workspace) == 0) {
396 ELOG("You have a duplicate workspace assignment for workspace \"%s\"\n",
398 assignment->output = sstrdup(output);
403 assignment = scalloc(sizeof(struct Workspace_Assignment));
404 assignment->name = sstrdup(workspace);
405 assignment->output = sstrdup(output);
406 TAILQ_INSERT_TAIL(&ws_assignments, assignment, ws_assignments);
410 CFGFUN(ipc_socket, const char *path) {
411 config.ipc_socket_path = sstrdup(path);
414 CFGFUN(restart_state, const char *path) {
415 config.restart_state_path = sstrdup(path);
418 CFGFUN(popup_during_fullscreen, const char *value) {
419 if (strcmp(value, "ignore") == 0) {
420 config.popup_during_fullscreen = PDF_IGNORE;
421 } else if (strcmp(value, "leave_fullscreen") == 0) {
422 config.popup_during_fullscreen = PDF_LEAVE_FULLSCREEN;
424 config.popup_during_fullscreen = PDF_SMART;
428 CFGFUN(color_single, const char *colorclass, const char *color) {
429 /* used for client.background only currently */
430 config.client.background = get_colorpixel(color);
433 CFGFUN(color, const char *colorclass, const char *border, const char *background, const char *text, const char *indicator) {
434 #define APPLY_COLORS(classname) \
436 if (strcmp(colorclass, "client." #classname) == 0) { \
437 config.client.classname.border = get_colorpixel(border); \
438 config.client.classname.background = get_colorpixel(background); \
439 config.client.classname.text = get_colorpixel(text); \
440 if (indicator != NULL) { \
441 config.client.classname.indicator = get_colorpixel(indicator); \
446 APPLY_COLORS(focused_inactive);
447 APPLY_COLORS(focused);
448 APPLY_COLORS(unfocused);
449 APPLY_COLORS(urgent);
450 APPLY_COLORS(placeholder);
455 CFGFUN(assign, const char *workspace) {
456 if (match_is_empty(current_match)) {
457 ELOG("Match is empty, ignoring this assignment\n");
460 DLOG("New assignment, using above criteria, to workspace \"%s\".\n", workspace);
461 Assignment *assignment = scalloc(sizeof(Assignment));
462 match_copy(&(assignment->match), current_match);
463 assignment->type = A_TO_WORKSPACE;
464 assignment->dest.workspace = sstrdup(workspace);
465 TAILQ_INSERT_TAIL(&assignments, assignment, assignments);
469 if (match_is_empty(current_match)) {
470 ELOG("Match is empty, ignoring this assignment\n");
474 DLOG("New assignment, using above criteria, to ignore focus on manage.\n");
475 Assignment *assignment = scalloc(sizeof(Assignment));
476 match_copy(&(assignment->match), current_match);
477 assignment->type = A_NO_FOCUS;
478 TAILQ_INSERT_TAIL(&assignments, assignment, assignments);
481 /*******************************************************************************
482 * Bar configuration (i3bar)
483 ******************************************************************************/
485 static Barconfig current_bar;
487 CFGFUN(bar_font, const char *font) {
488 FREE(current_bar.font);
489 current_bar.font = sstrdup(font);
492 CFGFUN(bar_separator_symbol, const char *separator) {
493 FREE(current_bar.separator_symbol);
494 current_bar.separator_symbol = sstrdup(separator);
497 CFGFUN(bar_mode, const char *mode) {
498 current_bar.mode = (strcmp(mode, "dock") == 0 ? M_DOCK : (strcmp(mode, "hide") == 0 ? M_HIDE : M_INVISIBLE));
501 CFGFUN(bar_hidden_state, const char *hidden_state) {
502 current_bar.hidden_state = (strcmp(hidden_state, "hide") == 0 ? S_HIDE : S_SHOW);
505 CFGFUN(bar_id, const char *bar_id) {
506 current_bar.id = sstrdup(bar_id);
509 CFGFUN(bar_output, const char *output) {
510 int new_outputs = current_bar.num_outputs + 1;
511 current_bar.outputs = srealloc(current_bar.outputs, sizeof(char *) * new_outputs);
512 current_bar.outputs[current_bar.num_outputs] = sstrdup(output);
513 current_bar.num_outputs = new_outputs;
516 CFGFUN(bar_verbose, const char *verbose) {
517 current_bar.verbose = eval_boolstr(verbose);
520 CFGFUN(bar_modifier, const char *modifier) {
521 if (strcmp(modifier, "Mod1") == 0)
522 current_bar.modifier = M_MOD1;
523 else if (strcmp(modifier, "Mod2") == 0)
524 current_bar.modifier = M_MOD2;
525 else if (strcmp(modifier, "Mod3") == 0)
526 current_bar.modifier = M_MOD3;
527 else if (strcmp(modifier, "Mod4") == 0)
528 current_bar.modifier = M_MOD4;
529 else if (strcmp(modifier, "Mod5") == 0)
530 current_bar.modifier = M_MOD5;
531 else if (strcmp(modifier, "Control") == 0 ||
532 strcmp(modifier, "Ctrl") == 0)
533 current_bar.modifier = M_CONTROL;
534 else if (strcmp(modifier, "Shift") == 0)
535 current_bar.modifier = M_SHIFT;
538 static void bar_configure_binding(const char *button, const char *command) {
539 if (strncasecmp(button, "button", strlen("button")) != 0) {
540 ELOG("Bindings for a bar can only be mouse bindings, not \"%s\", ignoring.\n", button);
544 int input_code = atoi(button + strlen("button"));
545 if (input_code < 1) {
546 ELOG("Button \"%s\" does not seem to be in format 'buttonX'.\n", button);
550 struct Barbinding *current;
551 TAILQ_FOREACH(current, &(current_bar.bar_bindings), bindings) {
552 if (current->input_code == input_code) {
553 ELOG("command for button %s was already specified, ignoring.\n", button);
558 struct Barbinding *new_binding = scalloc(sizeof(struct Barbinding));
559 new_binding->input_code = input_code;
560 new_binding->command = sstrdup(command);
561 TAILQ_INSERT_TAIL(&(current_bar.bar_bindings), new_binding, bindings);
564 CFGFUN(bar_wheel_up_cmd, const char *command) {
565 ELOG("'wheel_up_cmd' is deprecated. Please us 'bindsym button4 %s' instead.\n", command);
566 bar_configure_binding("button4", command);
569 CFGFUN(bar_wheel_down_cmd, const char *command) {
570 ELOG("'wheel_down_cmd' is deprecated. Please us 'bindsym button5 %s' instead.\n", command);
571 bar_configure_binding("button5", command);
574 CFGFUN(bar_bindsym, const char *button, const char *command) {
575 bar_configure_binding(button, command);
578 CFGFUN(bar_position, const char *position) {
579 current_bar.position = (strcmp(position, "top") == 0 ? P_TOP : P_BOTTOM);
582 CFGFUN(bar_i3bar_command, const char *i3bar_command) {
583 FREE(current_bar.i3bar_command);
584 current_bar.i3bar_command = sstrdup(i3bar_command);
587 CFGFUN(bar_color, const char *colorclass, const char *border, const char *background, const char *text) {
588 #define APPLY_COLORS(classname) \
590 if (strcmp(colorclass, #classname) == 0) { \
591 if (text != NULL) { \
592 /* New syntax: border, background, text */ \
593 current_bar.colors.classname##_border = sstrdup(border); \
594 current_bar.colors.classname##_bg = sstrdup(background); \
595 current_bar.colors.classname##_text = sstrdup(text); \
597 /* Old syntax: text, background */ \
598 current_bar.colors.classname##_bg = sstrdup(background); \
599 current_bar.colors.classname##_text = sstrdup(border); \
604 APPLY_COLORS(focused_workspace);
605 APPLY_COLORS(active_workspace);
606 APPLY_COLORS(inactive_workspace);
607 APPLY_COLORS(urgent_workspace);
608 APPLY_COLORS(binding_mode);
613 CFGFUN(bar_socket_path, const char *socket_path) {
614 FREE(current_bar.socket_path);
615 current_bar.socket_path = sstrdup(socket_path);
618 CFGFUN(bar_tray_output, const char *output) {
619 FREE(current_bar.tray_output);
620 current_bar.tray_output = sstrdup(output);
623 CFGFUN(bar_tray_padding, const long padding_px) {
624 current_bar.tray_padding = padding_px;
627 CFGFUN(bar_color_single, const char *colorclass, const char *color) {
628 if (strcmp(colorclass, "background") == 0)
629 current_bar.colors.background = sstrdup(color);
630 else if (strcmp(colorclass, "separator") == 0)
631 current_bar.colors.separator = sstrdup(color);
633 current_bar.colors.statusline = sstrdup(color);
636 CFGFUN(bar_status_command, const char *command) {
637 FREE(current_bar.status_command);
638 current_bar.status_command = sstrdup(command);
641 CFGFUN(bar_binding_mode_indicator, const char *value) {
642 current_bar.hide_binding_mode_indicator = !eval_boolstr(value);
645 CFGFUN(bar_workspace_buttons, const char *value) {
646 current_bar.hide_workspace_buttons = !eval_boolstr(value);
649 CFGFUN(bar_strip_workspace_numbers, const char *value) {
650 current_bar.strip_workspace_numbers = eval_boolstr(value);
654 TAILQ_INIT(&(current_bar.bar_bindings));
655 current_bar.tray_padding = 2;
659 DLOG("\t new bar configuration finished, saving.\n");
660 /* Generate a unique ID for this bar if not already configured */
662 sasprintf(¤t_bar.id, "bar-%d", config.number_barconfigs);
664 config.number_barconfigs++;
666 /* If no font was explicitly set, we use the i3 font as default */
667 if (!current_bar.font && font_pattern)
668 current_bar.font = sstrdup(font_pattern);
670 /* Copy the current (static) structure into a dynamically allocated
671 * one, then cleanup our static one. */
672 Barconfig *bar_config = scalloc(sizeof(Barconfig));
673 memcpy(bar_config, ¤t_bar, sizeof(Barconfig));
674 TAILQ_INSERT_TAIL(&barconfigs, bar_config, configs);
676 memset(¤t_bar, '\0', sizeof(Barconfig));