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;
26 extern SLIST_HEAD(modes_head, Mode) modes;
29 * Used during the config file lexing/parsing to keep the state of the lexer
30 * in order to provide useful error messages in yyerror().
40 /* These are the same as in YYLTYPE */
46 * Part of the struct Config. It makes sense to group colors for background,
47 * border and text as every element in i3 has them (window decorations, bar).
57 * Holds a user-assigned variable for parsing the configuration file. The key
58 * is replaced by value in every following line of the file.
66 SLIST_ENTRY(Variable) variables;
70 * The configuration file can contain multiple sets of bindings. Apart from the
71 * default set (name == "default"), you can specify other sets and change the
72 * currently active set of bindings by using the "mode <name>" command.
77 struct bindings_head *bindings;
79 SLIST_ENTRY(Mode) modes;
83 * Holds part of the configuration (the part which is not already in dedicated
84 * structures in include/data.h).
91 const char *ipc_socket_path;
92 const char *restart_state_path;
95 int container_stack_limit;
96 int container_stack_limit_value;
98 /** By default, focus follows mouse. If the user explicitly wants to
99 * turn this off (and instead rely only on the keyboard for changing
100 * focus), we allow him to do this with this relatively special option.
101 * It is not planned to add any different focus models. */
102 bool disable_focus_follows_mouse;
104 /** By default, a workspace bar is drawn at the bottom of the screen.
105 * If you want to have a more fancy bar, it is recommended to replace
106 * the whole bar by dzen2, for example using the i3-wsbar script which
107 * comes with i3. Thus, you can turn it off entirely. */
108 bool disable_workspace_bar;
110 /** The default border style for new windows. */
111 border_style_t default_border;
113 /** The modifier which needs to be pressed in combination with your mouse
114 * buttons to do things with floating windows (move, resize) */
115 uint32_t floating_modifier;
117 /* Color codes are stored here */
118 struct config_client {
120 struct Colortriple focused;
121 struct Colortriple focused_inactive;
122 struct Colortriple unfocused;
123 struct Colortriple urgent;
126 struct Colortriple focused;
127 struct Colortriple unfocused;
128 struct Colortriple urgent;
133 * Reads the configuration from ~/.i3/config or /etc/i3/config if not found.
135 * If you specify override_configpath, only this path is used to look for a
136 * configuration file.
139 void load_configuration(xcb_connection_t *conn, const char *override_configfile, bool reload);
142 * Translates keysymbols to keycodes for all bindings which use keysyms.
145 void translate_keysyms();
148 * Ungrabs all keys, to be called before re-grabbing the keys because of a
149 * mapping_notify event or a configuration file reload
152 void ungrab_all_keys(xcb_connection_t *conn);
155 * Grab the bound keys (tell X to send us keypress events for those keycodes)
158 void grab_all_keys(xcb_connection_t *conn, bool bind_mode_switch);
161 * Switches the key bindings to the given mode, if the mode exists
164 void switch_mode(xcb_connection_t *conn, const char *new_mode);
167 * Returns a pointer to the Binding with the specified modifiers and keycode
168 * or NULL if no such binding exists.
171 Binding *get_binding(uint16_t modifiers, xcb_keycode_t keycode);
173 /* prototype for src/cfgparse.y */
174 void parse_file(const char *f);