2009-05-30 22:22:58 +02:00
|
|
|
|
/*
|
2011-10-12 23:29:39 +02:00
|
|
|
|
* vim:ts=4:sw=4:expandtab
|
2009-05-30 22:22:58 +02:00
|
|
|
|
*
|
|
|
|
|
* i3 - an improved dynamic tiling window manager
|
2011-10-25 22:19:38 +02:00
|
|
|
|
* © 2009-2011 Michael Stapelberg and contributors (see also: LICENSE)
|
2009-05-30 22:22:58 +02:00
|
|
|
|
*
|
2009-11-22 20:25:33 +01:00
|
|
|
|
* include/config.h: Contains all structs/variables for the configurable
|
|
|
|
|
* part of i3 as well as functions handling the configuration file (calling
|
|
|
|
|
* the parser (src/cfgparse.y) with the correct path, switching key bindings
|
|
|
|
|
* mode).
|
2009-05-30 22:22:58 +02:00
|
|
|
|
*
|
|
|
|
|
*/
|
2009-02-25 00:50:30 +01:00
|
|
|
|
#ifndef _CONFIG_H
|
|
|
|
|
#define _CONFIG_H
|
|
|
|
|
|
2009-07-23 18:14:24 +02:00
|
|
|
|
#include <stdbool.h>
|
2009-06-01 16:19:06 +02:00
|
|
|
|
#include "queue.h"
|
2009-09-27 23:08:27 +02:00
|
|
|
|
#include "i3.h"
|
2011-10-23 23:37:11 +02:00
|
|
|
|
#include "libi3.h"
|
2009-06-01 16:19:06 +02:00
|
|
|
|
|
2009-02-25 00:50:30 +01:00
|
|
|
|
typedef struct Config Config;
|
2011-10-12 23:52:55 +02:00
|
|
|
|
typedef struct Barconfig Barconfig;
|
2011-03-19 22:26:15 +01:00
|
|
|
|
extern char *current_configpath;
|
2009-02-25 00:50:30 +01:00
|
|
|
|
extern Config config;
|
2009-09-27 18:45:39 +02:00
|
|
|
|
extern SLIST_HEAD(modes_head, Mode) modes;
|
2011-10-18 23:11:27 +02:00
|
|
|
|
extern TAILQ_HEAD(barconfig_head, Barconfig) barconfigs;
|
2009-02-25 00:50:30 +01:00
|
|
|
|
|
2010-02-13 19:42:54 +01:00
|
|
|
|
/**
|
|
|
|
|
* Used during the config file lexing/parsing to keep the state of the lexer
|
|
|
|
|
* in order to provide useful error messages in yyerror().
|
|
|
|
|
*
|
|
|
|
|
*/
|
|
|
|
|
struct context {
|
2011-10-12 23:29:39 +02:00
|
|
|
|
bool has_errors;
|
2011-10-22 17:33:00 +02:00
|
|
|
|
bool has_warnings;
|
2011-07-10 14:33:19 +02:00
|
|
|
|
|
2011-10-12 23:29:39 +02:00
|
|
|
|
int line_number;
|
|
|
|
|
char *line_copy;
|
|
|
|
|
const char *filename;
|
2010-02-13 19:42:54 +01:00
|
|
|
|
|
2011-10-12 23:29:39 +02:00
|
|
|
|
char *compact_error;
|
2010-11-14 01:45:05 +01:00
|
|
|
|
|
2011-10-12 23:29:39 +02:00
|
|
|
|
/* These are the same as in YYLTYPE */
|
|
|
|
|
int first_column;
|
|
|
|
|
int last_column;
|
2010-02-13 19:42:54 +01:00
|
|
|
|
};
|
|
|
|
|
|
2009-06-29 22:15:37 +02:00
|
|
|
|
/**
|
|
|
|
|
* Part of the struct Config. It makes sense to group colors for background,
|
|
|
|
|
* border and text as every element in i3 has them (window decorations, bar).
|
|
|
|
|
*
|
|
|
|
|
*/
|
2009-05-30 22:20:32 +02:00
|
|
|
|
struct Colortriple {
|
2011-10-12 23:29:39 +02:00
|
|
|
|
uint32_t border;
|
|
|
|
|
uint32_t background;
|
|
|
|
|
uint32_t text;
|
2009-05-30 22:20:32 +02:00
|
|
|
|
};
|
|
|
|
|
|
2009-06-29 22:15:37 +02:00
|
|
|
|
/**
|
|
|
|
|
* Holds a user-assigned variable for parsing the configuration file. The key
|
|
|
|
|
* is replaced by value in every following line of the file.
|
|
|
|
|
*
|
|
|
|
|
*/
|
2009-06-01 16:19:06 +02:00
|
|
|
|
struct Variable {
|
2011-10-12 23:29:39 +02:00
|
|
|
|
char *key;
|
|
|
|
|
char *value;
|
|
|
|
|
char *next_match;
|
2009-06-01 16:19:06 +02:00
|
|
|
|
|
2011-10-12 23:29:39 +02:00
|
|
|
|
SLIST_ENTRY(Variable) variables;
|
2009-06-01 16:19:06 +02:00
|
|
|
|
};
|
|
|
|
|
|
2009-09-27 18:45:39 +02:00
|
|
|
|
/**
|
|
|
|
|
* The configuration file can contain multiple sets of bindings. Apart from the
|
|
|
|
|
* default set (name == "default"), you can specify other sets and change the
|
|
|
|
|
* currently active set of bindings by using the "mode <name>" command.
|
|
|
|
|
*
|
|
|
|
|
*/
|
|
|
|
|
struct Mode {
|
2011-10-12 23:29:39 +02:00
|
|
|
|
char *name;
|
|
|
|
|
struct bindings_head *bindings;
|
2009-09-27 18:45:39 +02:00
|
|
|
|
|
2011-10-12 23:29:39 +02:00
|
|
|
|
SLIST_ENTRY(Mode) modes;
|
2009-09-27 18:45:39 +02:00
|
|
|
|
};
|
|
|
|
|
|
2009-06-29 22:15:37 +02:00
|
|
|
|
/**
|
|
|
|
|
* Holds part of the configuration (the part which is not already in dedicated
|
|
|
|
|
* structures in include/data.h).
|
|
|
|
|
*
|
|
|
|
|
*/
|
2009-02-25 00:50:30 +01:00
|
|
|
|
struct Config {
|
2011-10-12 23:29:39 +02:00
|
|
|
|
const char *terminal;
|
|
|
|
|
i3Font font;
|
|
|
|
|
|
|
|
|
|
char *ipc_socket_path;
|
|
|
|
|
const char *restart_state_path;
|
|
|
|
|
|
|
|
|
|
int default_layout;
|
|
|
|
|
int container_stack_limit;
|
|
|
|
|
int container_stack_limit_value;
|
|
|
|
|
|
|
|
|
|
/** Default orientation for new containers */
|
|
|
|
|
int default_orientation;
|
|
|
|
|
|
|
|
|
|
/** By default, focus follows mouse. If the user explicitly wants to
|
|
|
|
|
* turn this off (and instead rely only on the keyboard for changing
|
|
|
|
|
* focus), we allow him to do this with this relatively special option.
|
|
|
|
|
* It is not planned to add any different focus models. */
|
|
|
|
|
bool disable_focus_follows_mouse;
|
|
|
|
|
|
|
|
|
|
/** By default, a workspace bar is drawn at the bottom of the screen.
|
|
|
|
|
* If you want to have a more fancy bar, it is recommended to replace
|
|
|
|
|
* the whole bar by dzen2, for example using the i3-wsbar script which
|
|
|
|
|
* comes with i3. Thus, you can turn it off entirely. */
|
|
|
|
|
bool disable_workspace_bar;
|
|
|
|
|
|
|
|
|
|
/** Think of the following layout: Horizontal workspace with a tabbed
|
|
|
|
|
* con on the left of the screen and a terminal on the right of the
|
|
|
|
|
* screen. You are in the second container in the tabbed container and
|
|
|
|
|
* focus to the right. By default, i3 will set focus to the terminal on
|
|
|
|
|
* the right. If you are in the first container in the tabbed container
|
|
|
|
|
* however, focusing to the left will wrap. This option forces i3 to
|
|
|
|
|
* always wrap, which will result in you having to use "focus parent"
|
|
|
|
|
* more often. */
|
|
|
|
|
bool force_focus_wrapping;
|
|
|
|
|
|
|
|
|
|
/** By default, use the RandR API for multi-monitor setups.
|
|
|
|
|
* Unfortunately, the nVidia binary graphics driver doesn't support
|
|
|
|
|
* this API. Instead, it only support the less powerful Xinerama API,
|
|
|
|
|
* which can be enabled by this option.
|
|
|
|
|
*
|
|
|
|
|
* Note: this option takes only effect on the initial startup (eg.
|
|
|
|
|
* reconfiguration is not possible). On startup, the list of screens
|
|
|
|
|
* is fetched once and never updated. */
|
|
|
|
|
bool force_xinerama;
|
|
|
|
|
|
|
|
|
|
/** Automatic workspace back and forth switching. If this is set, a
|
|
|
|
|
* switch to the currently active workspace will switch to the
|
|
|
|
|
* previously focused one instead, making it possible to fast toggle
|
|
|
|
|
* between two workspaces. */
|
|
|
|
|
bool workspace_auto_back_and_forth;
|
|
|
|
|
|
|
|
|
|
/** The default border style for new windows. */
|
|
|
|
|
border_style_t default_border;
|
|
|
|
|
|
|
|
|
|
/** The default border style for new floating windows. */
|
|
|
|
|
border_style_t default_floating_border;
|
|
|
|
|
|
|
|
|
|
/** The modifier which needs to be pressed in combination with your mouse
|
|
|
|
|
* buttons to do things with floating windows (move, resize) */
|
|
|
|
|
uint32_t floating_modifier;
|
|
|
|
|
|
|
|
|
|
/* Color codes are stored here */
|
|
|
|
|
struct config_client {
|
|
|
|
|
uint32_t background;
|
|
|
|
|
struct Colortriple focused;
|
|
|
|
|
struct Colortriple focused_inactive;
|
|
|
|
|
struct Colortriple unfocused;
|
|
|
|
|
struct Colortriple urgent;
|
|
|
|
|
} client;
|
|
|
|
|
struct config_bar {
|
|
|
|
|
struct Colortriple focused;
|
|
|
|
|
struct Colortriple unfocused;
|
|
|
|
|
struct Colortriple urgent;
|
|
|
|
|
} bar;
|
|
|
|
|
|
|
|
|
|
/** What should happen when a new popup is opened during fullscreen mode */
|
|
|
|
|
enum {
|
|
|
|
|
PDF_LEAVE_FULLSCREEN = 0,
|
|
|
|
|
PDF_IGNORE = 1
|
|
|
|
|
} popup_during_fullscreen;
|
2009-02-25 00:50:30 +01:00
|
|
|
|
};
|
|
|
|
|
|
2011-10-12 23:52:55 +02:00
|
|
|
|
/**
|
|
|
|
|
* Holds the status bar configuration (i3bar). One of these structures is
|
|
|
|
|
* created for each 'bar' block in the config.
|
|
|
|
|
*
|
|
|
|
|
*/
|
|
|
|
|
struct Barconfig {
|
|
|
|
|
/** Automatically generated ID for this bar config. Used by the bar process
|
|
|
|
|
* to request a specific configuration. */
|
|
|
|
|
char *id;
|
|
|
|
|
|
|
|
|
|
/** Number of outputs in the outputs array */
|
|
|
|
|
int num_outputs;
|
|
|
|
|
/** Outputs on which this bar should show up on. We use an array for
|
|
|
|
|
* simplicity (since we store just strings). */
|
|
|
|
|
char **outputs;
|
|
|
|
|
|
|
|
|
|
/** Output on which the tray should be shown. The special value of 'no'
|
|
|
|
|
* disables the tray (it’s enabled by default). */
|
|
|
|
|
char *tray_output;
|
|
|
|
|
|
|
|
|
|
/** Path to the i3 IPC socket. This option is discouraged since programs
|
|
|
|
|
* can find out the path by looking for the I3_SOCKET_PATH property on the
|
|
|
|
|
* root window! */
|
|
|
|
|
char *socket_path;
|
|
|
|
|
|
|
|
|
|
/** Bar display mode (hide unless modifier is pressed or show in dock mode) */
|
2011-10-21 00:38:55 +02:00
|
|
|
|
enum { M_DOCK = 0, M_HIDE = 1 } mode;
|
2011-10-12 23:52:55 +02:00
|
|
|
|
|
2011-12-12 06:58:57 +01:00
|
|
|
|
/** Bar modifier (to show bar when in hide mode). */
|
|
|
|
|
enum {
|
|
|
|
|
M_NONE = 0,
|
|
|
|
|
M_CONTROL = 1,
|
|
|
|
|
M_SHIFT = 2,
|
|
|
|
|
M_MOD1 = 3,
|
|
|
|
|
M_MOD2 = 4,
|
|
|
|
|
M_MOD3 = 5,
|
|
|
|
|
M_MOD4 = 6,
|
|
|
|
|
M_MOD5 = 7
|
|
|
|
|
} modifier;
|
|
|
|
|
|
2011-10-12 23:52:55 +02:00
|
|
|
|
/** Bar position (bottom by default). */
|
|
|
|
|
enum { P_BOTTOM = 0, P_TOP = 1 } position;
|
|
|
|
|
|
2011-11-24 21:53:29 +01:00
|
|
|
|
/** Command that should be run to execute i3bar, give a full path if i3bar is not
|
|
|
|
|
* in your $PATH.
|
|
|
|
|
* By default just 'i3bar' is executed. */
|
|
|
|
|
char *i3bar_command;
|
|
|
|
|
|
2011-10-12 23:52:55 +02:00
|
|
|
|
/** Command that should be run to get a statusline, for example 'i3status'.
|
|
|
|
|
* Will be passed to the shell. */
|
|
|
|
|
char *status_command;
|
|
|
|
|
|
|
|
|
|
/** Font specification for all text rendered on the bar. */
|
|
|
|
|
char *font;
|
|
|
|
|
|
|
|
|
|
/** Hide workspace buttons? Configuration option is 'workspace_buttons no'
|
|
|
|
|
* but we invert the bool to get the correct default when initializing with
|
|
|
|
|
* zero. */
|
|
|
|
|
bool hide_workspace_buttons;
|
|
|
|
|
|
|
|
|
|
/** Enable verbose mode? Useful for debugging purposes. */
|
|
|
|
|
bool verbose;
|
|
|
|
|
|
|
|
|
|
struct bar_colors {
|
|
|
|
|
char *background;
|
|
|
|
|
char *statusline;
|
|
|
|
|
|
|
|
|
|
char *focused_workspace_text;
|
|
|
|
|
char *focused_workspace_bg;
|
|
|
|
|
|
|
|
|
|
char *active_workspace_text;
|
|
|
|
|
char *active_workspace_bg;
|
|
|
|
|
|
|
|
|
|
char *inactive_workspace_text;
|
|
|
|
|
char *inactive_workspace_bg;
|
|
|
|
|
|
|
|
|
|
char *urgent_workspace_text;
|
|
|
|
|
char *urgent_workspace_bg;
|
|
|
|
|
} colors;
|
|
|
|
|
|
2011-10-18 23:11:27 +02:00
|
|
|
|
TAILQ_ENTRY(Barconfig) configs;
|
2011-10-12 23:52:55 +02:00
|
|
|
|
};
|
|
|
|
|
|
2009-04-07 19:02:07 +02:00
|
|
|
|
/**
|
|
|
|
|
* Reads the configuration from ~/.i3/config or /etc/i3/config if not found.
|
|
|
|
|
*
|
|
|
|
|
* If you specify override_configpath, only this path is used to look for a
|
|
|
|
|
* configuration file.
|
|
|
|
|
*
|
|
|
|
|
*/
|
2009-07-23 18:14:24 +02:00
|
|
|
|
void load_configuration(xcb_connection_t *conn, const char *override_configfile, bool reload);
|
2009-08-07 15:35:12 +02:00
|
|
|
|
|
2010-03-14 22:35:51 +01:00
|
|
|
|
/**
|
|
|
|
|
* Translates keysymbols to keycodes for all bindings which use keysyms.
|
|
|
|
|
*
|
|
|
|
|
*/
|
|
|
|
|
void translate_keysyms();
|
|
|
|
|
|
2009-08-07 15:35:12 +02:00
|
|
|
|
/**
|
|
|
|
|
* Ungrabs all keys, to be called before re-grabbing the keys because of a
|
|
|
|
|
* mapping_notify event or a configuration file reload
|
|
|
|
|
*
|
|
|
|
|
*/
|
|
|
|
|
void ungrab_all_keys(xcb_connection_t *conn);
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Grab the bound keys (tell X to send us keypress events for those keycodes)
|
|
|
|
|
*
|
|
|
|
|
*/
|
2010-03-14 22:35:51 +01:00
|
|
|
|
void grab_all_keys(xcb_connection_t *conn, bool bind_mode_switch);
|
2009-02-25 00:50:30 +01:00
|
|
|
|
|
2009-09-27 18:45:39 +02:00
|
|
|
|
/**
|
|
|
|
|
* Switches the key bindings to the given mode, if the mode exists
|
|
|
|
|
*
|
|
|
|
|
*/
|
2011-06-10 02:38:07 +02:00
|
|
|
|
void switch_mode(const char *new_mode);
|
2009-09-27 18:45:39 +02:00
|
|
|
|
|
2010-03-14 22:35:51 +01:00
|
|
|
|
/**
|
|
|
|
|
* Returns a pointer to the Binding with the specified modifiers and keycode
|
|
|
|
|
* or NULL if no such binding exists.
|
|
|
|
|
*
|
|
|
|
|
*/
|
|
|
|
|
Binding *get_binding(uint16_t modifiers, xcb_keycode_t keycode);
|
|
|
|
|
|
2011-07-10 14:33:19 +02:00
|
|
|
|
/**
|
|
|
|
|
* Kills the configerror i3-nagbar process, if any.
|
|
|
|
|
*
|
|
|
|
|
* Called when reloading/restarting.
|
|
|
|
|
*
|
|
|
|
|
* If wait_for_it is set (restarting), this function will waitpid(), otherwise,
|
|
|
|
|
* ev is assumed to handle it (reloading).
|
|
|
|
|
*
|
|
|
|
|
*/
|
|
|
|
|
void kill_configerror_nagbar(bool wait_for_it);
|
|
|
|
|
|
2009-11-22 20:25:33 +01:00
|
|
|
|
/* prototype for src/cfgparse.y */
|
|
|
|
|
void parse_file(const char *f);
|
|
|
|
|
|
2009-02-25 00:50:30 +01:00
|
|
|
|
#endif
|