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 /** The default border style for new windows. */
115 border_style_t default_border;
117 /** The modifier which needs to be pressed in combination with your mouse
118 * buttons to do things with floating windows (move, resize) */
119 uint32_t floating_modifier;
121 /* Color codes are stored here */
122 struct config_client {
124 struct Colortriple focused;
125 struct Colortriple focused_inactive;
126 struct Colortriple unfocused;
127 struct Colortriple urgent;
130 struct Colortriple focused;
131 struct Colortriple unfocused;
132 struct Colortriple urgent;
135 /** What should happen when a new popup is opened during fullscreen mode */
137 PDF_LEAVE_FULLSCREEN = 0,
139 } popup_during_fullscreen;
143 * Reads the configuration from ~/.i3/config or /etc/i3/config if not found.
145 * If you specify override_configpath, only this path is used to look for a
146 * configuration file.
149 void load_configuration(xcb_connection_t *conn, const char *override_configfile, bool reload);
152 * Translates keysymbols to keycodes for all bindings which use keysyms.
155 void translate_keysyms();
158 * Ungrabs all keys, to be called before re-grabbing the keys because of a
159 * mapping_notify event or a configuration file reload
162 void ungrab_all_keys(xcb_connection_t *conn);
165 * Grab the bound keys (tell X to send us keypress events for those keycodes)
168 void grab_all_keys(xcb_connection_t *conn, bool bind_mode_switch);
171 * Switches the key bindings to the given mode, if the mode exists
174 void switch_mode(const char *new_mode);
177 * Returns a pointer to the Binding with the specified modifiers and keycode
178 * or NULL if no such binding exists.
181 Binding *get_binding(uint16_t modifiers, xcb_keycode_t keycode);
183 /* prototype for src/cfgparse.y */
184 void parse_file(const char *f);