4 * i3 - an improved dynamic tiling window manager
6 * © 2009-2010 Michael Stapelberg and contributors
8 * See file LICENSE for license information.
10 * include/config.h: Contains all structs/variables for the configurable
11 * part of i3 as well as functions handling the configuration file (calling
12 * the parser (src/cfgparse.y) with the correct path, switching key bindings
24 typedef struct Config Config;
25 extern char *current_configpath;
27 extern SLIST_HEAD(modes_head, Mode) modes;
30 * Used during the config file lexing/parsing to keep the state of the lexer
31 * in order to provide useful error messages in yyerror().
41 /* These are the same as in YYLTYPE */
47 * Part of the struct Config. It makes sense to group colors for background,
48 * border and text as every element in i3 has them (window decorations, bar).
58 * Holds a user-assigned variable for parsing the configuration file. The key
59 * is replaced by value in every following line of the file.
67 SLIST_ENTRY(Variable) variables;
71 * The configuration file can contain multiple sets of bindings. Apart from the
72 * default set (name == "default"), you can specify other sets and change the
73 * currently active set of bindings by using the "mode <name>" command.
78 struct bindings_head *bindings;
80 SLIST_ENTRY(Mode) modes;
84 * Holds part of the configuration (the part which is not already in dedicated
85 * structures in include/data.h).
92 char *ipc_socket_path;
93 const char *restart_state_path;
96 int container_stack_limit;
97 int container_stack_limit_value;
99 /** Default orientation for new containers */
100 int default_orientation;
102 /** By default, focus follows mouse. If the user explicitly wants to
103 * turn this off (and instead rely only on the keyboard for changing
104 * focus), we allow him to do this with this relatively special option.
105 * It is not planned to add any different focus models. */
106 bool disable_focus_follows_mouse;
108 /** By default, a workspace bar is drawn at the bottom of the screen.
109 * If you want to have a more fancy bar, it is recommended to replace
110 * the whole bar by dzen2, for example using the i3-wsbar script which
111 * comes with i3. Thus, you can turn it off entirely. */
112 bool disable_workspace_bar;
114 /** Think of the following layout: Horizontal workspace with a tabbed
115 * con on the left of the screen and a terminal on the right of the
116 * screen. You are in the second container in the tabbed container and
117 * focus to the right. By default, i3 will set focus to the terminal on
118 * the right. If you are in the first container in the tabbed container
119 * however, focusing to the left will wrap. This option forces i3 to
120 * always wrap, which will result in you having to use "focus parent"
122 bool force_focus_wrapping;
124 /** The default border style for new windows. */
125 border_style_t default_border;
127 /** The modifier which needs to be pressed in combination with your mouse
128 * buttons to do things with floating windows (move, resize) */
129 uint32_t floating_modifier;
131 /* Color codes are stored here */
132 struct config_client {
134 struct Colortriple focused;
135 struct Colortriple focused_inactive;
136 struct Colortriple unfocused;
137 struct Colortriple urgent;
140 struct Colortriple focused;
141 struct Colortriple unfocused;
142 struct Colortriple urgent;
145 /** What should happen when a new popup is opened during fullscreen mode */
147 PDF_LEAVE_FULLSCREEN = 0,
149 } popup_during_fullscreen;
153 * Reads the configuration from ~/.i3/config or /etc/i3/config if not found.
155 * If you specify override_configpath, only this path is used to look for a
156 * configuration file.
159 void load_configuration(xcb_connection_t *conn, const char *override_configfile, bool reload);
162 * Translates keysymbols to keycodes for all bindings which use keysyms.
165 void translate_keysyms();
168 * Ungrabs all keys, to be called before re-grabbing the keys because of a
169 * mapping_notify event or a configuration file reload
172 void ungrab_all_keys(xcb_connection_t *conn);
175 * Grab the bound keys (tell X to send us keypress events for those keycodes)
178 void grab_all_keys(xcb_connection_t *conn, bool bind_mode_switch);
181 * Switches the key bindings to the given mode, if the mode exists
184 void switch_mode(const char *new_mode);
187 * Returns a pointer to the Binding with the specified modifiers and keycode
188 * or NULL if no such binding exists.
191 Binding *get_binding(uint16_t modifiers, xcb_keycode_t keycode);
193 /* prototype for src/cfgparse.y */
194 void parse_file(const char *f);