]> git.sur5r.net Git - i3/i3/blob - src/config_directives.c
Merge pull request #2190 from jolange/userguide
[i3/i3] / src / config_directives.c
1 #undef I3__FILE__
2 #define I3__FILE__ "config_directives.c"
3 /*
4  * vim:ts=4:sw=4:expandtab
5  *
6  * i3 - an improved dynamic tiling window manager
7  * © 2009 Michael Stapelberg and contributors (see also: LICENSE)
8  *
9  * config_directives.c: all config storing functions (see config_parser.c)
10  *
11  */
12 #include <float.h>
13 #include <stdarg.h>
14
15 #include "all.h"
16
17 /*******************************************************************************
18  * Criteria functions.
19  ******************************************************************************/
20
21 static int criteria_next_state;
22
23 /*
24  * Initializes the specified 'Match' data structure and the initial state of
25  * commands.c for matching target windows of a command.
26  *
27  */
28 CFGFUN(criteria_init, int _state) {
29     criteria_next_state = _state;
30
31     DLOG("Initializing criteria, current_match = %p, state = %d\n", current_match, _state);
32     match_free(current_match);
33     match_init(current_match);
34 }
35
36 CFGFUN(criteria_pop_state) {
37     result->next_state = criteria_next_state;
38 }
39
40 /*
41  * Interprets a ctype=cvalue pair and adds it to the current match
42  * specification.
43  *
44  */
45 CFGFUN(criteria_add, const char *ctype, const char *cvalue) {
46     match_parse_property(current_match, ctype, cvalue);
47 }
48
49 /*******************************************************************************
50  * Utility functions
51  ******************************************************************************/
52
53 static bool eval_boolstr(const char *str) {
54     return (strcasecmp(str, "1") == 0 ||
55             strcasecmp(str, "yes") == 0 ||
56             strcasecmp(str, "true") == 0 ||
57             strcasecmp(str, "on") == 0 ||
58             strcasecmp(str, "enable") == 0 ||
59             strcasecmp(str, "active") == 0);
60 }
61
62 /*
63  * A utility function to convert a string containing the group and modifiers to
64  * the corresponding bit mask.
65  */
66 i3_event_state_mask_t event_state_from_str(const char *str) {
67     /* It might be better to use strtok() here, but the simpler strstr() should
68      * do for now. */
69     i3_event_state_mask_t result = 0;
70     if (str == NULL)
71         return result;
72     if (strstr(str, "Mod1") != NULL)
73         result |= XCB_KEY_BUT_MASK_MOD_1;
74     if (strstr(str, "Mod2") != NULL)
75         result |= XCB_KEY_BUT_MASK_MOD_2;
76     if (strstr(str, "Mod3") != NULL)
77         result |= XCB_KEY_BUT_MASK_MOD_3;
78     if (strstr(str, "Mod4") != NULL)
79         result |= XCB_KEY_BUT_MASK_MOD_4;
80     if (strstr(str, "Mod5") != NULL)
81         result |= XCB_KEY_BUT_MASK_MOD_5;
82     if (strstr(str, "Control") != NULL ||
83         strstr(str, "Ctrl") != NULL)
84         result |= XCB_KEY_BUT_MASK_CONTROL;
85     if (strstr(str, "Shift") != NULL)
86         result |= XCB_KEY_BUT_MASK_SHIFT;
87
88     if (strstr(str, "Group1") != NULL)
89         result |= (I3_XKB_GROUP_MASK_1 << 16);
90     if (strstr(str, "Group2") != NULL ||
91         strstr(str, "Mode_switch") != NULL)
92         result |= (I3_XKB_GROUP_MASK_2 << 16);
93     if (strstr(str, "Group3") != NULL)
94         result |= (I3_XKB_GROUP_MASK_3 << 16);
95     if (strstr(str, "Group4") != NULL)
96         result |= (I3_XKB_GROUP_MASK_4 << 16);
97     return result;
98 }
99
100 static char *font_pattern;
101
102 CFGFUN(font, const char *font) {
103     config.font = load_font(font, true);
104     set_font(&config.font);
105
106     /* Save the font pattern for using it as bar font later on */
107     FREE(font_pattern);
108     font_pattern = sstrdup(font);
109 }
110
111 CFGFUN(binding, const char *bindtype, const char *modifiers, const char *key, const char *release, const char *border, const char *whole_window, const char *command) {
112     configure_binding(bindtype, modifiers, key, release, border, whole_window, command, DEFAULT_BINDING_MODE, false);
113 }
114
115 /*******************************************************************************
116  * Mode handling
117  ******************************************************************************/
118
119 static char *current_mode;
120 static bool current_mode_pango_markup;
121
122 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) {
123     configure_binding(bindtype, modifiers, key, release, border, whole_window, command, current_mode, current_mode_pango_markup);
124 }
125
126 CFGFUN(enter_mode, const char *pango_markup, const char *modename) {
127     if (strcasecmp(modename, DEFAULT_BINDING_MODE) == 0) {
128         ELOG("You cannot use the name %s for your mode\n", DEFAULT_BINDING_MODE);
129         exit(1);
130     }
131     DLOG("\t now in mode %s\n", modename);
132     FREE(current_mode);
133     current_mode = sstrdup(modename);
134     current_mode_pango_markup = (pango_markup != NULL);
135 }
136
137 CFGFUN(exec, const char *exectype, const char *no_startup_id, const char *command) {
138     struct Autostart *new = smalloc(sizeof(struct Autostart));
139     new->command = sstrdup(command);
140     new->no_startup_id = (no_startup_id != NULL);
141     if (strcmp(exectype, "exec") == 0) {
142         TAILQ_INSERT_TAIL(&autostarts, new, autostarts);
143     } else {
144         TAILQ_INSERT_TAIL(&autostarts_always, new, autostarts_always);
145     }
146 }
147
148 CFGFUN(for_window, const char *command) {
149     if (match_is_empty(current_match)) {
150         ELOG("Match is empty, ignoring this for_window statement\n");
151         return;
152     }
153     DLOG("\t should execute command %s for the criteria mentioned above\n", command);
154     Assignment *assignment = scalloc(1, sizeof(Assignment));
155     assignment->type = A_COMMAND;
156     match_copy(&(assignment->match), current_match);
157     assignment->dest.command = sstrdup(command);
158     TAILQ_INSERT_TAIL(&assignments, assignment, assignments);
159 }
160
161 CFGFUN(floating_minimum_size, const long width, const long height) {
162     config.floating_minimum_width = width;
163     config.floating_minimum_height = height;
164 }
165
166 CFGFUN(floating_maximum_size, const long width, const long height) {
167     config.floating_maximum_width = width;
168     config.floating_maximum_height = height;
169 }
170
171 CFGFUN(floating_modifier, const char *modifiers) {
172     config.floating_modifier = event_state_from_str(modifiers);
173 }
174
175 CFGFUN(default_orientation, const char *orientation) {
176     if (strcmp(orientation, "horizontal") == 0)
177         config.default_orientation = HORIZ;
178     else if (strcmp(orientation, "vertical") == 0)
179         config.default_orientation = VERT;
180     else
181         config.default_orientation = NO_ORIENTATION;
182 }
183
184 CFGFUN(workspace_layout, const char *layout) {
185     if (strcmp(layout, "default") == 0)
186         config.default_layout = L_DEFAULT;
187     else if (strcmp(layout, "stacking") == 0 ||
188              strcmp(layout, "stacked") == 0)
189         config.default_layout = L_STACKED;
190     else
191         config.default_layout = L_TABBED;
192 }
193
194 CFGFUN(new_window, const char *windowtype, const char *border, const long width) {
195     int border_style;
196     int border_width;
197
198     if (strcmp(border, "1pixel") == 0) {
199         border_style = BS_PIXEL;
200         border_width = 1;
201     } else if (strcmp(border, "none") == 0) {
202         border_style = BS_NONE;
203         border_width = 0;
204     } else if (strcmp(border, "pixel") == 0) {
205         border_style = BS_PIXEL;
206         border_width = width;
207     } else {
208         border_style = BS_NORMAL;
209         border_width = width;
210     }
211
212     if (strcmp(windowtype, "new_window") == 0) {
213         DLOG("default tiled border style = %d and border width = %d (%d physical px)\n",
214              border_style, border_width, logical_px(border_width));
215         config.default_border = border_style;
216         config.default_border_width = logical_px(border_width);
217     } else {
218         DLOG("default floating border style = %d and border width = %d (%d physical px)\n",
219              border_style, border_width, logical_px(border_width));
220         config.default_floating_border = border_style;
221         config.default_floating_border_width = logical_px(border_width);
222     }
223 }
224
225 CFGFUN(hide_edge_borders, const char *borders) {
226     if (strcmp(borders, "vertical") == 0)
227         config.hide_edge_borders = ADJ_LEFT_SCREEN_EDGE | ADJ_RIGHT_SCREEN_EDGE;
228     else if (strcmp(borders, "horizontal") == 0)
229         config.hide_edge_borders = ADJ_UPPER_SCREEN_EDGE | ADJ_LOWER_SCREEN_EDGE;
230     else if (strcmp(borders, "both") == 0)
231         config.hide_edge_borders = ADJ_LEFT_SCREEN_EDGE | ADJ_RIGHT_SCREEN_EDGE | ADJ_UPPER_SCREEN_EDGE | ADJ_LOWER_SCREEN_EDGE;
232     else if (strcmp(borders, "none") == 0)
233         config.hide_edge_borders = ADJ_NONE;
234     else if (eval_boolstr(borders))
235         config.hide_edge_borders = ADJ_LEFT_SCREEN_EDGE | ADJ_RIGHT_SCREEN_EDGE;
236     else
237         config.hide_edge_borders = ADJ_NONE;
238 }
239
240 CFGFUN(focus_follows_mouse, const char *value) {
241     config.disable_focus_follows_mouse = !eval_boolstr(value);
242 }
243
244 CFGFUN(mouse_warping, const char *value) {
245     if (strcmp(value, "none") == 0)
246         config.mouse_warping = POINTER_WARPING_NONE;
247     else if (strcmp(value, "output") == 0)
248         config.mouse_warping = POINTER_WARPING_OUTPUT;
249 }
250
251 CFGFUN(force_xinerama, const char *value) {
252     config.force_xinerama = eval_boolstr(value);
253 }
254
255 CFGFUN(force_focus_wrapping, const char *value) {
256     config.force_focus_wrapping = eval_boolstr(value);
257 }
258
259 CFGFUN(workspace_back_and_forth, const char *value) {
260     config.workspace_auto_back_and_forth = eval_boolstr(value);
261 }
262
263 CFGFUN(fake_outputs, const char *outputs) {
264     free(config.fake_outputs);
265     config.fake_outputs = sstrdup(outputs);
266 }
267
268 CFGFUN(force_display_urgency_hint, const long duration_ms) {
269     config.workspace_urgency_timer = duration_ms / 1000.0;
270 }
271
272 CFGFUN(focus_on_window_activation, const char *mode) {
273     if (strcmp(mode, "smart") == 0)
274         config.focus_on_window_activation = FOWA_SMART;
275     else if (strcmp(mode, "urgent") == 0)
276         config.focus_on_window_activation = FOWA_URGENT;
277     else if (strcmp(mode, "focus") == 0)
278         config.focus_on_window_activation = FOWA_FOCUS;
279     else if (strcmp(mode, "none") == 0)
280         config.focus_on_window_activation = FOWA_NONE;
281     else {
282         ELOG("Unknown focus_on_window_activation mode \"%s\", ignoring it.\n", mode);
283         return;
284     }
285
286     DLOG("Set new focus_on_window_activation mode = %i.\n", config.focus_on_window_activation);
287 }
288
289 CFGFUN(show_marks, const char *value) {
290     config.show_marks = eval_boolstr(value);
291 }
292
293 CFGFUN(workspace, const char *workspace, const char *output) {
294     DLOG("Assigning workspace \"%s\" to output \"%s\"\n", workspace, output);
295     /* Check for earlier assignments of the same workspace so that we
296      * don’t have assignments of a single workspace to different
297      * outputs */
298     struct Workspace_Assignment *assignment;
299     bool duplicate = false;
300     TAILQ_FOREACH(assignment, &ws_assignments, ws_assignments) {
301         if (strcasecmp(assignment->name, workspace) == 0) {
302             ELOG("You have a duplicate workspace assignment for workspace \"%s\"\n",
303                  workspace);
304             assignment->output = sstrdup(output);
305             duplicate = true;
306         }
307     }
308     if (!duplicate) {
309         assignment = scalloc(1, sizeof(struct Workspace_Assignment));
310         assignment->name = sstrdup(workspace);
311         assignment->output = sstrdup(output);
312         TAILQ_INSERT_TAIL(&ws_assignments, assignment, ws_assignments);
313     }
314 }
315
316 CFGFUN(ipc_socket, const char *path) {
317     free(config.ipc_socket_path);
318     config.ipc_socket_path = sstrdup(path);
319 }
320
321 CFGFUN(restart_state, const char *path) {
322     free(config.restart_state_path);
323     config.restart_state_path = sstrdup(path);
324 }
325
326 CFGFUN(popup_during_fullscreen, const char *value) {
327     if (strcmp(value, "ignore") == 0) {
328         config.popup_during_fullscreen = PDF_IGNORE;
329     } else if (strcmp(value, "leave_fullscreen") == 0) {
330         config.popup_during_fullscreen = PDF_LEAVE_FULLSCREEN;
331     } else {
332         config.popup_during_fullscreen = PDF_SMART;
333     }
334 }
335
336 CFGFUN(color_single, const char *colorclass, const char *color) {
337     /* used for client.background only currently */
338     config.client.background = draw_util_hex_to_color(color);
339 }
340
341 CFGFUN(color, const char *colorclass, const char *border, const char *background, const char *text, const char *indicator, const char *child_border) {
342 #define APPLY_COLORS(classname)                                                              \
343     do {                                                                                     \
344         if (strcmp(colorclass, "client." #classname) == 0) {                                 \
345             config.client.classname.border = draw_util_hex_to_color(border);                 \
346             config.client.classname.background = draw_util_hex_to_color(background);         \
347             config.client.classname.text = draw_util_hex_to_color(text);                     \
348             if (indicator != NULL) {                                                         \
349                 config.client.classname.indicator = draw_util_hex_to_color(indicator);       \
350             }                                                                                \
351             if (child_border != NULL) {                                                      \
352                 config.client.classname.child_border = draw_util_hex_to_color(child_border); \
353             } else {                                                                         \
354                 config.client.classname.child_border = config.client.classname.background;   \
355             }                                                                                \
356         }                                                                                    \
357     } while (0)
358
359     APPLY_COLORS(focused_inactive);
360     APPLY_COLORS(focused);
361     APPLY_COLORS(unfocused);
362     APPLY_COLORS(urgent);
363     APPLY_COLORS(placeholder);
364
365 #undef APPLY_COLORS
366 }
367
368 CFGFUN(assign, const char *workspace) {
369     if (match_is_empty(current_match)) {
370         ELOG("Match is empty, ignoring this assignment\n");
371         return;
372     }
373     DLOG("New assignment, using above criteria, to workspace \"%s\".\n", workspace);
374     Assignment *assignment = scalloc(1, sizeof(Assignment));
375     match_copy(&(assignment->match), current_match);
376     assignment->type = A_TO_WORKSPACE;
377     assignment->dest.workspace = sstrdup(workspace);
378     TAILQ_INSERT_TAIL(&assignments, assignment, assignments);
379 }
380
381 CFGFUN(no_focus) {
382     if (match_is_empty(current_match)) {
383         ELOG("Match is empty, ignoring this assignment\n");
384         return;
385     }
386
387     DLOG("New assignment, using above criteria, to ignore focus on manage.\n");
388     Assignment *assignment = scalloc(1, sizeof(Assignment));
389     match_copy(&(assignment->match), current_match);
390     assignment->type = A_NO_FOCUS;
391     TAILQ_INSERT_TAIL(&assignments, assignment, assignments);
392 }
393
394 /*******************************************************************************
395  * Bar configuration (i3bar)
396  ******************************************************************************/
397
398 static Barconfig *current_bar;
399
400 CFGFUN(bar_font, const char *font) {
401     FREE(current_bar->font);
402     current_bar->font = sstrdup(font);
403 }
404
405 CFGFUN(bar_separator_symbol, const char *separator) {
406     FREE(current_bar->separator_symbol);
407     current_bar->separator_symbol = sstrdup(separator);
408 }
409
410 CFGFUN(bar_mode, const char *mode) {
411     current_bar->mode = (strcmp(mode, "dock") == 0 ? M_DOCK : (strcmp(mode, "hide") == 0 ? M_HIDE : M_INVISIBLE));
412 }
413
414 CFGFUN(bar_hidden_state, const char *hidden_state) {
415     current_bar->hidden_state = (strcmp(hidden_state, "hide") == 0 ? S_HIDE : S_SHOW);
416 }
417
418 CFGFUN(bar_id, const char *bar_id) {
419     current_bar->id = sstrdup(bar_id);
420 }
421
422 CFGFUN(bar_output, const char *output) {
423     int new_outputs = current_bar->num_outputs + 1;
424     current_bar->outputs = srealloc(current_bar->outputs, sizeof(char *) * new_outputs);
425     current_bar->outputs[current_bar->num_outputs] = sstrdup(output);
426     current_bar->num_outputs = new_outputs;
427 }
428
429 CFGFUN(bar_verbose, const char *verbose) {
430     current_bar->verbose = eval_boolstr(verbose);
431 }
432
433 CFGFUN(bar_modifier, const char *modifier) {
434     if (strcmp(modifier, "Mod1") == 0)
435         current_bar->modifier = M_MOD1;
436     else if (strcmp(modifier, "Mod2") == 0)
437         current_bar->modifier = M_MOD2;
438     else if (strcmp(modifier, "Mod3") == 0)
439         current_bar->modifier = M_MOD3;
440     else if (strcmp(modifier, "Mod4") == 0)
441         current_bar->modifier = M_MOD4;
442     else if (strcmp(modifier, "Mod5") == 0)
443         current_bar->modifier = M_MOD5;
444     else if (strcmp(modifier, "Control") == 0 ||
445              strcmp(modifier, "Ctrl") == 0)
446         current_bar->modifier = M_CONTROL;
447     else if (strcmp(modifier, "Shift") == 0)
448         current_bar->modifier = M_SHIFT;
449 }
450
451 static void bar_configure_binding(const char *button, const char *command) {
452     if (strncasecmp(button, "button", strlen("button")) != 0) {
453         ELOG("Bindings for a bar can only be mouse bindings, not \"%s\", ignoring.\n", button);
454         return;
455     }
456
457     int input_code = atoi(button + strlen("button"));
458     if (input_code < 1) {
459         ELOG("Button \"%s\" does not seem to be in format 'buttonX'.\n", button);
460         return;
461     }
462
463     struct Barbinding *current;
464     TAILQ_FOREACH(current, &(current_bar->bar_bindings), bindings) {
465         if (current->input_code == input_code) {
466             ELOG("command for button %s was already specified, ignoring.\n", button);
467             return;
468         }
469     }
470
471     struct Barbinding *new_binding = scalloc(1, sizeof(struct Barbinding));
472     new_binding->input_code = input_code;
473     new_binding->command = sstrdup(command);
474     TAILQ_INSERT_TAIL(&(current_bar->bar_bindings), new_binding, bindings);
475 }
476
477 CFGFUN(bar_wheel_up_cmd, const char *command) {
478     ELOG("'wheel_up_cmd' is deprecated. Please us 'bindsym button4 %s' instead.\n", command);
479     bar_configure_binding("button4", command);
480 }
481
482 CFGFUN(bar_wheel_down_cmd, const char *command) {
483     ELOG("'wheel_down_cmd' is deprecated. Please us 'bindsym button5 %s' instead.\n", command);
484     bar_configure_binding("button5", command);
485 }
486
487 CFGFUN(bar_bindsym, const char *button, const char *command) {
488     bar_configure_binding(button, command);
489 }
490
491 CFGFUN(bar_position, const char *position) {
492     current_bar->position = (strcmp(position, "top") == 0 ? P_TOP : P_BOTTOM);
493 }
494
495 CFGFUN(bar_i3bar_command, const char *i3bar_command) {
496     FREE(current_bar->i3bar_command);
497     current_bar->i3bar_command = sstrdup(i3bar_command);
498 }
499
500 CFGFUN(bar_color, const char *colorclass, const char *border, const char *background, const char *text) {
501 #define APPLY_COLORS(classname)                                           \
502     do {                                                                  \
503         if (strcmp(colorclass, #classname) == 0) {                        \
504             if (text != NULL) {                                           \
505                 /* New syntax: border, background, text */                \
506                 current_bar->colors.classname##_border = sstrdup(border); \
507                 current_bar->colors.classname##_bg = sstrdup(background); \
508                 current_bar->colors.classname##_text = sstrdup(text);     \
509             } else {                                                      \
510                 /* Old syntax: text, background */                        \
511                 current_bar->colors.classname##_bg = sstrdup(background); \
512                 current_bar->colors.classname##_text = sstrdup(border);   \
513             }                                                             \
514         }                                                                 \
515     } while (0)
516
517     APPLY_COLORS(focused_workspace);
518     APPLY_COLORS(active_workspace);
519     APPLY_COLORS(inactive_workspace);
520     APPLY_COLORS(urgent_workspace);
521     APPLY_COLORS(binding_mode);
522
523 #undef APPLY_COLORS
524 }
525
526 CFGFUN(bar_socket_path, const char *socket_path) {
527     FREE(current_bar->socket_path);
528     current_bar->socket_path = sstrdup(socket_path);
529 }
530
531 CFGFUN(bar_tray_output, const char *output) {
532     struct tray_output_t *tray_output = scalloc(1, sizeof(struct tray_output_t));
533     tray_output->output = sstrdup(output);
534     TAILQ_INSERT_TAIL(&(current_bar->tray_outputs), tray_output, tray_outputs);
535 }
536
537 CFGFUN(bar_tray_padding, const long padding_px) {
538     current_bar->tray_padding = padding_px;
539 }
540
541 CFGFUN(bar_color_single, const char *colorclass, const char *color) {
542     if (strcmp(colorclass, "background") == 0)
543         current_bar->colors.background = sstrdup(color);
544     else if (strcmp(colorclass, "separator") == 0)
545         current_bar->colors.separator = sstrdup(color);
546     else if (strcmp(colorclass, "statusline") == 0)
547         current_bar->colors.statusline = sstrdup(color);
548     else if (strcmp(colorclass, "focused_background") == 0)
549         current_bar->colors.focused_background = sstrdup(color);
550     else if (strcmp(colorclass, "focused_separator") == 0)
551         current_bar->colors.focused_separator = sstrdup(color);
552     else
553         current_bar->colors.focused_statusline = sstrdup(color);
554 }
555
556 CFGFUN(bar_status_command, const char *command) {
557     FREE(current_bar->status_command);
558     current_bar->status_command = sstrdup(command);
559 }
560
561 CFGFUN(bar_binding_mode_indicator, const char *value) {
562     current_bar->hide_binding_mode_indicator = !eval_boolstr(value);
563 }
564
565 CFGFUN(bar_workspace_buttons, const char *value) {
566     current_bar->hide_workspace_buttons = !eval_boolstr(value);
567 }
568
569 CFGFUN(bar_strip_workspace_numbers, const char *value) {
570     current_bar->strip_workspace_numbers = eval_boolstr(value);
571 }
572
573 CFGFUN(bar_start) {
574     current_bar = scalloc(1, sizeof(struct Barconfig));
575     TAILQ_INIT(&(current_bar->bar_bindings));
576     TAILQ_INIT(&(current_bar->tray_outputs));
577     current_bar->tray_padding = 2;
578 }
579
580 CFGFUN(bar_finish) {
581     DLOG("\t new bar configuration finished, saving.\n");
582     /* Generate a unique ID for this bar if not already configured */
583     if (current_bar->id == NULL)
584         sasprintf(&current_bar->id, "bar-%d", config.number_barconfigs);
585
586     config.number_barconfigs++;
587
588     /* If no font was explicitly set, we use the i3 font as default */
589     if (current_bar->font == NULL && font_pattern != NULL)
590         current_bar->font = sstrdup(font_pattern);
591
592     TAILQ_INSERT_TAIL(&barconfigs, current_bar, configs);
593     /* Simply reset the pointer, but don't free the resources. */
594     current_bar = NULL;
595 }