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 /*******************************************************************************
13  * Criteria functions.
14  ******************************************************************************/
15 
17 
18 /*
19  * Initializes the specified 'Match' data structure and the initial state of
20  * commands.c for matching target windows of a command.
21  *
22  */
23 CFGFUN(criteria_init, int _state) {
24  criteria_next_state = _state;
25 
26  DLOG("Initializing criteria, current_match = %p, state = %d\n", current_match, _state);
29 }
30 
31 CFGFUN(criteria_pop_state) {
32  result->next_state = criteria_next_state;
33 }
34 
35 /*
36  * Interprets a ctype=cvalue pair and adds it to the current match
37  * specification.
38  *
39  */
40 CFGFUN(criteria_add, const char *ctype, const char *cvalue) {
41  match_parse_property(current_match, ctype, cvalue);
42 }
43 
44 /*******************************************************************************
45  * Utility functions
46  ******************************************************************************/
47 
48 static bool eval_boolstr(const char *str) {
49  return (strcasecmp(str, "1") == 0 ||
50  strcasecmp(str, "yes") == 0 ||
51  strcasecmp(str, "true") == 0 ||
52  strcasecmp(str, "on") == 0 ||
53  strcasecmp(str, "enable") == 0 ||
54  strcasecmp(str, "active") == 0);
55 }
56 
57 /*
58  * A utility function to convert a string containing the group and modifiers to
59  * the corresponding bit mask.
60  */
62  /* It might be better to use strtok() here, but the simpler strstr() should
63  * do for now. */
64  i3_event_state_mask_t result = 0;
65  if (str == NULL)
66  return result;
67  if (strstr(str, "Mod1") != NULL)
68  result |= XCB_KEY_BUT_MASK_MOD_1;
69  if (strstr(str, "Mod2") != NULL)
70  result |= XCB_KEY_BUT_MASK_MOD_2;
71  if (strstr(str, "Mod3") != NULL)
72  result |= XCB_KEY_BUT_MASK_MOD_3;
73  if (strstr(str, "Mod4") != NULL)
74  result |= XCB_KEY_BUT_MASK_MOD_4;
75  if (strstr(str, "Mod5") != NULL)
76  result |= XCB_KEY_BUT_MASK_MOD_5;
77  if (strstr(str, "Control") != NULL ||
78  strstr(str, "Ctrl") != NULL)
79  result |= XCB_KEY_BUT_MASK_CONTROL;
80  if (strstr(str, "Shift") != NULL)
81  result |= XCB_KEY_BUT_MASK_SHIFT;
82 
83  if (strstr(str, "Group1") != NULL)
84  result |= (I3_XKB_GROUP_MASK_1 << 16);
85  if (strstr(str, "Group2") != NULL ||
86  strstr(str, "Mode_switch") != NULL)
87  result |= (I3_XKB_GROUP_MASK_2 << 16);
88  if (strstr(str, "Group3") != NULL)
89  result |= (I3_XKB_GROUP_MASK_3 << 16);
90  if (strstr(str, "Group4") != NULL)
91  result |= (I3_XKB_GROUP_MASK_4 << 16);
92  return result;
93 }
94 
95 static char *font_pattern;
96 
97 CFGFUN(font, const char *font) {
98  config.font = load_font(font, true);
100 
101  /* Save the font pattern for using it as bar font later on */
103  font_pattern = sstrdup(font);
104 }
105 
106 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) {
107  configure_binding(bindtype, modifiers, key, release, border, whole_window, exclude_titlebar, command, DEFAULT_BINDING_MODE, false);
108 }
109 
110 /*******************************************************************************
111  * Mode handling
112  ******************************************************************************/
113 
114 static char *current_mode;
116 
117 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) {
118  configure_binding(bindtype, modifiers, key, release, border, whole_window, exclude_titlebar, command, current_mode, current_mode_pango_markup);
119 }
120 
121 CFGFUN(enter_mode, const char *pango_markup, const char *modename) {
122  if (strcmp(modename, DEFAULT_BINDING_MODE) == 0) {
123  ELOG("You cannot use the name %s for your mode\n", DEFAULT_BINDING_MODE);
124  return;
125  }
126 
127  struct Mode *mode;
128  SLIST_FOREACH (mode, &modes, modes) {
129  if (strcmp(mode->name, modename) == 0) {
130  ELOG("The binding mode with name \"%s\" is defined at least twice.\n", modename);
131  }
132  }
133 
134  DLOG("\t now in mode %s\n", modename);
136  current_mode = sstrdup(modename);
138 }
139 
140 CFGFUN(exec, const char *exectype, const char *no_startup_id, const char *command) {
141  struct Autostart *new = smalloc(sizeof(struct Autostart));
142  new->command = sstrdup(command);
143  new->no_startup_id = (no_startup_id != NULL);
144  if (strcmp(exectype, "exec") == 0) {
146  } else {
148  }
149 }
150 
151 CFGFUN(for_window, const char *command) {
153  ELOG("Match is empty, ignoring this for_window statement\n");
154  return;
155  }
156  DLOG("\t should execute command %s for the criteria mentioned above\n", command);
157  Assignment *assignment = scalloc(1, sizeof(Assignment));
158  assignment->type = A_COMMAND;
159  match_copy(&(assignment->match), current_match);
160  assignment->dest.command = sstrdup(command);
162 }
163 
164 CFGFUN(floating_minimum_size, const long width, const long height) {
167 }
168 
169 CFGFUN(floating_maximum_size, const long width, const long height) {
172 }
173 
174 CFGFUN(floating_modifier, const char *modifiers) {
176 }
177 
178 CFGFUN(default_orientation, const char *orientation) {
179  if (strcmp(orientation, "horizontal") == 0)
181  else if (strcmp(orientation, "vertical") == 0)
183  else
185 }
186 
187 CFGFUN(workspace_layout, const char *layout) {
188  if (strcmp(layout, "default") == 0)
190  else if (strcmp(layout, "stacking") == 0 ||
191  strcmp(layout, "stacked") == 0)
193  else
195 }
196 
197 CFGFUN(default_border, const char *windowtype, const char *border, const long width) {
198  int border_style;
199  int border_width;
200 
201  if (strcmp(border, "1pixel") == 0) {
202  border_style = BS_PIXEL;
203  border_width = 1;
204  } else if (strcmp(border, "none") == 0) {
205  border_style = BS_NONE;
206  border_width = 0;
207  } else if (strcmp(border, "pixel") == 0) {
208  border_style = BS_PIXEL;
209  border_width = width;
210  } else {
211  border_style = BS_NORMAL;
212  border_width = width;
213  }
214 
215  if ((strcmp(windowtype, "default_border") == 0) ||
216  (strcmp(windowtype, "new_window") == 0)) {
217  DLOG("default tiled border style = %d and border width = %d (%d physical px)\n",
218  border_style, border_width, logical_px(border_width));
219  config.default_border = border_style;
220  config.default_border_width = logical_px(border_width);
221  } else {
222  DLOG("default floating border style = %d and border width = %d (%d physical px)\n",
223  border_style, border_width, logical_px(border_width));
224  config.default_floating_border = border_style;
226  }
227 }
228 
229 CFGFUN(hide_edge_borders, const char *borders) {
230  if (strcmp(borders, "smart") == 0)
232  else if (strcmp(borders, "vertical") == 0)
234  else if (strcmp(borders, "horizontal") == 0)
236  else if (strcmp(borders, "both") == 0)
238  else if (strcmp(borders, "none") == 0)
240  else if (eval_boolstr(borders))
242  else
244 }
245 
246 CFGFUN(focus_follows_mouse, const char *value) {
248 }
249 
250 CFGFUN(mouse_warping, const char *value) {
251  if (strcmp(value, "none") == 0)
253  else if (strcmp(value, "output") == 0)
255 }
256 
257 CFGFUN(force_xinerama, const char *value) {
259 }
260 
261 CFGFUN(disable_randr15, const char *value) {
263 }
264 
265 CFGFUN(focus_wrapping, const char *value) {
266  if (strcmp(value, "force") == 0) {
268  } else if (strcmp(value, "workspace") == 0) {
270  } else if (eval_boolstr(value)) {
272  } else {
274  }
275 }
276 
277 CFGFUN(force_focus_wrapping, const char *value) {
278  /* Legacy syntax. */
279  if (eval_boolstr(value)) {
281  } else {
282  /* For "force_focus_wrapping off", don't enable or disable
283  * focus wrapping, just ensure it's not forced. */
286  }
287  }
288 }
289 
290 CFGFUN(workspace_back_and_forth, const char *value) {
292 }
293 
294 CFGFUN(fake_outputs, const char *outputs) {
295  free(config.fake_outputs);
297 }
298 
299 CFGFUN(force_display_urgency_hint, const long duration_ms) {
300  config.workspace_urgency_timer = duration_ms / 1000.0;
301 }
302 
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)
312  else {
313  ELOG("Unknown focus_on_window_activation mode \"%s\", ignoring it.\n", mode);
314  return;
315  }
316 
317  DLOG("Set new focus_on_window_activation mode = %i.\n", config.focus_on_window_activation);
318 }
319 
320 CFGFUN(title_align, const char *alignment) {
321  if (strcmp(alignment, "left") == 0) {
322  config.title_align = ALIGN_LEFT;
323  } else if (strcmp(alignment, "center") == 0) {
324  config.title_align = ALIGN_CENTER;
325  } else if (strcmp(alignment, "right") == 0) {
326  config.title_align = ALIGN_RIGHT;
327  } else {
328  assert(false);
329  }
330 }
331 
332 CFGFUN(show_marks, const char *value) {
333  config.show_marks = eval_boolstr(value);
334 }
335 
336 static char *current_workspace = NULL;
337 
338 CFGFUN(workspace, const char *workspace, const char *output) {
339  struct Workspace_Assignment *assignment;
340 
341  /* When a new workspace line is encountered, for the first output word,
342  * $workspace from the config.spec is non-NULL. Afterwards, the parser calls
343  * clear_stack() because of the call line. Thus, we have to preserve the
344  * workspace string. */
345  if (workspace) {
347 
349  if (strcasecmp(assignment->name, workspace) == 0) {
350  ELOG("You have a duplicate workspace assignment for workspace \"%s\"\n",
351  workspace);
352  return;
353  }
354  }
355 
356  current_workspace = sstrdup(workspace);
357  } else {
358  if (!current_workspace) {
359  DLOG("Both workspace and current_workspace are NULL, assuming we had an error before\n");
360  return;
361  }
362  workspace = current_workspace;
363  }
364 
365  DLOG("Assigning workspace \"%s\" to output \"%s\"\n", workspace, output);
366 
367  assignment = scalloc(1, sizeof(struct Workspace_Assignment));
368  assignment->name = sstrdup(workspace);
369  assignment->output = sstrdup(output);
371 }
372 
373 CFGFUN(ipc_socket, const char *path) {
374  free(config.ipc_socket_path);
376 }
377 
378 CFGFUN(restart_state, const char *path) {
381 }
382 
383 CFGFUN(popup_during_fullscreen, const char *value) {
384  if (strcmp(value, "ignore") == 0) {
385  config.popup_during_fullscreen = PDF_IGNORE;
386  } else if (strcmp(value, "leave_fullscreen") == 0) {
387  config.popup_during_fullscreen = PDF_LEAVE_FULLSCREEN;
388  } else {
389  config.popup_during_fullscreen = PDF_SMART;
390  }
391 }
392 
393 CFGFUN(color_single, const char *colorclass, const char *color) {
394  /* used for client.background only currently */
396 }
397 
398 CFGFUN(color, const char *colorclass, const char *border, const char *background, const char *text, const char *indicator, const char *child_border) {
399 #define APPLY_COLORS(classname) \
400  do { \
401  if (strcmp(colorclass, "client." #classname) == 0) { \
402  config.client.classname.border = draw_util_hex_to_color(border); \
403  config.client.classname.background = draw_util_hex_to_color(background); \
404  config.client.classname.text = draw_util_hex_to_color(text); \
405  if (indicator != NULL) { \
406  config.client.classname.indicator = draw_util_hex_to_color(indicator); \
407  } \
408  if (child_border != NULL) { \
409  config.client.classname.child_border = draw_util_hex_to_color(child_border); \
410  } else { \
411  config.client.classname.child_border = config.client.classname.background; \
412  } \
413  } \
414  } while (0)
415 
416  APPLY_COLORS(focused_inactive);
418  APPLY_COLORS(unfocused);
419  APPLY_COLORS(urgent);
420  APPLY_COLORS(placeholder);
421 
422 #undef APPLY_COLORS
423 }
424 
425 CFGFUN(assign_output, const char *output) {
427  ELOG("Match is empty, ignoring this assignment\n");
428  return;
429  }
430 
431  if (current_match->window_mode != WM_ANY) {
432  ELOG("Assignments using window mode (floating/tiling) is not supported\n");
433  return;
434  }
435 
436  DLOG("New assignment, using above criteria, to output \"%s\".\n", output);
437  Assignment *assignment = scalloc(1, sizeof(Assignment));
438  match_copy(&(assignment->match), current_match);
439  assignment->type = A_TO_OUTPUT;
440  assignment->dest.output = sstrdup(output);
442 }
443 
444 CFGFUN(assign, const char *workspace, bool is_number) {
446  ELOG("Match is empty, ignoring this assignment\n");
447  return;
448  }
449 
450  if (current_match->window_mode != WM_ANY) {
451  ELOG("Assignments using window mode (floating/tiling) is not supported\n");
452  return;
453  }
454 
455  if (is_number && ws_name_to_number(workspace) == -1) {
456  ELOG("Could not parse initial part of \"%s\" as a number.\n", workspace);
457  return;
458  }
459 
460  DLOG("New assignment, using above criteria, to workspace \"%s\".\n", workspace);
461  Assignment *assignment = scalloc(1, sizeof(Assignment));
462  match_copy(&(assignment->match), current_match);
463  assignment->type = is_number ? A_TO_WORKSPACE_NUMBER : A_TO_WORKSPACE;
464  assignment->dest.workspace = sstrdup(workspace);
466 }
467 
468 CFGFUN(no_focus) {
470  ELOG("Match is empty, ignoring this assignment\n");
471  return;
472  }
473 
474  DLOG("New assignment, using above criteria, to ignore focus on manage.\n");
475  Assignment *assignment = scalloc(1, sizeof(Assignment));
476  match_copy(&(assignment->match), current_match);
477  assignment->type = A_NO_FOCUS;
479 }
480 
481 CFGFUN(ipc_kill_timeout, const long timeout_ms) {
482  ipc_set_kill_timeout(timeout_ms / 1000.0);
483 }
484 
485 /*******************************************************************************
486  * Bar configuration (i3bar)
487  ******************************************************************************/
488 
490 
491 CFGFUN(bar_font, const char *font) {
493  current_bar->font = sstrdup(font);
494 }
495 
496 CFGFUN(bar_separator_symbol, const char *separator) {
498  current_bar->separator_symbol = sstrdup(separator);
499 }
500 
501 CFGFUN(bar_mode, const char *mode) {
502  current_bar->mode = (strcmp(mode, "dock") == 0 ? M_DOCK : (strcmp(mode, "hide") == 0 ? M_HIDE : M_INVISIBLE));
503 }
504 
505 CFGFUN(bar_hidden_state, const char *hidden_state) {
506  current_bar->hidden_state = (strcmp(hidden_state, "hide") == 0 ? S_HIDE : S_SHOW);
507 }
508 
509 CFGFUN(bar_id, const char *bar_id) {
510  current_bar->id = sstrdup(bar_id);
511 }
512 
513 CFGFUN(bar_output, const char *output) {
514  int new_outputs = current_bar->num_outputs + 1;
515  current_bar->outputs = srealloc(current_bar->outputs, sizeof(char *) * new_outputs);
517  current_bar->num_outputs = new_outputs;
518 }
519 
520 CFGFUN(bar_verbose, const char *verbose) {
522 }
523 
524 CFGFUN(bar_modifier, const char *modifiers) {
525  current_bar->modifier = modifiers ? event_state_from_str(modifiers) : XCB_NONE;
526 }
527 
528 static void bar_configure_binding(const char *button, const char *release, const char *command) {
529  if (strncasecmp(button, "button", strlen("button")) != 0) {
530  ELOG("Bindings for a bar can only be mouse bindings, not \"%s\", ignoring.\n", button);
531  return;
532  }
533 
534  int input_code = atoi(button + strlen("button"));
535  if (input_code < 1) {
536  ELOG("Button \"%s\" does not seem to be in format 'buttonX'.\n", button);
537  return;
538  }
539  const bool release_bool = release != NULL;
540 
541  struct Barbinding *current;
542  TAILQ_FOREACH (current, &(current_bar->bar_bindings), bindings) {
543  if (current->input_code == input_code && current->release == release_bool) {
544  ELOG("command for button %s was already specified, ignoring.\n", button);
545  return;
546  }
547  }
548 
549  struct Barbinding *new_binding = scalloc(1, sizeof(struct Barbinding));
550  new_binding->release = release_bool;
551  new_binding->input_code = input_code;
552  new_binding->command = sstrdup(command);
553  TAILQ_INSERT_TAIL(&(current_bar->bar_bindings), new_binding, bindings);
554 }
555 
556 CFGFUN(bar_wheel_up_cmd, const char *command) {
557  ELOG("'wheel_up_cmd' is deprecated. Please us 'bindsym button4 %s' instead.\n", command);
558  bar_configure_binding("button4", NULL, command);
559 }
560 
561 CFGFUN(bar_wheel_down_cmd, const char *command) {
562  ELOG("'wheel_down_cmd' is deprecated. Please us 'bindsym button5 %s' instead.\n", command);
563  bar_configure_binding("button5", NULL, command);
564 }
565 
566 CFGFUN(bar_bindsym, const char *button, const char *release, const char *command) {
568 }
569 
570 CFGFUN(bar_position, const char *position) {
571  current_bar->position = (strcmp(position, "top") == 0 ? P_TOP : P_BOTTOM);
572 }
573 
574 CFGFUN(bar_i3bar_command, const char *i3bar_command) {
576  current_bar->i3bar_command = sstrdup(i3bar_command);
577 }
578 
579 CFGFUN(bar_color, const char *colorclass, const char *border, const char *background, const char *text) {
580 #define APPLY_COLORS(classname) \
581  do { \
582  if (strcmp(colorclass, #classname) == 0) { \
583  if (text != NULL) { \
584  /* New syntax: border, background, text */ \
585  current_bar->colors.classname##_border = sstrdup(border); \
586  current_bar->colors.classname##_bg = sstrdup(background); \
587  current_bar->colors.classname##_text = sstrdup(text); \
588  } else { \
589  /* Old syntax: text, background */ \
590  current_bar->colors.classname##_bg = sstrdup(background); \
591  current_bar->colors.classname##_text = sstrdup(border); \
592  } \
593  } \
594  } while (0)
595 
596  APPLY_COLORS(focused_workspace);
597  APPLY_COLORS(active_workspace);
598  APPLY_COLORS(inactive_workspace);
599  APPLY_COLORS(urgent_workspace);
600  APPLY_COLORS(binding_mode);
601 
602 #undef APPLY_COLORS
603 }
604 
605 CFGFUN(bar_socket_path, const char *socket_path) {
607  current_bar->socket_path = sstrdup(socket_path);
608 }
609 
610 CFGFUN(bar_tray_output, const char *output) {
611  struct tray_output_t *tray_output = scalloc(1, sizeof(struct tray_output_t));
612  tray_output->output = sstrdup(output);
613  TAILQ_INSERT_TAIL(&(current_bar->tray_outputs), tray_output, tray_outputs);
614 }
615 
616 CFGFUN(bar_tray_padding, const long padding_px) {
617  current_bar->tray_padding = padding_px;
618 }
619 
620 CFGFUN(bar_color_single, const char *colorclass, const char *color) {
621  if (strcmp(colorclass, "background") == 0)
623  else if (strcmp(colorclass, "separator") == 0)
625  else if (strcmp(colorclass, "statusline") == 0)
627  else if (strcmp(colorclass, "focused_background") == 0)
629  else if (strcmp(colorclass, "focused_separator") == 0)
631  else
633 }
634 
635 CFGFUN(bar_status_command, const char *command) {
637  current_bar->status_command = sstrdup(command);
638 }
639 
640 CFGFUN(bar_binding_mode_indicator, const char *value) {
642 }
643 
644 CFGFUN(bar_workspace_buttons, const char *value) {
646 }
647 
648 CFGFUN(bar_workspace_min_width, const long width) {
650 }
651 
652 CFGFUN(bar_strip_workspace_numbers, const char *value) {
654 }
655 
656 CFGFUN(bar_strip_workspace_name, const char *value) {
658 }
659 
660 CFGFUN(bar_start) {
661  current_bar = scalloc(1, sizeof(struct Barconfig));
662  TAILQ_INIT(&(current_bar->bar_bindings));
663  TAILQ_INIT(&(current_bar->tray_outputs));
665  current_bar->modifier = XCB_KEY_BUT_MASK_MOD_4;
666 }
667 
668 CFGFUN(bar_finish) {
669  DLOG("\t new bar configuration finished, saving.\n");
670  /* Generate a unique ID for this bar if not already configured */
671  if (current_bar->id == NULL)
673 
675 
676  /* If no font was explicitly set, we use the i3 font as default */
677  if (current_bar->font == NULL && font_pattern != NULL)
679 
681  /* Simply reset the pointer, but don't free the resources. */
682  current_bar = NULL;
683 }
const char * DEFAULT_BINDING_MODE
The name of the default mode.
Definition: bindings.c:25
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
static Match current_match
Config config
Definition: config.c:17
struct barconfig_head barconfigs
Definition: config.c:19
struct modes_head modes
Definition: config.c:18
CFGFUN(criteria_init, int _state)
static char * font_pattern
static bool current_mode_pango_markup
static void bar_configure_binding(const char *button, const char *release, const char *command)
static char * current_workspace
static int criteria_next_state
static Barconfig * current_bar
#define APPLY_COLORS(classname)
static char * current_mode
static bool eval_boolstr(const char *str)
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...
void ipc_set_kill_timeout(ev_tstamp new)
Set the maximum duration that we allow for a connection with an unwriteable socket.
Definition: ipc.c:51
static bool verbose
Definition: log.c:35
bool force_xinerama
Definition: main.c:101
struct autostarts_always_head autostarts_always
Definition: main.c:88
struct autostarts_head autostarts
Definition: main.c:85
struct assignments_head assignments
Definition: main.c:91
struct ws_assignments_head ws_assignments
Definition: main.c:95
struct bindings_head * bindings
Definition: main.c:81
bool match_is_empty(Match *match)
Check if a match is empty.
Definition: match.c:39
void match_init(Match *match)
Initializes the Match data structure.
Definition: match.c:26
void match_copy(Match *dest, Match *src)
Copies the data of a match from src to dest.
Definition: match.c:62
void match_free(Match *match)
Frees the given match.
Definition: match.c:267
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:282
struct outputs_head outputs
Definition: randr.c:22
struct Con * focused
Definition: tree.c:13
int ws_name_to_number(const char *name)
Parses the workspace name as a number.
Definition: util.c:109
void workspace_back_and_forth(void)
Focuses the previously focused workspace.
Definition: workspace.c:798
@ HEBM_VERTICAL
Definition: data.h:79
@ HEBM_HORIZONTAL
Definition: data.h:80
@ HEBM_BOTH
Definition: data.h:81
@ HEBM_SMART
Definition: data.h:82
@ HEBM_NONE
Definition: data.h:78
@ I3_XKB_GROUP_MASK_2
Definition: data.h:114
@ I3_XKB_GROUP_MASK_3
Definition: data.h:115
@ I3_XKB_GROUP_MASK_4
Definition: data.h:116
@ I3_XKB_GROUP_MASK_1
Definition: data.h:113
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:125
@ POINTER_WARPING_OUTPUT
Definition: data.h:131
@ POINTER_WARPING_NONE
Definition: data.h:132
@ L_STACKED
Definition: data.h:92
@ L_TABBED
Definition: data.h:93
@ L_DEFAULT
Definition: data.h:91
@ FOCUS_WRAPPING_OFF
Definition: data.h:139
@ FOCUS_WRAPPING_ON
Definition: data.h:140
@ FOCUS_WRAPPING_FORCE
Definition: data.h:141
@ FOCUS_WRAPPING_WORKSPACE
Definition: data.h:142
@ VERT
Definition: data.h:58
@ HORIZ
Definition: data.h:57
@ NO_ORIENTATION
Definition: data.h:56
@ BS_NONE
Definition: data.h:62
@ BS_PIXEL
Definition: data.h:63
@ BS_NORMAL
Definition: data.h:61
char * sstrdup(const char *str)
Safe-wrapper around strdup which exits if malloc returns NULL (meaning that there is no more memory a...
int logical_px(const int logical)
Convert a logical amount of pixels (e.g.
#define DLOG(fmt,...)
Definition: libi3.h:104
void * smalloc(size_t size)
Safe-wrapper around malloc which exits if malloc returns NULL (meaning that there is no more memory a...
#define ELOG(fmt,...)
Definition: libi3.h:99
color_t draw_util_hex_to_color(const char *color)
Parses the given color in hex format to an internal color representation.
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...
void * srealloc(void *ptr, size_t size)
Safe-wrapper around realloc which exits if realloc returns NULL (meaning that there is no more memory...
void set_font(i3Font *font)
Defines the font to be used for the forthcoming calls.
i3Font load_font(const char *pattern, const bool fallback)
Loads a font for usage, also getting its height.
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...
#define SLIST_FOREACH(var, head, field)
Definition: queue.h:114
#define TAILQ_FOREACH(var, head, field)
Definition: queue.h:347
#define TAILQ_INIT(head)
Definition: queue.h:360
#define TAILQ_INSERT_TAIL(head, elm, field)
Definition: queue.h:376
#define FREE(pointer)
Definition: util.h:47
The configuration file can contain multiple sets of bindings.
Definition: configuration.h:78
char * name
Definition: configuration.h:79
bool pango_markup
Definition: configuration.h:80
focus_wrapping_t focus_wrapping
When focus wrapping is enabled (the default), attempting to move focus past the edge of the screen (i...
char * restart_state_path
Definition: configuration.h:96
bool workspace_auto_back_and_forth
Automatic workspace back and forth switching.
int32_t floating_minimum_width
enum Config::@7 title_align
Title alignment options.
int default_border_width
i3Font font
Definition: configuration.h:93
hide_edge_borders_mode_t hide_edge_borders
Remove borders if they are adjacent to the screen edge.
int32_t floating_minimum_height
bool disable_focus_follows_mouse
By default, focus follows mouse.
struct Config::config_client client
warping_t mouse_warping
By default, when switching focus to a window on a different output (e.g.
char * fake_outputs
Overwrites output detection (for testing), see src/fake_outputs.c.
int default_floating_border_width
int default_orientation
Default orientation for new containers.
uint32_t floating_modifier
The modifier which needs to be pressed in combination with your mouse buttons to do things with float...
char * ipc_socket_path
Definition: configuration.h:95
bool show_marks
Specifies whether or not marks should be displayed in the window decoration.
float workspace_urgency_timer
By default, urgency is cleared immediately when switching to another workspace leads to focusing the ...
bool disable_randr15
Don’t use RandR 1.5 for querying outputs.
int32_t floating_maximum_width
Maximum and minimum dimensions of a floating window.
enum Config::@6 focus_on_window_activation
Behavior when a window sends a NET_ACTIVE_WINDOW message.
bool force_xinerama
By default, use the RandR API for multi-monitor setups.
int32_t floating_maximum_height
border_style_t default_border
The default border style for new windows.
layout_t default_layout
Definition: configuration.h:98
border_style_t default_floating_border
The default border style for new floating windows.
enum Config::@8 popup_during_fullscreen
What should happen when a new popup is opened during fullscreen mode.
int number_barconfigs
Holds the status bar configuration (i3bar).
bool hide_workspace_buttons
Hide workspace buttons? Configuration option is 'workspace_buttons no' but we invert the bool to get ...
char * separator_symbol
A custom separator to use instead of a vertical line.
enum Barconfig::@11 position
Bar position (bottom by default).
int workspace_min_width
The minimal width for workspace buttons.
struct Barconfig::bar_colors colors
uint32_t modifier
Bar modifier (to show bar when in hide mode).
char * i3bar_command
Command that should be run to execute i3bar, give a full path if i3bar is not in your $PATH.
int num_outputs
Number of outputs in the outputs array.
char * font
Font specification for all text rendered on the bar.
enum Barconfig::@10 hidden_state
char * id
Automatically generated ID for this bar config.
enum Barconfig::@9 mode
Bar display mode (hide unless modifier is pressed or show in dock mode or always hide in invisible mo...
bool hide_binding_mode_indicator
Hide mode button? Configuration option is 'binding_mode_indicator no' but we invert the bool for the ...
char * status_command
Command that should be run to get a statusline, for example 'i3status'.
bool strip_workspace_numbers
Strip workspace numbers? Configuration option is 'strip_workspace_numbers yes'.
bool strip_workspace_name
Strip workspace name? Configuration option is 'strip_workspace_name yes'.
int tray_padding
char ** outputs
Outputs on which this bar should show up on.
char * socket_path
Path to the i3 IPC socket.
bool verbose
Enable verbose mode? Useful for debugging purposes.
Defines a mouse command to be executed instead of the default behavior when clicking on the non-statu...
bool release
If true, the command will be executed after the button is released.
int input_code
The button to be used (e.g., 1 for "button1").
char * command
The command which is to be executed for this button.
Stores which workspace (by name or number) goes to which output.
Definition: data.h:205
Holds a command specified by either an:
Definition: data.h:338
bool no_startup_id
no_startup_id flag for start_application().
Definition: data.h:343
char * command
Command, like in command mode.
Definition: data.h:340
enum Match::@16 window_mode
An Assignment makes specific windows go to a specific workspace/output or run a command for that wind...
Definition: data.h:555
Match match
the criteria to check if a window matches
Definition: data.h:577
char * output
Definition: data.h:583
union Assignment::@19 dest
destination workspace/command/output, depending on the type
char * command
Definition: data.h:581
char * workspace
Definition: data.h:582
enum Assignment::@18 type
type of this assignment: