2 * vim:ts=4:sw=4:expandtab
4 * i3 - an improved dynamic tiling window manager
5 * © 2009 Michael Stapelberg and contributors (see also: LICENSE)
7 * config_directives.c: all config storing functions (see config_parser.c)
15 /*******************************************************************************
17 ******************************************************************************/
19 static int criteria_next_state;
22 * Initializes the specified 'Match' data structure and the initial state of
23 * commands.c for matching target windows of a command.
26 CFGFUN(criteria_init, int _state) {
27 criteria_next_state = _state;
29 DLOG("Initializing criteria, current_match = %p, state = %d\n", current_match, _state);
30 match_free(current_match);
31 match_init(current_match);
34 CFGFUN(criteria_pop_state) {
35 result->next_state = criteria_next_state;
39 * Interprets a ctype=cvalue pair and adds it to the current match
43 CFGFUN(criteria_add, const char *ctype, const char *cvalue) {
44 match_parse_property(current_match, ctype, cvalue);
47 /*******************************************************************************
49 ******************************************************************************/
51 static bool eval_boolstr(const char *str) {
52 return (strcasecmp(str, "1") == 0 ||
53 strcasecmp(str, "yes") == 0 ||
54 strcasecmp(str, "true") == 0 ||
55 strcasecmp(str, "on") == 0 ||
56 strcasecmp(str, "enable") == 0 ||
57 strcasecmp(str, "active") == 0);
61 * A utility function to convert a string containing the group and modifiers to
62 * the corresponding bit mask.
64 i3_event_state_mask_t event_state_from_str(const char *str) {
65 /* It might be better to use strtok() here, but the simpler strstr() should
67 i3_event_state_mask_t result = 0;
70 if (strstr(str, "Mod1") != NULL)
71 result |= XCB_KEY_BUT_MASK_MOD_1;
72 if (strstr(str, "Mod2") != NULL)
73 result |= XCB_KEY_BUT_MASK_MOD_2;
74 if (strstr(str, "Mod3") != NULL)
75 result |= XCB_KEY_BUT_MASK_MOD_3;
76 if (strstr(str, "Mod4") != NULL)
77 result |= XCB_KEY_BUT_MASK_MOD_4;
78 if (strstr(str, "Mod5") != NULL)
79 result |= XCB_KEY_BUT_MASK_MOD_5;
80 if (strstr(str, "Control") != NULL ||
81 strstr(str, "Ctrl") != NULL)
82 result |= XCB_KEY_BUT_MASK_CONTROL;
83 if (strstr(str, "Shift") != NULL)
84 result |= XCB_KEY_BUT_MASK_SHIFT;
86 if (strstr(str, "Group1") != NULL)
87 result |= (I3_XKB_GROUP_MASK_1 << 16);
88 if (strstr(str, "Group2") != NULL ||
89 strstr(str, "Mode_switch") != NULL)
90 result |= (I3_XKB_GROUP_MASK_2 << 16);
91 if (strstr(str, "Group3") != NULL)
92 result |= (I3_XKB_GROUP_MASK_3 << 16);
93 if (strstr(str, "Group4") != NULL)
94 result |= (I3_XKB_GROUP_MASK_4 << 16);
98 static char *font_pattern;
100 CFGFUN(font, const char *font) {
101 config.font = load_font(font, true);
102 set_font(&config.font);
104 /* Save the font pattern for using it as bar font later on */
106 font_pattern = sstrdup(font);
109 CFGFUN(binding, const char *bindtype, const char *modifiers, const char *key, const char *release, const char *border, const char *whole_window, const char *exclude_titlebar, const char *command) {
110 configure_binding(bindtype, modifiers, key, release, border, whole_window, exclude_titlebar, command, DEFAULT_BINDING_MODE, false);
113 /*******************************************************************************
115 ******************************************************************************/
117 static char *current_mode;
118 static bool current_mode_pango_markup;
120 CFGFUN(mode_binding, const char *bindtype, const char *modifiers, const char *key, const char *release, const char *border, const char *whole_window, const char *exclude_titlebar, const char *command) {
121 configure_binding(bindtype, modifiers, key, release, border, whole_window, exclude_titlebar, command, current_mode, current_mode_pango_markup);
124 CFGFUN(enter_mode, const char *pango_markup, const char *modename) {
125 if (strcasecmp(modename, DEFAULT_BINDING_MODE) == 0) {
126 ELOG("You cannot use the name %s for your mode\n", DEFAULT_BINDING_MODE);
131 SLIST_FOREACH(mode, &modes, modes) {
132 if (strcmp(mode->name, modename) == 0) {
133 ELOG("The binding mode with name \"%s\" is defined at least twice.\n", modename);
137 DLOG("\t now in mode %s\n", modename);
139 current_mode = sstrdup(modename);
140 current_mode_pango_markup = (pango_markup != NULL);
143 CFGFUN(exec, const char *exectype, const char *no_startup_id, const char *command) {
144 struct Autostart *new = smalloc(sizeof(struct Autostart));
145 new->command = sstrdup(command);
146 new->no_startup_id = (no_startup_id != NULL);
147 if (strcmp(exectype, "exec") == 0) {
148 TAILQ_INSERT_TAIL(&autostarts, new, autostarts);
150 TAILQ_INSERT_TAIL(&autostarts_always, new, autostarts_always);
154 CFGFUN(for_window, const char *command) {
155 if (match_is_empty(current_match)) {
156 ELOG("Match is empty, ignoring this for_window statement\n");
159 DLOG("\t should execute command %s for the criteria mentioned above\n", command);
160 Assignment *assignment = scalloc(1, sizeof(Assignment));
161 assignment->type = A_COMMAND;
162 match_copy(&(assignment->match), current_match);
163 assignment->dest.command = sstrdup(command);
164 TAILQ_INSERT_TAIL(&assignments, assignment, assignments);
167 CFGFUN(floating_minimum_size, const long width, const long height) {
168 config.floating_minimum_width = width;
169 config.floating_minimum_height = height;
172 CFGFUN(floating_maximum_size, const long width, const long height) {
173 config.floating_maximum_width = width;
174 config.floating_maximum_height = height;
177 CFGFUN(floating_modifier, const char *modifiers) {
178 config.floating_modifier = event_state_from_str(modifiers);
181 CFGFUN(default_orientation, const char *orientation) {
182 if (strcmp(orientation, "horizontal") == 0)
183 config.default_orientation = HORIZ;
184 else if (strcmp(orientation, "vertical") == 0)
185 config.default_orientation = VERT;
187 config.default_orientation = NO_ORIENTATION;
190 CFGFUN(workspace_layout, const char *layout) {
191 if (strcmp(layout, "default") == 0)
192 config.default_layout = L_DEFAULT;
193 else if (strcmp(layout, "stacking") == 0 ||
194 strcmp(layout, "stacked") == 0)
195 config.default_layout = L_STACKED;
197 config.default_layout = L_TABBED;
200 CFGFUN(new_window, const char *windowtype, const char *border, const long width) {
204 if (strcmp(border, "1pixel") == 0) {
205 border_style = BS_PIXEL;
207 } else if (strcmp(border, "none") == 0) {
208 border_style = BS_NONE;
210 } else if (strcmp(border, "pixel") == 0) {
211 border_style = BS_PIXEL;
212 border_width = width;
214 border_style = BS_NORMAL;
215 border_width = width;
218 if (strcmp(windowtype, "new_window") == 0) {
219 DLOG("default tiled border style = %d and border width = %d (%d physical px)\n",
220 border_style, border_width, logical_px(border_width));
221 config.default_border = border_style;
222 config.default_border_width = logical_px(border_width);
224 DLOG("default floating border style = %d and border width = %d (%d physical px)\n",
225 border_style, border_width, logical_px(border_width));
226 config.default_floating_border = border_style;
227 config.default_floating_border_width = logical_px(border_width);
231 CFGFUN(hide_edge_borders, const char *borders) {
232 if (strcmp(borders, "smart") == 0)
233 config.hide_edge_borders = HEBM_SMART;
234 else if (strcmp(borders, "vertical") == 0)
235 config.hide_edge_borders = HEBM_VERTICAL;
236 else if (strcmp(borders, "horizontal") == 0)
237 config.hide_edge_borders = HEBM_HORIZONTAL;
238 else if (strcmp(borders, "both") == 0)
239 config.hide_edge_borders = HEBM_BOTH;
240 else if (strcmp(borders, "none") == 0)
241 config.hide_edge_borders = HEBM_NONE;
242 else if (eval_boolstr(borders))
243 config.hide_edge_borders = HEBM_VERTICAL;
245 config.hide_edge_borders = HEBM_NONE;
248 CFGFUN(focus_follows_mouse, const char *value) {
249 config.disable_focus_follows_mouse = !eval_boolstr(value);
252 CFGFUN(mouse_warping, const char *value) {
253 if (strcmp(value, "none") == 0)
254 config.mouse_warping = POINTER_WARPING_NONE;
255 else if (strcmp(value, "output") == 0)
256 config.mouse_warping = POINTER_WARPING_OUTPUT;
259 CFGFUN(force_xinerama, const char *value) {
260 config.force_xinerama = eval_boolstr(value);
263 CFGFUN(disable_randr15, const char *value) {
264 config.disable_randr15 = eval_boolstr(value);
267 CFGFUN(focus_wrapping, const char *value) {
268 if (strcmp(value, "force") == 0) {
269 config.focus_wrapping = FOCUS_WRAPPING_FORCE;
270 } else if (eval_boolstr(value)) {
271 config.focus_wrapping = FOCUS_WRAPPING_ON;
273 config.focus_wrapping = FOCUS_WRAPPING_OFF;
277 CFGFUN(force_focus_wrapping, const char *value) {
279 if (eval_boolstr(value)) {
280 config.focus_wrapping = FOCUS_WRAPPING_FORCE;
282 /* For "force_focus_wrapping off", don't enable or disable
283 * focus wrapping, just ensure it's not forced. */
284 if (config.focus_wrapping == FOCUS_WRAPPING_FORCE) {
285 config.focus_wrapping = FOCUS_WRAPPING_ON;
290 CFGFUN(workspace_back_and_forth, const char *value) {
291 config.workspace_auto_back_and_forth = eval_boolstr(value);
294 CFGFUN(fake_outputs, const char *outputs) {
295 free(config.fake_outputs);
296 config.fake_outputs = sstrdup(outputs);
299 CFGFUN(force_display_urgency_hint, const long duration_ms) {
300 config.workspace_urgency_timer = duration_ms / 1000.0;
303 CFGFUN(focus_on_window_activation, const char *mode) {
304 if (strcmp(mode, "smart") == 0)
305 config.focus_on_window_activation = FOWA_SMART;
306 else if (strcmp(mode, "urgent") == 0)
307 config.focus_on_window_activation = FOWA_URGENT;
308 else if (strcmp(mode, "focus") == 0)
309 config.focus_on_window_activation = FOWA_FOCUS;
310 else if (strcmp(mode, "none") == 0)
311 config.focus_on_window_activation = FOWA_NONE;
313 ELOG("Unknown focus_on_window_activation mode \"%s\", ignoring it.\n", mode);
317 DLOG("Set new focus_on_window_activation mode = %i.\n", config.focus_on_window_activation);
320 CFGFUN(show_marks, const char *value) {
321 config.show_marks = eval_boolstr(value);
324 CFGFUN(workspace, const char *workspace, const char *output) {
325 DLOG("Assigning workspace \"%s\" to output \"%s\"\n", workspace, output);
326 /* Check for earlier assignments of the same workspace so that we
327 * don’t have assignments of a single workspace to different
329 struct Workspace_Assignment *assignment;
330 bool duplicate = false;
331 TAILQ_FOREACH(assignment, &ws_assignments, ws_assignments) {
332 if (strcasecmp(assignment->name, workspace) == 0) {
333 ELOG("You have a duplicate workspace assignment for workspace \"%s\"\n",
335 assignment->output = sstrdup(output);
340 assignment = scalloc(1, sizeof(struct Workspace_Assignment));
341 assignment->name = sstrdup(workspace);
342 assignment->output = sstrdup(output);
343 TAILQ_INSERT_TAIL(&ws_assignments, assignment, ws_assignments);
347 CFGFUN(ipc_socket, const char *path) {
348 free(config.ipc_socket_path);
349 config.ipc_socket_path = sstrdup(path);
352 CFGFUN(restart_state, const char *path) {
353 free(config.restart_state_path);
354 config.restart_state_path = sstrdup(path);
357 CFGFUN(popup_during_fullscreen, const char *value) {
358 if (strcmp(value, "ignore") == 0) {
359 config.popup_during_fullscreen = PDF_IGNORE;
360 } else if (strcmp(value, "leave_fullscreen") == 0) {
361 config.popup_during_fullscreen = PDF_LEAVE_FULLSCREEN;
363 config.popup_during_fullscreen = PDF_SMART;
367 CFGFUN(color_single, const char *colorclass, const char *color) {
368 /* used for client.background only currently */
369 config.client.background = draw_util_hex_to_color(color);
372 CFGFUN(color, const char *colorclass, const char *border, const char *background, const char *text, const char *indicator, const char *child_border) {
373 #define APPLY_COLORS(classname) \
375 if (strcmp(colorclass, "client." #classname) == 0) { \
376 config.client.classname.border = draw_util_hex_to_color(border); \
377 config.client.classname.background = draw_util_hex_to_color(background); \
378 config.client.classname.text = draw_util_hex_to_color(text); \
379 if (indicator != NULL) { \
380 config.client.classname.indicator = draw_util_hex_to_color(indicator); \
382 if (child_border != NULL) { \
383 config.client.classname.child_border = draw_util_hex_to_color(child_border); \
385 config.client.classname.child_border = config.client.classname.background; \
390 APPLY_COLORS(focused_inactive);
391 APPLY_COLORS(focused);
392 APPLY_COLORS(unfocused);
393 APPLY_COLORS(urgent);
394 APPLY_COLORS(placeholder);
399 CFGFUN(assign, const char *workspace, bool is_number) {
400 if (match_is_empty(current_match)) {
401 ELOG("Match is empty, ignoring this assignment\n");
405 if (is_number && ws_name_to_number(workspace) == -1) {
406 ELOG("Could not parse initial part of \"%s\" as a number.\n", workspace);
410 DLOG("New assignment, using above criteria, to workspace \"%s\".\n", workspace);
411 Assignment *assignment = scalloc(1, sizeof(Assignment));
412 match_copy(&(assignment->match), current_match);
413 assignment->type = is_number ? A_TO_WORKSPACE_NUMBER : A_TO_WORKSPACE;
414 assignment->dest.workspace = sstrdup(workspace);
415 TAILQ_INSERT_TAIL(&assignments, assignment, assignments);
419 if (match_is_empty(current_match)) {
420 ELOG("Match is empty, ignoring this assignment\n");
424 DLOG("New assignment, using above criteria, to ignore focus on manage.\n");
425 Assignment *assignment = scalloc(1, sizeof(Assignment));
426 match_copy(&(assignment->match), current_match);
427 assignment->type = A_NO_FOCUS;
428 TAILQ_INSERT_TAIL(&assignments, assignment, assignments);
431 /*******************************************************************************
432 * Bar configuration (i3bar)
433 ******************************************************************************/
435 static Barconfig *current_bar;
437 CFGFUN(bar_font, const char *font) {
438 FREE(current_bar->font);
439 current_bar->font = sstrdup(font);
442 CFGFUN(bar_separator_symbol, const char *separator) {
443 FREE(current_bar->separator_symbol);
444 current_bar->separator_symbol = sstrdup(separator);
447 CFGFUN(bar_mode, const char *mode) {
448 current_bar->mode = (strcmp(mode, "dock") == 0 ? M_DOCK : (strcmp(mode, "hide") == 0 ? M_HIDE : M_INVISIBLE));
451 CFGFUN(bar_hidden_state, const char *hidden_state) {
452 current_bar->hidden_state = (strcmp(hidden_state, "hide") == 0 ? S_HIDE : S_SHOW);
455 CFGFUN(bar_id, const char *bar_id) {
456 current_bar->id = sstrdup(bar_id);
459 CFGFUN(bar_output, const char *output) {
460 int new_outputs = current_bar->num_outputs + 1;
461 current_bar->outputs = srealloc(current_bar->outputs, sizeof(char *) * new_outputs);
462 current_bar->outputs[current_bar->num_outputs] = sstrdup(output);
463 current_bar->num_outputs = new_outputs;
466 CFGFUN(bar_verbose, const char *verbose) {
467 current_bar->verbose = eval_boolstr(verbose);
470 CFGFUN(bar_modifier, const char *modifier) {
471 if (strcmp(modifier, "Mod1") == 0)
472 current_bar->modifier = M_MOD1;
473 else if (strcmp(modifier, "Mod2") == 0)
474 current_bar->modifier = M_MOD2;
475 else if (strcmp(modifier, "Mod3") == 0)
476 current_bar->modifier = M_MOD3;
477 else if (strcmp(modifier, "Mod4") == 0)
478 current_bar->modifier = M_MOD4;
479 else if (strcmp(modifier, "Mod5") == 0)
480 current_bar->modifier = M_MOD5;
481 else if (strcmp(modifier, "Control") == 0 ||
482 strcmp(modifier, "Ctrl") == 0)
483 current_bar->modifier = M_CONTROL;
484 else if (strcmp(modifier, "Shift") == 0)
485 current_bar->modifier = M_SHIFT;
486 else if (strcmp(modifier, "none") == 0 ||
487 strcmp(modifier, "off") == 0)
488 current_bar->modifier = M_NONE;
491 static void bar_configure_binding(const char *button, const char *command) {
492 if (strncasecmp(button, "button", strlen("button")) != 0) {
493 ELOG("Bindings for a bar can only be mouse bindings, not \"%s\", ignoring.\n", button);
497 int input_code = atoi(button + strlen("button"));
498 if (input_code < 1) {
499 ELOG("Button \"%s\" does not seem to be in format 'buttonX'.\n", button);
503 struct Barbinding *current;
504 TAILQ_FOREACH(current, &(current_bar->bar_bindings), bindings) {
505 if (current->input_code == input_code) {
506 ELOG("command for button %s was already specified, ignoring.\n", button);
511 struct Barbinding *new_binding = scalloc(1, sizeof(struct Barbinding));
512 new_binding->input_code = input_code;
513 new_binding->command = sstrdup(command);
514 TAILQ_INSERT_TAIL(&(current_bar->bar_bindings), new_binding, bindings);
517 CFGFUN(bar_wheel_up_cmd, const char *command) {
518 ELOG("'wheel_up_cmd' is deprecated. Please us 'bindsym button4 %s' instead.\n", command);
519 bar_configure_binding("button4", command);
522 CFGFUN(bar_wheel_down_cmd, const char *command) {
523 ELOG("'wheel_down_cmd' is deprecated. Please us 'bindsym button5 %s' instead.\n", command);
524 bar_configure_binding("button5", command);
527 CFGFUN(bar_bindsym, const char *button, const char *command) {
528 bar_configure_binding(button, command);
531 CFGFUN(bar_position, const char *position) {
532 current_bar->position = (strcmp(position, "top") == 0 ? P_TOP : P_BOTTOM);
535 CFGFUN(bar_i3bar_command, const char *i3bar_command) {
536 FREE(current_bar->i3bar_command);
537 current_bar->i3bar_command = sstrdup(i3bar_command);
540 CFGFUN(bar_color, const char *colorclass, const char *border, const char *background, const char *text) {
541 #define APPLY_COLORS(classname) \
543 if (strcmp(colorclass, #classname) == 0) { \
544 if (text != NULL) { \
545 /* New syntax: border, background, text */ \
546 current_bar->colors.classname##_border = sstrdup(border); \
547 current_bar->colors.classname##_bg = sstrdup(background); \
548 current_bar->colors.classname##_text = sstrdup(text); \
550 /* Old syntax: text, background */ \
551 current_bar->colors.classname##_bg = sstrdup(background); \
552 current_bar->colors.classname##_text = sstrdup(border); \
557 APPLY_COLORS(focused_workspace);
558 APPLY_COLORS(active_workspace);
559 APPLY_COLORS(inactive_workspace);
560 APPLY_COLORS(urgent_workspace);
561 APPLY_COLORS(binding_mode);
566 CFGFUN(bar_socket_path, const char *socket_path) {
567 FREE(current_bar->socket_path);
568 current_bar->socket_path = sstrdup(socket_path);
571 CFGFUN(bar_tray_output, const char *output) {
572 struct tray_output_t *tray_output = scalloc(1, sizeof(struct tray_output_t));
573 tray_output->output = sstrdup(output);
574 TAILQ_INSERT_TAIL(&(current_bar->tray_outputs), tray_output, tray_outputs);
577 CFGFUN(bar_tray_padding, const long padding_px) {
578 current_bar->tray_padding = padding_px;
581 CFGFUN(bar_color_single, const char *colorclass, const char *color) {
582 if (strcmp(colorclass, "background") == 0)
583 current_bar->colors.background = sstrdup(color);
584 else if (strcmp(colorclass, "separator") == 0)
585 current_bar->colors.separator = sstrdup(color);
586 else if (strcmp(colorclass, "statusline") == 0)
587 current_bar->colors.statusline = sstrdup(color);
588 else if (strcmp(colorclass, "focused_background") == 0)
589 current_bar->colors.focused_background = sstrdup(color);
590 else if (strcmp(colorclass, "focused_separator") == 0)
591 current_bar->colors.focused_separator = sstrdup(color);
593 current_bar->colors.focused_statusline = sstrdup(color);
596 CFGFUN(bar_status_command, const char *command) {
597 FREE(current_bar->status_command);
598 current_bar->status_command = sstrdup(command);
601 CFGFUN(bar_binding_mode_indicator, const char *value) {
602 current_bar->hide_binding_mode_indicator = !eval_boolstr(value);
605 CFGFUN(bar_workspace_buttons, const char *value) {
606 current_bar->hide_workspace_buttons = !eval_boolstr(value);
609 CFGFUN(bar_strip_workspace_numbers, const char *value) {
610 current_bar->strip_workspace_numbers = eval_boolstr(value);
614 current_bar = scalloc(1, sizeof(struct Barconfig));
615 TAILQ_INIT(&(current_bar->bar_bindings));
616 TAILQ_INIT(&(current_bar->tray_outputs));
617 current_bar->tray_padding = 2;
618 current_bar->modifier = M_MOD4;
622 DLOG("\t new bar configuration finished, saving.\n");
623 /* Generate a unique ID for this bar if not already configured */
624 if (current_bar->id == NULL)
625 sasprintf(¤t_bar->id, "bar-%d", config.number_barconfigs);
627 config.number_barconfigs++;
629 /* If no font was explicitly set, we use the i3 font as default */
630 if (current_bar->font == NULL && font_pattern != NULL)
631 current_bar->font = sstrdup(font_pattern);
633 TAILQ_INSERT_TAIL(&barconfigs, current_bar, configs);
634 /* Simply reset the pointer, but don't free the resources. */