18CFGFUN(include,
const char *pattern) {
19 DLOG(
"include %s\n", pattern);
22 const int ret = wordexp(pattern, &p, 0);
24 ELOG(
"wordexp(%s): error %d\n", pattern, ret);
25 result->has_errors =
true;
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));
39 if (strcmp(file->
path, resolved_path) == 0) {
45 LOG(
"Skipping file %s (already included)\n", resolved_path);
49 LOG(
"Including config file %s\n", resolved_path);
58 .use_nagbar = result->ctx->use_nagbar,
60 .variables = result->ctx->variables,
67 ELOG(
"including config file %s: %s\n", resolved_path, strerror(errno));
71 result->has_errors =
true;
102 DLOG(
"Initializing criteria, current_match = %p, state = %d\n",
current_match, _state);
116CFGFUN(criteria_add,
const char *ctype,
const char *cvalue) {
135 if (strstr(str,
"Mod1") != NULL) {
136 result |= XCB_KEY_BUT_MASK_MOD_1;
138 if (strstr(str,
"Mod2") != NULL) {
139 result |= XCB_KEY_BUT_MASK_MOD_2;
141 if (strstr(str,
"Mod3") != NULL) {
142 result |= XCB_KEY_BUT_MASK_MOD_3;
144 if (strstr(str,
"Mod4") != NULL) {
145 result |= XCB_KEY_BUT_MASK_MOD_4;
147 if (strstr(str,
"Mod5") != NULL) {
148 result |= XCB_KEY_BUT_MASK_MOD_5;
150 if (strstr(str,
"Control") != NULL ||
151 strstr(str,
"Ctrl") != NULL) {
152 result |= XCB_KEY_BUT_MASK_CONTROL;
154 if (strstr(str,
"Shift") != NULL) {
155 result |= XCB_KEY_BUT_MASK_SHIFT;
158 if (strstr(str,
"Group1") != NULL) {
161 if (strstr(str,
"Group2") != NULL ||
162 strstr(str,
"Mode_switch") != NULL) {
165 if (strstr(str,
"Group3") != NULL) {
168 if (strstr(str,
"Group4") != NULL) {
179CFGFUN(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) {
190CFGFUN(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) {
199CFGFUN(enter_mode,
const char *pango_markup,
const char *modename) {
207 if (strcmp(mode->
name, modename) == 0) {
208 ELOG(
"The binding mode with name \"%s\" is defined at least twice.\n", modename);
212 DLOG(
"\t now in mode %s\n", modename);
218CFGFUN(exec,
const char *exectype,
const char *no_startup_id,
const char *command) {
222 if (strcmp(exectype,
"exec") == 0) {
235 ELOG(
"Match is empty, ignoring this for_window statement\n");
238 DLOG(
"\t should execute command %s for the criteria mentioned above\n",
command);
240 assignment->
type = A_COMMAND;
272 DLOG(
"Setting gaps for workspace %s", workspace);
277 if (strcasecmp(assignment->
name, workspace) == 0) {
287 assignment->
output = NULL;
296 if (!strcmp(scope,
"inner")) {
298 }
else if (!strcmp(scope,
"outer")) {
300 }
else if (!strcmp(scope,
"vertical")) {
302 }
else if (!strcmp(scope,
"horizontal")) {
304 }
else if (!strcmp(scope,
"top")) {
306 }
else if (!strcmp(scope,
"right")) {
308 }
else if (!strcmp(scope,
"bottom")) {
310 }
else if (!strcmp(scope,
"left")) {
313 ELOG(
"Invalid command, cannot process scope %s", scope);
317CFGFUN(
gaps,
const char *workspace,
const char *scope,
const long value) {
321 if (workspace == NULL) {
328CFGFUN(smart_borders,
const char *enable) {
329 if (!strcmp(enable,
"no_gaps")) {
336 ELOG(
"Both hide_edge_borders and smart_borders was used. "
337 "Ignoring smart_borders as it is deprecated.\n");
343 if (!strcmp(enable,
"inverse_outer")) {
350CFGFUN(floating_minimum_size,
const long width,
const long height) {
355CFGFUN(floating_maximum_size,
const long width,
const long height) {
360CFGFUN(floating_modifier,
const char *modifiers) {
364CFGFUN(tiling_drag_swap_modifier,
const char *modifiers) {
368CFGFUN(default_orientation,
const char *orientation) {
369 if (strcmp(orientation,
"horizontal") == 0) {
371 }
else if (strcmp(orientation,
"vertical") == 0) {
378CFGFUN(workspace_layout,
const char *layout) {
379 if (strcmp(layout,
"default") == 0) {
381 }
else if (strcmp(layout,
"stacking") == 0 ||
382 strcmp(layout,
"stacked") == 0) {
389CFGFUN(default_border,
const char *windowtype,
const char *border,
const long width) {
393 if (strcmp(border,
"1pixel") == 0) {
396 }
else if (strcmp(border,
"none") == 0) {
399 }
else if (strcmp(border,
"pixel") == 0) {
401 border_width = width;
404 border_width = width;
407 if ((strcmp(windowtype,
"default_border") == 0) ||
408 (strcmp(windowtype,
"new_window") == 0)) {
409 DLOG(
"default tiled border style = %d and border width = %d (%d physical px)\n",
410 border_style, border_width,
logical_px(border_width));
414 DLOG(
"default floating border style = %d and border width = %d (%d physical px)\n",
415 border_style, border_width,
logical_px(border_width));
421CFGFUN(hide_edge_borders,
const char *borders) {
422 if (strcmp(borders,
"smart_no_gaps") == 0) {
424 }
else if (strcmp(borders,
"smart") == 0) {
426 }
else if (strcmp(borders,
"vertical") == 0) {
428 }
else if (strcmp(borders,
"horizontal") == 0) {
430 }
else if (strcmp(borders,
"both") == 0) {
432 }
else if (strcmp(borders,
"none") == 0) {
441CFGFUN(focus_follows_mouse,
const char *value) {
445CFGFUN(mouse_warping,
const char *value) {
446 if (strcmp(value,
"none") == 0) {
448 }
else if (strcmp(value,
"output") == 0) {
457CFGFUN(disable_randr15,
const char *value) {
461CFGFUN(focus_wrapping,
const char *value) {
462 if (strcmp(value,
"force") == 0) {
464 }
else if (strcmp(value,
"workspace") == 0) {
473CFGFUN(force_focus_wrapping,
const char *value) {
495CFGFUN(force_display_urgency_hint,
const long duration_ms) {
499CFGFUN(focus_on_window_activation,
const char *mode) {
500 if (strcmp(mode,
"smart") == 0) {
502 }
else if (strcmp(mode,
"urgent") == 0) {
504 }
else if (strcmp(mode,
"focus") == 0) {
506 }
else if (strcmp(mode,
"none") == 0) {
509 ELOG(
"Unknown focus_on_window_activation mode \"%s\", ignoring it.\n", mode);
516CFGFUN(title_align,
const char *alignment) {
517 if (strcmp(alignment,
"left") == 0) {
519 }
else if (strcmp(alignment,
"center") == 0) {
521 }
else if (strcmp(alignment,
"right") == 0) {
545 if (strcasecmp(assignment->
name, workspace) == 0) {
546 if (assignment->
output != NULL) {
547 ELOG(
"You have a duplicate workspace assignment for workspace \"%s\"\n",
557 DLOG(
"Both workspace and current_workspace are NULL, assuming we had an error before\n");
563 DLOG(
"Assigning workspace \"%s\" to output \"%s\"\n", workspace,
output);
581CFGFUN(popup_during_fullscreen,
const char *value) {
582 if (strcmp(value,
"ignore") == 0) {
584 }
else if (strcmp(value,
"leave_fullscreen") == 0) {
586 }
else if (strcmp(value,
"all") == 0) {
593CFGFUN(color_single,
const char *colorclass,
const char *color) {
598CFGFUN(color,
const char *colorclass,
const char *border,
const char *background,
const char *text,
const char *indicator,
const char *child_border) {
599#define APPLY_COLORS(classname) \
601 if (strcmp(colorclass, "client." #classname) == 0) { \
602 if (strcmp("focused_tab_title", #classname) == 0) { \
603 config.client.got_focused_tab_title = true; \
604 if (indicator || child_border) { \
605 ELOG("indicator and child_border colors have no effect for client.focused_tab_title\n"); \
608 config.client.classname.border = draw_util_hex_to_color(border); \
609 config.client.classname.background = draw_util_hex_to_color(background); \
610 config.client.classname.text = draw_util_hex_to_color(text); \
611 if (indicator != NULL) { \
612 config.client.classname.indicator = draw_util_hex_to_color(indicator); \
614 if (child_border != NULL) { \
615 config.client.classname.child_border = draw_util_hex_to_color(child_border); \
617 config.client.classname.child_border = config.client.classname.background; \
639 ELOG(
"Match is empty, ignoring this assignment\n");
644 ELOG(
"Assignments using window mode (floating/tiling) is not supported\n");
648 DLOG(
"New assignment, using above criteria, to output \"%s\".\n",
output);
651 assignment->
type = A_TO_OUTPUT;
656CFGFUN(assign,
const char *workspace,
bool is_number) {
662 ELOG(
"Match is empty, ignoring this assignment\n");
667 ELOG(
"Assignments using window mode (floating/tiling) is not supported\n");
672 ELOG(
"Could not parse initial part of \"%s\" as a number.\n", workspace);
676 DLOG(
"New assignment, using above criteria, to workspace \"%s\".\n", workspace);
679 assignment->
type = is_number ? A_TO_WORKSPACE_NUMBER : A_TO_WORKSPACE;
690 ELOG(
"Match is empty, ignoring this assignment\n");
694 DLOG(
"New assignment, using above criteria, to ignore focus on manage.\n");
697 assignment->
type = A_NO_FOCUS;
701CFGFUN(ipc_kill_timeout,
const long timeout_ms) {
706 if (strcmp(value,
"modifier") == 0) {
708 }
else if (strcmp(value,
"titlebar") == 0) {
710 }
else if (strcmp(value,
"modifier,titlebar") == 0 ||
711 strcmp(value,
"titlebar,modifier") == 0) {
730CFGFUN(bar_separator_symbol,
const char *separator) {
736 current_bar->
mode = (strcmp(mode,
"dock") == 0 ? M_DOCK : (strcmp(mode,
"hide") == 0 ? M_HIDE : M_INVISIBLE));
739CFGFUN(bar_hidden_state,
const char *hidden_state) {
763 DLOG(
"padding now: x=%d, y=%d, w=%d, h=%d\n",
778CFGFUN(bar_padding_two,
const long top_and_bottom,
const long right_and_left) {
786CFGFUN(bar_padding_three,
const long top,
const long right_and_left,
const long bottom) {
794CFGFUN(bar_padding_four,
const long top,
const long right,
const long bottom,
const long left) {
802CFGFUN(bar_modifier,
const char *modifiers) {
807 if (strncasecmp(button,
"button", strlen(
"button")) != 0) {
808 ELOG(
"Bindings for a bar can only be mouse bindings, not \"%s\", ignoring.\n", button);
812 int input_code = atoi(button + strlen(
"button"));
813 if (input_code < 1) {
814 ELOG(
"Button \"%s\" does not seem to be in format 'buttonX'.\n", button);
817 const bool release_bool = release != NULL;
822 ELOG(
"command for button %s was already specified, ignoring.\n", button);
828 new_binding->
release = release_bool;
835 ELOG(
"'wheel_up_cmd' is deprecated. Please use 'bindsym button4 %s' instead.\n",
command);
840 ELOG(
"'wheel_down_cmd' is deprecated. Please use 'bindsym button5 %s' instead.\n",
command);
848CFGFUN(bar_position,
const char *position) {
852CFGFUN(bar_i3bar_command,
const char *i3bar_command) {
857CFGFUN(bar_color,
const char *colorclass,
const char *border,
const char *background,
const char *text) {
858#define APPLY_COLORS(classname) \
860 if (strcmp(colorclass, #classname) == 0) { \
861 if (text != NULL) { \
863 current_bar->colors.classname##_border = sstrdup(border); \
864 current_bar->colors.classname##_bg = sstrdup(background); \
865 current_bar->colors.classname##_text = sstrdup(text); \
868 current_bar->colors.classname##_bg = sstrdup(background); \
869 current_bar->colors.classname##_text = sstrdup(border); \
883CFGFUN(bar_socket_path,
const char *socket_path) {
888CFGFUN(bar_tray_output,
const char *output) {
894CFGFUN(bar_tray_padding,
const long padding_px) {
898CFGFUN(bar_color_single,
const char *colorclass,
const char *color) {
899 if (strcmp(colorclass,
"background") == 0) {
901 }
else if (strcmp(colorclass,
"separator") == 0) {
903 }
else if (strcmp(colorclass,
"statusline") == 0) {
905 }
else if (strcmp(colorclass,
"focused_background") == 0) {
907 }
else if (strcmp(colorclass,
"focused_separator") == 0) {
914CFGFUN(bar_status_command,
const char *command) {
919CFGFUN(bar_workspace_command,
const char *command) {
924CFGFUN(bar_binding_mode_indicator,
const char *value) {
928CFGFUN(bar_workspace_buttons,
const char *value) {
932CFGFUN(bar_workspace_min_width,
const long width) {
936CFGFUN(bar_strip_workspace_numbers,
const char *value) {
940CFGFUN(bar_strip_workspace_name,
const char *value) {
953 DLOG(
"\t new bar configuration finished, saving.\n");
const char * DEFAULT_BINDING_MODE
The name of the default mode.
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...
static struct stack stack
static Match current_match
struct includedfiles_head included_files
struct barconfig_head barconfigs
static void apply_gaps(gaps_t *gaps, gaps_mask_t mask, int value)
static bool current_mode_pango_markup
static void bar_configure_binding(const char *button, const char *release, const char *command)
static void create_gaps_assignment(const char *workspace, const gaps_mask_t mask, const int pixels)
static char * current_workspace
static void dlog_padding(void)
static int criteria_next_state
static Barconfig * current_bar
#define APPLY_COLORS(classname)
static char * current_mode
static gaps_mask_t gaps_scope_to_mask(const char *scope)
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...
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...
bool match_is_empty(Match *match)
Check if a match is empty.
void match_init(Match *match)
Initializes the Match data structure.
void match_copy(Match *dest, Match *src)
Copies the data of a match from src to dest.
void match_free(Match *match)
Frees the given match.
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.
struct outputs_head outputs
void tiling_drag(Con *con, xcb_button_press_event_t *event, bool use_threshold)
Initiates a mouse drag operation on a tiled window.
int ws_name_to_number(const char *name)
Parses the workspace name as a number.
void workspace_back_and_forth(void)
Focuses the previously focused workspace.
static xcb_cursor_context_t * ctx
struct autostarts_always_head autostarts_always
struct autostarts_head autostarts
struct assignments_head assignments
struct ws_assignments_head ws_assignments
struct bindings_head * bindings
@ PARSE_FILE_CONFIG_ERRORS
@ SMART_GAPS_INVERSE_OUTER
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.
@ FOCUS_WRAPPING_WORKSPACE
int logical_px(const int logical)
Convert a logical amount of pixels (e.g.
char * sstrdup(const char *str)
Safe-wrapper around strdup which exits if malloc returns NULL (meaning that there is no more memory a...
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...
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...
bool boolstr(const char *str)
Reports whether str represents the enabled state (1, yes, true, …).
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 * smalloc(size_t size)
Safe-wrapper around malloc which exits if malloc returns NULL (meaning that there is no more memory a...
#define SLIST_FOREACH(var, head, field)
#define TAILQ_FOREACH(var, head, field)
#define TAILQ_INSERT_TAIL(head, elm, field)
#define TAILQ_REMOVE(head, elm, field)
@ TILING_DRAG_MODIFIER_OR_TITLEBAR
void ipc_set_kill_timeout(ev_tstamp new)
Set the maximum duration that we allow for a connection with an unwriteable socket.
List entry struct for an included file.
char * variable_replaced_contents
The configuration file can contain multiple sets of bindings.
enum Config::@6 popup_during_fullscreen
What should happen when a new popup is opened during fullscreen mode.
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
bool workspace_auto_back_and_forth
Automatic workspace back and forth switching.
tiling_drag_t tiling_drag
int32_t floating_minimum_width
uint32_t swap_modifier
The modifier which needs to be pressed in combination with the floating modifier and your mouse butto...
enum Config::@5 title_align
Title alignment options.
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...
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.
enum Config::@4 focus_on_window_activation
Behavior when a window sends a NET_ACTIVE_WINDOW message.
int32_t floating_maximum_width
Maximum and minimum dimensions of a floating window.
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.
border_style_t default_floating_border
The default border style for new floating windows.
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.
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).
uint32_t bar_height
Defines the height of the bar in pixels.
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.
enum Barconfig::@8 hidden_state
char * font
Font specification for all text rendered on the bar.
char * id
Automatically generated ID for this bar config.
enum Barconfig::@7 mode
Bar display mode (hide unless modifier is pressed or show in dock mode or always hide in invisible mo...
char * workspace_command
Command that should be run to get the workspace buttons.
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'.
char ** outputs
Outputs on which this bar should show up on.
enum Barconfig::@9 position
Bar position (bottom by default).
char * socket_path
Path to the i3 IPC socket.
bool verbose
Enable verbose mode? Useful for debugging purposes.
char * focused_background
char * focused_statusline
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 and its gaps config.
Holds a command specified by either an:
bool no_startup_id
no_startup_id flag for start_application().
char * command
Command, like in command mode.
enum Match::@14 window_mode
An Assignment makes specific windows go to a specific workspace/output or run a command for that wind...
Match match
the criteria to check if a window matches
union Assignment::@17 dest
destination workspace/command/output, depending on the type
enum Assignment::@16 type
type of this assignment: