i3
config_directives.c
Go to the documentation of this file.
1 /*
2  * vim:ts=4:sw=4:expandtab
3  *
4  * i3 - an improved dynamic tiling window manager
5  * © 2009 Michael Stapelberg and contributors (see also: LICENSE)
6  *
7  * config_directives.c: all config storing functions (see config_parser.c)
8  *
9  */
10 #include "all.h"
11 
12 #include <wordexp.h>
13 
14 /*******************************************************************************
15  * Include functions.
16  ******************************************************************************/
17 
18 CFGFUN(include, const char *pattern) {
19  DLOG("include %s\n", pattern);
20 
21  wordexp_t p;
22  const int ret = wordexp(pattern, &p, 0);
23  if (ret != 0) {
24  ELOG("wordexp(%s): error %d\n", pattern, ret);
25  result->has_errors = true;
26  return;
27  }
28  char **w = p.we_wordv;
29  for (size_t i = 0; i < p.we_wordc; i++) {
30  char resolved_path[PATH_MAX] = {'\0'};
31  if (realpath(w[i], resolved_path) == NULL) {
32  LOG("Skipping %s: %s\n", w[i], strerror(errno));
33  continue;
34  }
35 
36  bool skip = false;
37  IncludedFile *file;
38  TAILQ_FOREACH (file, &included_files, files) {
39  if (strcmp(file->path, resolved_path) == 0) {
40  skip = true;
41  break;
42  }
43  }
44  if (skip) {
45  LOG("Skipping file %s (already included)\n", resolved_path);
46  continue;
47  }
48 
49  LOG("Including config file %s\n", resolved_path);
50 
51  file = scalloc(1, sizeof(IncludedFile));
52  file->path = sstrdup(resolved_path);
53  TAILQ_INSERT_TAIL(&included_files, file, files);
54 
55  struct stack stack;
56  memset(&stack, '\0', sizeof(struct stack));
57  struct parser_ctx ctx = {
58  .use_nagbar = result->ctx->use_nagbar,
59  /* The include mechanism was added in v4, so we can skip the
60  * auto-detection and get rid of the risk of detecting the wrong
61  * version in potentially very short include fragments: */
62  .assume_v4 = true,
63  .stack = &stack,
64  .variables = result->ctx->variables,
65  };
66  switch (parse_file(&ctx, resolved_path, file)) {
67  case PARSE_FILE_SUCCESS:
68  break;
69 
70  case PARSE_FILE_FAILED:
71  ELOG("including config file %s: %s\n", resolved_path, strerror(errno));
72  /* fallthrough */
73 
75  result->has_errors = true;
76  TAILQ_REMOVE(&included_files, file, files);
77  FREE(file->path);
78  FREE(file->raw_contents);
80  FREE(file);
81  break;
82 
83  default:
84  /* missing case statement */
85  assert(false);
86  break;
87  }
88  }
89  wordfree(&p);
90 }
91 
92 /*******************************************************************************
93  * Criteria functions.
94  ******************************************************************************/
95 
97 
98 /*
99  * Initializes the specified 'Match' data structure and the initial state of
100  * commands.c for matching target windows of a command.
101  *
102  */
103 CFGFUN(criteria_init, int _state) {
104  criteria_next_state = _state;
105 
106  DLOG("Initializing criteria, current_match = %p, state = %d\n", current_match, _state);
109 }
110 
111 CFGFUN(criteria_pop_state) {
112  result->next_state = criteria_next_state;
113 }
114 
115 /*
116  * Interprets a ctype=cvalue pair and adds it to the current match
117  * specification.
118  *
119  */
120 CFGFUN(criteria_add, const char *ctype, const char *cvalue) {
121  match_parse_property(current_match, ctype, cvalue);
122 }
123 
124 /*******************************************************************************
125  * Utility functions
126  ******************************************************************************/
127 
128 /*
129  * A utility function to convert a string containing the group and modifiers to
130  * the corresponding bit mask.
131  */
133  /* It might be better to use strtok() here, but the simpler strstr() should
134  * do for now. */
135  i3_event_state_mask_t result = 0;
136  if (str == NULL)
137  return result;
138  if (strstr(str, "Mod1") != NULL)
139  result |= XCB_KEY_BUT_MASK_MOD_1;
140  if (strstr(str, "Mod2") != NULL)
141  result |= XCB_KEY_BUT_MASK_MOD_2;
142  if (strstr(str, "Mod3") != NULL)
143  result |= XCB_KEY_BUT_MASK_MOD_3;
144  if (strstr(str, "Mod4") != NULL)
145  result |= XCB_KEY_BUT_MASK_MOD_4;
146  if (strstr(str, "Mod5") != NULL)
147  result |= XCB_KEY_BUT_MASK_MOD_5;
148  if (strstr(str, "Control") != NULL ||
149  strstr(str, "Ctrl") != NULL)
150  result |= XCB_KEY_BUT_MASK_CONTROL;
151  if (strstr(str, "Shift") != NULL)
152  result |= XCB_KEY_BUT_MASK_SHIFT;
153 
154  if (strstr(str, "Group1") != NULL)
155  result |= (I3_XKB_GROUP_MASK_1 << 16);
156  if (strstr(str, "Group2") != NULL ||
157  strstr(str, "Mode_switch") != NULL)
158  result |= (I3_XKB_GROUP_MASK_2 << 16);
159  if (strstr(str, "Group3") != NULL)
160  result |= (I3_XKB_GROUP_MASK_3 << 16);
161  if (strstr(str, "Group4") != NULL)
162  result |= (I3_XKB_GROUP_MASK_4 << 16);
163  return result;
164 }
165 
166 CFGFUN(font, const char *font) {
167  config.font = load_font(font, true);
168  set_font(&config.font);
169 }
170 
171 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) {
172  configure_binding(bindtype, modifiers, key, release, border, whole_window, exclude_titlebar, command, DEFAULT_BINDING_MODE, false);
173 }
174 
175 /*******************************************************************************
176  * Mode handling
177  ******************************************************************************/
178 
179 static char *current_mode;
181 
182 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) {
183  if (current_mode == NULL) {
184  /* When using an invalid mode name, e.g. “default” */
185  return;
186  }
187 
188  configure_binding(bindtype, modifiers, key, release, border, whole_window, exclude_titlebar, command, current_mode, current_mode_pango_markup);
189 }
190 
191 CFGFUN(enter_mode, const char *pango_markup, const char *modename) {
192  if (strcmp(modename, DEFAULT_BINDING_MODE) == 0) {
193  ELOG("You cannot use the name %s for your mode\n", DEFAULT_BINDING_MODE);
194  return;
195  }
196 
197  struct Mode *mode;
198  SLIST_FOREACH (mode, &modes, modes) {
199  if (strcmp(mode->name, modename) == 0) {
200  ELOG("The binding mode with name \"%s\" is defined at least twice.\n", modename);
201  }
202  }
203 
204  DLOG("\t now in mode %s\n", modename);
206  current_mode = sstrdup(modename);
208 }
209 
210 CFGFUN(exec, const char *exectype, const char *no_startup_id, const char *command) {
211  struct Autostart *new = smalloc(sizeof(struct Autostart));
212  new->command = sstrdup(command);
213  new->no_startup_id = (no_startup_id != NULL);
214  if (strcmp(exectype, "exec") == 0) {
216  } else {
218  }
219 }
220 
221 CFGFUN(for_window, const char *command) {
223  ELOG("Match is empty, ignoring this for_window statement\n");
224  return;
225  }
226  DLOG("\t should execute command %s for the criteria mentioned above\n", command);
227  Assignment *assignment = scalloc(1, sizeof(Assignment));
228  assignment->type = A_COMMAND;
229  match_copy(&(assignment->match), current_match);
230  assignment->dest.command = sstrdup(command);
232 }
233 
234 static void apply_gaps(gaps_t *gaps, gaps_mask_t mask, int value) {
235  if (gaps == NULL) {
236  return;
237  }
238  if (mask & GAPS_INNER) {
239  gaps->inner = value;
240  }
241  if (mask & GAPS_TOP) {
242  gaps->top = value;
243  }
244  if (mask & GAPS_RIGHT) {
245  gaps->right = value;
246  }
247  if (mask & GAPS_BOTTOM) {
248  gaps->bottom = value;
249  }
250  if (mask & GAPS_LEFT) {
251  gaps->left = value;
252  }
253 }
254 
255 static void create_gaps_assignment(const char *workspace, const gaps_mask_t mask, const int pixels) {
256  if (mask == 0) {
257  return;
258  }
259 
260  DLOG("Setting gaps for workspace %s", workspace);
261 
262  bool found = false;
263  struct Workspace_Assignment *assignment;
265  if (strcasecmp(assignment->name, workspace) == 0) {
266  found = true;
267  break;
268  }
269  }
270 
271  /* Assignment does not yet exist, let's create it. */
272  if (!found) {
273  assignment = scalloc(1, sizeof(struct Workspace_Assignment));
274  assignment->name = sstrdup(workspace);
275  assignment->output = NULL;
277  }
278 
279  assignment->gaps_mask |= mask;
280  apply_gaps(&assignment->gaps, mask, pixels);
281 }
282 
283 static gaps_mask_t gaps_scope_to_mask(const char *scope) {
284  if (!strcmp(scope, "inner")) {
285  return GAPS_INNER;
286  } else if (!strcmp(scope, "outer")) {
287  return GAPS_OUTER;
288  } else if (!strcmp(scope, "vertical")) {
289  return GAPS_VERTICAL;
290  } else if (!strcmp(scope, "horizontal")) {
291  return GAPS_HORIZONTAL;
292  } else if (!strcmp(scope, "top")) {
293  return GAPS_TOP;
294  } else if (!strcmp(scope, "right")) {
295  return GAPS_RIGHT;
296  } else if (!strcmp(scope, "bottom")) {
297  return GAPS_BOTTOM;
298  } else if (!strcmp(scope, "left")) {
299  return GAPS_LEFT;
300  }
301  ELOG("Invalid command, cannot process scope %s", scope);
302  return 0;
303 }
304 
305 CFGFUN(gaps, const char *workspace, const char *scope, const long value) {
306  int pixels = logical_px(value);
307  gaps_mask_t mask = gaps_scope_to_mask(scope);
308 
309  if (workspace == NULL) {
310  apply_gaps(&config.gaps, mask, pixels);
311  } else {
312  create_gaps_assignment(workspace, mask, pixels);
313  }
314 }
315 
316 CFGFUN(smart_borders, const char *enable) {
317  if (!strcmp(enable, "no_gaps"))
319  else
321 }
322 
323 CFGFUN(smart_gaps, const char *enable) {
324  if (!strcmp(enable, "inverse_outer"))
326  else
328 }
329 
330 CFGFUN(floating_minimum_size, const long width, const long height) {
333 }
334 
335 CFGFUN(floating_maximum_size, const long width, const long height) {
338 }
339 
340 CFGFUN(floating_modifier, const char *modifiers) {
342 }
343 
344 CFGFUN(default_orientation, const char *orientation) {
345  if (strcmp(orientation, "horizontal") == 0)
347  else if (strcmp(orientation, "vertical") == 0)
349  else
351 }
352 
353 CFGFUN(workspace_layout, const char *layout) {
354  if (strcmp(layout, "default") == 0)
356  else if (strcmp(layout, "stacking") == 0 ||
357  strcmp(layout, "stacked") == 0)
359  else
361 }
362 
363 CFGFUN(default_border, const char *windowtype, const char *border, const long width) {
364  int border_style;
365  int border_width;
366 
367  if (strcmp(border, "1pixel") == 0) {
368  border_style = BS_PIXEL;
369  border_width = 1;
370  } else if (strcmp(border, "none") == 0) {
371  border_style = BS_NONE;
372  border_width = 0;
373  } else if (strcmp(border, "pixel") == 0) {
374  border_style = BS_PIXEL;
375  border_width = width;
376  } else {
377  border_style = BS_NORMAL;
378  border_width = width;
379  }
380 
381  if ((strcmp(windowtype, "default_border") == 0) ||
382  (strcmp(windowtype, "new_window") == 0)) {
383  DLOG("default tiled border style = %d and border width = %d (%d physical px)\n",
384  border_style, border_width, logical_px(border_width));
385  config.default_border = border_style;
386  config.default_border_width = logical_px(border_width);
387  } else {
388  DLOG("default floating border style = %d and border width = %d (%d physical px)\n",
389  border_style, border_width, logical_px(border_width));
390  config.default_floating_border = border_style;
392  }
393 }
394 
395 CFGFUN(hide_edge_borders, const char *borders) {
396  if (strcmp(borders, "smart_no_gaps") == 0)
398  else if (strcmp(borders, "smart") == 0)
400  else if (strcmp(borders, "vertical") == 0)
402  else if (strcmp(borders, "horizontal") == 0)
404  else if (strcmp(borders, "both") == 0)
406  else if (strcmp(borders, "none") == 0)
408  else if (boolstr(borders))
410  else
412 }
413 
414 CFGFUN(focus_follows_mouse, const char *value) {
416 }
417 
418 CFGFUN(mouse_warping, const char *value) {
419  if (strcmp(value, "none") == 0)
421  else if (strcmp(value, "output") == 0)
423 }
424 
425 CFGFUN(force_xinerama, const char *value) {
426  config.force_xinerama = boolstr(value);
427 }
428 
429 CFGFUN(disable_randr15, const char *value) {
430  config.disable_randr15 = boolstr(value);
431 }
432 
433 CFGFUN(focus_wrapping, const char *value) {
434  if (strcmp(value, "force") == 0) {
436  } else if (strcmp(value, "workspace") == 0) {
438  } else if (boolstr(value)) {
440  } else {
442  }
443 }
444 
445 CFGFUN(force_focus_wrapping, const char *value) {
446  /* Legacy syntax. */
447  if (boolstr(value)) {
449  } else {
450  /* For "force_focus_wrapping off", don't enable or disable
451  * focus wrapping, just ensure it's not forced. */
454  }
455  }
456 }
457 
458 CFGFUN(workspace_back_and_forth, const char *value) {
460 }
461 
462 CFGFUN(fake_outputs, const char *outputs) {
463  free(config.fake_outputs);
465 }
466 
467 CFGFUN(force_display_urgency_hint, const long duration_ms) {
468  config.workspace_urgency_timer = duration_ms / 1000.0;
469 }
470 
471 CFGFUN(focus_on_window_activation, const char *mode) {
472  if (strcmp(mode, "smart") == 0)
473  config.focus_on_window_activation = FOWA_SMART;
474  else if (strcmp(mode, "urgent") == 0)
475  config.focus_on_window_activation = FOWA_URGENT;
476  else if (strcmp(mode, "focus") == 0)
477  config.focus_on_window_activation = FOWA_FOCUS;
478  else if (strcmp(mode, "none") == 0)
480  else {
481  ELOG("Unknown focus_on_window_activation mode \"%s\", ignoring it.\n", mode);
482  return;
483  }
484 
485  DLOG("Set new focus_on_window_activation mode = %i.\n", config.focus_on_window_activation);
486 }
487 
488 CFGFUN(title_align, const char *alignment) {
489  if (strcmp(alignment, "left") == 0) {
490  config.title_align = ALIGN_LEFT;
491  } else if (strcmp(alignment, "center") == 0) {
492  config.title_align = ALIGN_CENTER;
493  } else if (strcmp(alignment, "right") == 0) {
494  config.title_align = ALIGN_RIGHT;
495  } else {
496  assert(false);
497  }
498 }
499 
500 CFGFUN(show_marks, const char *value) {
501  config.show_marks = boolstr(value);
502 }
503 
504 static char *current_workspace = NULL;
505 
506 CFGFUN(workspace, const char *workspace, const char *output) {
507  struct Workspace_Assignment *assignment;
508 
509  /* When a new workspace line is encountered, for the first output word,
510  * $workspace from the config.spec is non-NULL. Afterwards, the parser calls
511  * clear_stack() because of the call line. Thus, we have to preserve the
512  * workspace string. */
513  if (workspace) {
515 
517  if (strcasecmp(assignment->name, workspace) == 0) {
518  if (assignment->output != NULL) {
519  ELOG("You have a duplicate workspace assignment for workspace \"%s\"\n",
520  workspace);
521  return;
522  }
523  }
524  }
525 
526  current_workspace = sstrdup(workspace);
527  } else {
528  if (!current_workspace) {
529  DLOG("Both workspace and current_workspace are NULL, assuming we had an error before\n");
530  return;
531  }
532  workspace = current_workspace;
533  }
534 
535  DLOG("Assigning workspace \"%s\" to output \"%s\"\n", workspace, output);
536 
537  assignment = scalloc(1, sizeof(struct Workspace_Assignment));
538  assignment->name = sstrdup(workspace);
539  assignment->output = sstrdup(output);
541 }
542 
543 CFGFUN(ipc_socket, const char *path) {
544  free(config.ipc_socket_path);
546 }
547 
548 CFGFUN(restart_state, const char *path) {
551 }
552 
553 CFGFUN(popup_during_fullscreen, const char *value) {
554  if (strcmp(value, "ignore") == 0) {
555  config.popup_during_fullscreen = PDF_IGNORE;
556  } else if (strcmp(value, "leave_fullscreen") == 0) {
557  config.popup_during_fullscreen = PDF_LEAVE_FULLSCREEN;
558  } else {
559  config.popup_during_fullscreen = PDF_SMART;
560  }
561 }
562 
563 CFGFUN(color_single, const char *colorclass, const char *color) {
564  /* used for client.background only currently */
566 }
567 
568 CFGFUN(color, const char *colorclass, const char *qubelabel, const char *border, const char *background, const char *text, const char *indicator, const char *child_border) {
569 #define APPLY_COLORS(classname, label) \
570  do { \
571  if (strcmp(colorclass, "client." #classname) == 0) { \
572  if (strcmp("focused_tab_title", #classname) == 0) { \
573  config.client[label].got_focused_tab_title = true; \
574  if (indicator || child_border) { \
575  ELOG("indicator and child_border colors have no effect for client.focused_tab_title\n"); \
576  } \
577  } \
578  config.client[label].classname.border = draw_util_hex_to_color(border); \
579  config.client[label].classname.background = draw_util_hex_to_color(background); \
580  config.client[label].classname.text = draw_util_hex_to_color(text); \
581  if (indicator != NULL) { \
582  config.client[label].classname.indicator = draw_util_hex_to_color(indicator); \
583  } \
584  if (child_border != NULL) { \
585  config.client[label].classname.child_border = draw_util_hex_to_color(child_border); \
586  } else { \
587  config.client[label].classname.child_border = config.client[label].classname.background; \
588  } \
589  return; \
590  } \
591  } while (0)
592 
593  int valid_color = 1;
594  qube_label_t label = QUBE_DOM0;
595  if (strcmp(qubelabel, "dom0") == 0) {
596  label = QUBE_DOM0;
597  } else if (strcmp(qubelabel, "red") == 0) {
598  label = QUBE_RED;
599  } else if (strcmp(qubelabel, "orange") == 0) {
600  label = QUBE_ORANGE;
601  } else if (strcmp(qubelabel, "yellow") == 0) {
602  label = QUBE_YELLOW;
603  } else if (strcmp(qubelabel, "green") == 0) {
604  label = QUBE_GREEN;
605  } else if (strcmp(qubelabel, "gray") == 0) {
606  label = QUBE_GRAY;
607  } else if (strcmp(qubelabel, "blue") == 0) {
608  label = QUBE_BLUE;
609  } else if (strcmp(qubelabel, "purple") == 0) {
610  label = QUBE_PURPLE;
611  } else if (strcmp(qubelabel, "black") == 0) {
612  label = QUBE_BLACK;
613  } else {
614  valid_color = 0;
615  }
616 
617  if (valid_color) {
618  APPLY_COLORS(focused_inactive, label);
619  APPLY_COLORS(focused, label);
620  APPLY_COLORS(unfocused, label);
621  APPLY_COLORS(urgent, label);
622  }
623 
624 
625 #undef APPLY_COLORS
626 }
627 
628 CFGFUN(assign_output, const char *output) {
630  ELOG("Match is empty, ignoring this assignment\n");
631  return;
632  }
633 
634  if (current_match->window_mode != WM_ANY) {
635  ELOG("Assignments using window mode (floating/tiling) is not supported\n");
636  return;
637  }
638 
639  DLOG("New assignment, using above criteria, to output \"%s\".\n", output);
640  Assignment *assignment = scalloc(1, sizeof(Assignment));
641  match_copy(&(assignment->match), current_match);
642  assignment->type = A_TO_OUTPUT;
643  assignment->dest.output = sstrdup(output);
645 }
646 
647 CFGFUN(assign, const char *workspace, bool is_number) {
649  ELOG("Match is empty, ignoring this assignment\n");
650  return;
651  }
652 
653  if (current_match->window_mode != WM_ANY) {
654  ELOG("Assignments using window mode (floating/tiling) is not supported\n");
655  return;
656  }
657 
658  if (is_number && ws_name_to_number(workspace) == -1) {
659  ELOG("Could not parse initial part of \"%s\" as a number.\n", workspace);
660  return;
661  }
662 
663  DLOG("New assignment, using above criteria, to workspace \"%s\".\n", workspace);
664  Assignment *assignment = scalloc(1, sizeof(Assignment));
665  match_copy(&(assignment->match), current_match);
666  assignment->type = is_number ? A_TO_WORKSPACE_NUMBER : A_TO_WORKSPACE;
667  assignment->dest.workspace = sstrdup(workspace);
669 }
670 
671 CFGFUN(no_focus) {
673  ELOG("Match is empty, ignoring this assignment\n");
674  return;
675  }
676 
677  DLOG("New assignment, using above criteria, to ignore focus on manage.\n");
678  Assignment *assignment = scalloc(1, sizeof(Assignment));
679  match_copy(&(assignment->match), current_match);
680  assignment->type = A_NO_FOCUS;
682 }
683 
684 CFGFUN(ipc_kill_timeout, const long timeout_ms) {
685  ipc_set_kill_timeout(timeout_ms / 1000.0);
686 }
687 
688 CFGFUN(tiling_drag, const char *value) {
689  if (strcmp(value, "modifier") == 0) {
691  } else if (strcmp(value, "titlebar") == 0) {
693  } else if (strcmp(value, "modifier,titlebar") == 0 ||
694  strcmp(value, "titlebar,modifier") == 0) {
695  /* Switch the above to strtok() or similar if we ever grow more options */
697  } else {
699  }
700 }
701 
702 /*******************************************************************************
703  * Bar configuration (i3bar)
704  ******************************************************************************/
705 
707 
708 CFGFUN(bar_font, const char *font) {
710  current_bar->font = sstrdup(font);
711 }
712 
713 CFGFUN(bar_separator_symbol, const char *separator) {
715  current_bar->separator_symbol = sstrdup(separator);
716 }
717 
718 CFGFUN(bar_mode, const char *mode) {
719  current_bar->mode = (strcmp(mode, "dock") == 0 ? M_DOCK : (strcmp(mode, "hide") == 0 ? M_HIDE : M_INVISIBLE));
720 }
721 
722 CFGFUN(bar_hidden_state, const char *hidden_state) {
723  current_bar->hidden_state = (strcmp(hidden_state, "hide") == 0 ? S_HIDE : S_SHOW);
724 }
725 
726 CFGFUN(bar_id, const char *bar_id) {
727  current_bar->id = sstrdup(bar_id);
728 }
729 
730 CFGFUN(bar_output, const char *output) {
731  int new_outputs = current_bar->num_outputs + 1;
732  current_bar->outputs = srealloc(current_bar->outputs, sizeof(char *) * new_outputs);
734  current_bar->num_outputs = new_outputs;
735 }
736 
737 CFGFUN(bar_verbose, const char *verbose) {
739 }
740 
741 CFGFUN(bar_height, const long height) {
742  current_bar->bar_height = (uint32_t)height;
743 }
744 
745 static void dlog_padding(void) {
746  DLOG("padding now: x=%d, y=%d, w=%d, h=%d\n",
751 }
752 
753 CFGFUN(bar_padding_one, const long all) {
754  current_bar->padding.x = (uint32_t)all;
755  current_bar->padding.y = (uint32_t)all;
756  current_bar->padding.width = (uint32_t)all;
757  current_bar->padding.height = (uint32_t)all;
758  dlog_padding();
759 }
760 
761 CFGFUN(bar_padding_two, const long top_and_bottom, const long right_and_left) {
762  current_bar->padding.x = (uint32_t)right_and_left;
763  current_bar->padding.y = (uint32_t)top_and_bottom;
764  current_bar->padding.width = (uint32_t)right_and_left;
765  current_bar->padding.height = (uint32_t)top_and_bottom;
766  dlog_padding();
767 }
768 
769 CFGFUN(bar_padding_three, const long top, const long right_and_left, const long bottom) {
770  current_bar->padding.x = (uint32_t)right_and_left;
771  current_bar->padding.y = (uint32_t)top;
772  current_bar->padding.width = (uint32_t)right_and_left;
773  current_bar->padding.height = (uint32_t)bottom;
774  dlog_padding();
775 }
776 
777 CFGFUN(bar_padding_four, const long top, const long right, const long bottom, const long left) {
778  current_bar->padding.x = (uint32_t)left;
779  current_bar->padding.y = (uint32_t)top;
780  current_bar->padding.width = (uint32_t)right;
781  current_bar->padding.height = (uint32_t)bottom;
782  dlog_padding();
783 }
784 
785 CFGFUN(bar_modifier, const char *modifiers) {
786  current_bar->modifier = modifiers ? event_state_from_str(modifiers) : XCB_NONE;
787 }
788 
789 static void bar_configure_binding(const char *button, const char *release, const char *command) {
790  if (strncasecmp(button, "button", strlen("button")) != 0) {
791  ELOG("Bindings for a bar can only be mouse bindings, not \"%s\", ignoring.\n", button);
792  return;
793  }
794 
795  int input_code = atoi(button + strlen("button"));
796  if (input_code < 1) {
797  ELOG("Button \"%s\" does not seem to be in format 'buttonX'.\n", button);
798  return;
799  }
800  const bool release_bool = release != NULL;
801 
802  struct Barbinding *current;
803  TAILQ_FOREACH (current, &(current_bar->bar_bindings), bindings) {
804  if (current->input_code == input_code && current->release == release_bool) {
805  ELOG("command for button %s was already specified, ignoring.\n", button);
806  return;
807  }
808  }
809 
810  struct Barbinding *new_binding = scalloc(1, sizeof(struct Barbinding));
811  new_binding->release = release_bool;
812  new_binding->input_code = input_code;
813  new_binding->command = sstrdup(command);
814  TAILQ_INSERT_TAIL(&(current_bar->bar_bindings), new_binding, bindings);
815 }
816 
817 CFGFUN(bar_wheel_up_cmd, const char *command) {
818  ELOG("'wheel_up_cmd' is deprecated. Please us 'bindsym button4 %s' instead.\n", command);
819  bar_configure_binding("button4", NULL, command);
820 }
821 
822 CFGFUN(bar_wheel_down_cmd, const char *command) {
823  ELOG("'wheel_down_cmd' is deprecated. Please us 'bindsym button5 %s' instead.\n", command);
824  bar_configure_binding("button5", NULL, command);
825 }
826 
827 CFGFUN(bar_bindsym, const char *button, const char *release, const char *command) {
829 }
830 
831 CFGFUN(bar_position, const char *position) {
832  current_bar->position = (strcmp(position, "top") == 0 ? P_TOP : P_BOTTOM);
833 }
834 
835 CFGFUN(bar_i3bar_command, const char *i3bar_command) {
837  current_bar->i3bar_command = sstrdup(i3bar_command);
838 }
839 
840 CFGFUN(bar_color, const char *colorclass, const char *border, const char *background, const char *text) {
841 #define APPLY_COLORS(classname) \
842  do { \
843  if (strcmp(colorclass, #classname) == 0) { \
844  if (text != NULL) { \
845  /* New syntax: border, background, text */ \
846  current_bar->colors.classname##_border = sstrdup(border); \
847  current_bar->colors.classname##_bg = sstrdup(background); \
848  current_bar->colors.classname##_text = sstrdup(text); \
849  } else { \
850  /* Old syntax: text, background */ \
851  current_bar->colors.classname##_bg = sstrdup(background); \
852  current_bar->colors.classname##_text = sstrdup(border); \
853  } \
854  } \
855  } while (0)
856 
857  APPLY_COLORS(focused_workspace);
858  APPLY_COLORS(active_workspace);
859  APPLY_COLORS(inactive_workspace);
860  APPLY_COLORS(urgent_workspace);
861  APPLY_COLORS(binding_mode);
862 
863 #undef APPLY_COLORS
864 }
865 
866 CFGFUN(bar_socket_path, const char *socket_path) {
868  current_bar->socket_path = sstrdup(socket_path);
869 }
870 
871 CFGFUN(bar_tray_output, const char *output) {
872  struct tray_output_t *tray_output = scalloc(1, sizeof(struct tray_output_t));
873  tray_output->output = sstrdup(output);
874  TAILQ_INSERT_TAIL(&(current_bar->tray_outputs), tray_output, tray_outputs);
875 }
876 
877 CFGFUN(bar_tray_padding, const long padding_px) {
878  current_bar->tray_padding = padding_px;
879 }
880 
881 CFGFUN(bar_color_single, const char *colorclass, const char *color) {
882  if (strcmp(colorclass, "background") == 0)
884  else if (strcmp(colorclass, "separator") == 0)
886  else if (strcmp(colorclass, "statusline") == 0)
888  else if (strcmp(colorclass, "focused_background") == 0)
890  else if (strcmp(colorclass, "focused_separator") == 0)
892  else
894 }
895 
896 CFGFUN(bar_status_command, const char *command) {
898  current_bar->status_command = sstrdup(command);
899 }
900 
901 CFGFUN(bar_binding_mode_indicator, const char *value) {
903 }
904 
905 CFGFUN(bar_workspace_buttons, const char *value) {
907 }
908 
909 CFGFUN(bar_workspace_min_width, const long width) {
911 }
912 
913 CFGFUN(bar_strip_workspace_numbers, const char *value) {
915 }
916 
917 CFGFUN(bar_strip_workspace_name, const char *value) {
919 }
920 
921 CFGFUN(bar_start) {
922  current_bar = scalloc(1, sizeof(struct Barconfig));
923  TAILQ_INIT(&(current_bar->bar_bindings));
924  TAILQ_INIT(&(current_bar->tray_outputs));
926  current_bar->modifier = XCB_KEY_BUT_MASK_MOD_4;
927 }
928 
929 CFGFUN(bar_finish) {
930  DLOG("\t new bar configuration finished, saving.\n");
931  /* Generate a unique ID for this bar if not already configured */
932  if (current_bar->id == NULL)
934 
936 
938  /* Simply reset the pointer, but don't free the resources. */
939  current_bar = NULL;
940 }
struct bindings_head * bindings
Definition: main.c:87
struct Rect padding
char * workspace
Definition: data.h:649
int left
Definition: data.h:155
#define ELOG(fmt,...)
Definition: libi3.h:100
struct assignments_head assignments
Definition: main.c:97
Definition: data.h:68
Definition: data.h:67
Holds the status bar configuration (i3bar).
enum Barconfig::@7 mode
Bar display mode (hide unless modifier is pressed or show in dock mode or always hide in invisible mo...
void set_font(i3Font *font)
Defines the font to be used for the forthcoming calls.
uint32_t y
Definition: data.h:209
bool force_xinerama
By default, use the RandR API for multi-monitor setups.
border_style_t default_floating_border
The default border style for new floating windows.
struct Barconfig::bar_colors colors
enum Barconfig::@8 hidden_state
void tiling_drag(Con *con, xcb_button_press_event_t *event, bool use_threshold)
Initiates a mouse drag operation on a tiled window.
Definition: tiling_drag.c:304
bool no_startup_id
no_startup_id flag for start_application().
Definition: data.h:396
bool strip_workspace_name
Strip workspace name? Configuration option is &#39;strip_workspace_name yes&#39;.
char * separator_symbol
A custom separator to use instead of a vertical line.
union Assignment::@17 dest
destination workspace/command/output, depending on the type
struct barconfig_head barconfigs
Definition: config.c:21
uint32_t modifier
Bar modifier (to show bar when in hide mode).
bool strip_workspace_numbers
Strip workspace numbers? Configuration option is &#39;strip_workspace_numbers yes&#39;.
struct includedfiles_head included_files
Definition: config.c:22
bool disable_focus_follows_mouse
By default, focus follows mouse.
int top
Definition: data.h:152
char * command
Definition: data.h:648
Defines a mouse command to be executed instead of the default behavior when clicking on the non-statu...
Definition: data.h:92
char * restart_state_path
bool match_is_empty(Match *match)
Check if a match is empty.
Definition: match.c:39
float workspace_urgency_timer
By default, urgency is cleared immediately when switching to another workspace leads to focusing the ...
char * status_command
Command that should be run to get a statusline, for example &#39;i3status&#39;.
CFGFUN(include, const char *pattern)
The configuration file can contain multiple sets of bindings.
Definition: configuration.h:93
int default_floating_border_width
int right
Definition: data.h:153
uint32_t height
Definition: data.h:211
smart_gaps_t smart_gaps
int input_code
The button to be used (e.g., 1 for "button1").
struct ws_assignments_head ws_assignments
Definition: main.c:101
const char * DEFAULT_BINDING_MODE
The name of the default mode.
Definition: bindings.c:25
static void bar_configure_binding(const char *button, const char *release, const char *command)
enum Assignment::@16 type
type of this assignment:
enum Barconfig::@9 position
Bar position (bottom by default).
int logical_px(const int logical)
Convert a logical amount of pixels (e.g.
color_t draw_util_hex_to_color(const char *color)
Parses the given color in hex format to an internal color representation.
char * name
Definition: configuration.h:94
Definition: data.h:150
struct modes_head modes
Definition: config.c:20
int num_outputs
Number of outputs in the outputs array.
parse_file_result_t parse_file(struct parser_ctx *ctx, const char *f, IncludedFile *included_file)
Parses the given file by first replacing the variables, then calling parse_config and launching i3-na...
qube_label_t
Qubes colors.
Definition: data.h:182
char * output
Definition: data.h:650
warping_t mouse_warping
By default, when switching focus to a window on a different output (e.g.
static void apply_gaps(gaps_t *gaps, gaps_mask_t mask, int value)
Holds a command specified by either an:
Definition: data.h:391
static void dlog_padding(void)
char * raw_contents
Definition: configuration.h:81
struct autostarts_always_head autostarts_always
Definition: main.c:94
gaps_mask_t
Definition: data.h:158
smart_borders_t smart_borders
static int criteria_next_state
enum Config::@4 focus_on_window_activation
Behavior when a window sends a NET_ACTIVE_WINDOW message.
Stores which workspace (by name or number) goes to which output and its gaps config.
Definition: data.h:257
struct autostarts_head autostarts
Definition: main.c:91
int inner
Definition: data.h:151
int default_orientation
Default orientation for new containers.
#define TAILQ_INIT(head)
Definition: queue.h:360
void workspace_back_and_forth(void)
Focuses the previously focused workspace.
Definition: workspace.c:809
Definition: data.h:95
struct Config::config_client client[QUBE_NUM_LABELS]
#define TAILQ_FOREACH(var, head, field)
Definition: queue.h:347
void * smalloc(size_t size)
Safe-wrapper around malloc which exits if malloc returns NULL (meaning that there is no more memory a...
enum Match::@14 window_mode
char * variable_replaced_contents
Definition: configuration.h:82
void ipc_set_kill_timeout(ev_tstamp new)
Set the maximum duration that we allow for a connection with an unwriteable socket.
char ** outputs
Outputs on which this bar should show up on.
int workspace_min_width
The minimal width for workspace buttons.
void * scalloc(size_t num, size_t size)
Safe-wrapper around calloc which exits if malloc returns NULL (meaning that there is no more memory a...
char * font
Font specification for all text rendered on the bar.
void match_parse_property(Match *match, const char *ctype, const char *cvalue)
Interprets a ctype=cvalue pair and adds it to the given match specification.
Definition: match.c:291
Definition: data.h:108
int32_t floating_minimum_width
bool disable_randr15
Don’t use RandR 1.5 for querying outputs.
i3Font font
#define FREE(pointer)
Definition: util.h:47
bool force_xinerama
Definition: main.c:107
int32_t floating_maximum_width
Maximum and minimum dimensions of a floating window.
Definition: data.h:184
static struct stack stack
bool hide_binding_mode_indicator
Hide mode button? Configuration option is &#39;binding_mode_indicator no&#39; but we invert the bool for the ...
focus_wrapping_t focus_wrapping
When focus wrapping is enabled (the default), attempting to move focus past the edge of the screen (i...
int sasprintf(char **strp, const char *fmt,...)
Safe-wrapper around asprintf which exits if it returns -1 (meaning that there is no more memory avail...
static char * current_mode
#define SLIST_FOREACH(var, head, field)
Definition: queue.h:114
Definition: data.h:160
i3Font load_font(const char *pattern, const bool fallback)
Loads a font for usage, also getting its height.
bool hide_workspace_buttons
Hide workspace buttons? Configuration option is &#39;workspace_buttons no&#39; but we invert the bool to get ...
static bool current_mode_pango_markup
char * command
Command, like in command mode.
Definition: data.h:393
int default_border_width
void match_free(Match *match)
Frees the given match.
Definition: match.c:275
bool pango_markup
Definition: configuration.h:95
void match_copy(Match *dest, Match *src)
Copies the data of a match from src to dest.
Definition: match.c:64
int32_t floating_minimum_height
uint32_t x
Definition: data.h:208
int32_t floating_maximum_height
char * id
Automatically generated ID for this bar config.
i3_event_state_mask_t event_state_from_str(const char *str)
A utility function to convert a string containing the group and modifiers to the corresponding bit ma...
uint32_t floating_modifier
The modifier which needs to be pressed in combination with your mouse buttons to do things with float...
static gaps_mask_t gaps_scope_to_mask(const char *scope)
bool boolstr(const char *str)
Reports whether str represents the enabled state (1, yes, true, …).
gaps_t gaps
uint32_t i3_event_state_mask_t
The lower 16 bits contain a xcb_key_but_mask_t, the higher 16 bits contain an i3_xkb_group_mask_t.
Definition: data.h:140
hide_edge_borders_mode_t hide_edge_borders
Remove borders if they are adjacent to the screen edge.
char * command
The command which is to be executed for this button.
Definition: data.h:61
tiling_drag_t tiling_drag
border_style_t default_border
The default border style for new windows.
int number_barconfigs
bool show_marks
Specifies whether or not marks should be displayed in the window decoration.
int ws_name_to_number(const char *name)
Parses the workspace name as a number.
Definition: util.c:109
enum Config::@5 title_align
Title alignment options.
#define TAILQ_INSERT_TAIL(head, elm, field)
Definition: queue.h:376
char * fake_outputs
Overwrites output detection (for testing), see src/fake_outputs.c.
uint32_t width
Definition: data.h:210
char * sstrdup(const char *str)
Safe-wrapper around strdup which exits if malloc returns NULL (meaning that there is no more memory a...
static Match current_match
char * ipc_socket_path
enum Config::@6 popup_during_fullscreen
What should happen when a new popup is opened during fullscreen mode.
gaps_mask_t gaps_mask
Definition: data.h:261
#define DLOG(fmt,...)
Definition: libi3.h:105
Definition: data.h:62
static void create_gaps_assignment(const char *workspace, const gaps_mask_t mask, const int pixels)
int bottom
Definition: data.h:154
Match match
the criteria to check if a window matches
Definition: data.h:644
struct Con * focused
Definition: tree.c:13
Config config
Definition: config.c:19
void * srealloc(void *ptr, size_t size)
Safe-wrapper around realloc which exits if realloc returns NULL (meaning that there is no more memory...
bool workspace_auto_back_and_forth
Automatic workspace back and forth switching.
char * socket_path
Path to the i3 IPC socket.
layout_t default_layout
#define LOG(fmt,...)
Definition: libi3.h:95
char * i3bar_command
Command that should be run to execute i3bar, give a full path if i3bar is not in your $PATH...
#define TAILQ_REMOVE(head, elm, field)
Definition: queue.h:402
Binding * configure_binding(const char *bindtype, const char *modifiers, const char *input_code, const char *release, const char *border, const char *whole_window, const char *exclude_titlebar, const char *command, const char *modename, bool pango_markup)
Adds a binding from config parameters given as strings and returns a pointer to the binding structure...
Definition: bindings.c:59
bool verbose
Enable verbose mode? Useful for debugging purposes.
Definition: data.h:66
static xcb_cursor_context_t * ctx
Definition: xcursor.c:19
static char * current_workspace
static Barconfig * current_bar
struct outputs_head outputs
Definition: randr.c:22
bool release
If true, the command will be executed after the button is released.
List entry struct for an included file.
Definition: configuration.h:79
#define APPLY_COLORS(classname, label)
uint32_t bar_height
Defines the height of the bar in pixels.
void match_init(Match *match)
Initializes the Match data structure.
Definition: match.c:26
An Assignment makes specific windows go to a specific workspace/output or run a command for that wind...
Definition: data.h:622
static bool verbose
Definition: log.c:36
int tray_padding