1 .TH epistrc 4 "August 16, 2002"
3 epistrc \- Configuration file for Epist
5 .B $HOME/.openbox/epistrc
7 .B @pkgdatadir@/epistrc
9 \fIepist\fR(1) grabs its configuration and bindings from the epistrc file.
11 The epistrc file contains 2 sections:
13 All of the options for epist are contained inside a clause such as this:
21 Bindings are specified in this format:
23 <key> <action> <optional parameter>;
25 Bindings with chains are specified in this format:
29 <key> <action> <optional parameter>;
33 The <key> is made up of a list of modifiers and a single key. The possible modifiers are: \fIControl\fR, \fIShift\fR, \fRMod1\fI (usually the Alt key), \fRMod2\fI, \fRMod3\fI, \fRMod4\fI (usually the "windows" key), and \fRMod5\fI. You may also specify a <key> without any modifiers.
35 You may also nest as many chains as you want. Some examples of bindings are:
39 Mod1-Shift-Tab prevWindow;
41 Mod1-F1 changeWorkspace 1;
43 Mod1-F2 changeWorkspace 2;
45 Control-F1 execute "xterm";
58 Runs a shell command. Takes a single string argument, in ""s.
60 Iconifies the currently focused window.
62 Raises the currently focused window to the top of the stacking order.
64 Lowers the currently focused window to the bottom of the stacking order.
66 Closes the currently focused window.
68 Shades and Unshades the currently focused window.
70 Sends the window to all workspaces, or moves it from all workspaces to the
73 Move the window up. Takes a single numerical parameter, which is the amount to
76 Move the window down. Takes a single numerical parameter, which is the amount to
79 Move the window left. Takes a single numerical parameter, which is the amount to
82 Move the window right. Takes a single numerical parameter, which is the amount
85 Resizes the window's width. Takes a single numerical parameter, which is the
86 amount to resize the window by. A positive number enlarges the window, a
87 negative value shrinks the window.
88 .SS resizeWindowHeight
89 Resizes the window's height. Takes a single numerical parameter, which is the
90 amount to resize the window by. A positive number enlarges the window, a
91 negative value shrinks the window.
92 .SS toggleMaximizeFull
93 Maximizes and Unmaxizes the currently focused window.
94 .SS toggleMaximizeVertical
95 Maximizes and Unmaxizes the currently focused window vertically.
96 .SS toggleMaximizeHorizontal
97 Maximizes and Unmaxizes the currently focused window horizontally.
99 Sends the currently focused window to another workspace. This takes a single
100 numberical parameter, which is the workspace to send the window to. Workspace
103 Cycles focus to the next window on the workspace.
105 Cycles focus to the previous window on the workspace.
106 .SS nextWindowOnAllWorkspaces
107 Cycles focus to the next window on all workspaces, switching between workspaces
109 .SS prevWindowOnAllWorkspaces
110 Cycles focus to the previous window on all workspaces, switching between
111 workspaces as neccessary.
112 .SS nextWindowOnAllScreens
113 Cycles focus to the next window on all screens (in a multi-head setup).
114 .SS prevWindowOnAllScreens
115 Cycles focus to the previous window on all screens (in a multi-head setup).
116 .SS nextWindowOfClass
117 Cycles focus to the next window of a certain class on the current workspace.
118 This can take a single string parameter, in ""s, specifying the class of the
119 window to cycle to. If the parameter is omitted, the class of the currently
120 focused window is used.
121 .SS prevWindowOfClass
122 Cycles focus to the previous window of a certain class on the current workspace.
123 This can take a single string parameter, in ""s, specifying the class of the
124 window to cycle to. If the parameter is omitted, the class of the currently
125 focused window is used.
126 .SS nextWindowOfClassOnAllWorkspaces
127 Cycles focus to the next window of a certain class on all workspaces. This can
128 take a single string parameter, in ""s, specifying the class of the window to
129 cycle to. If the parameter is omitted, the class of the currently focused
131 .SS prevWindowOfClassOnAllWorkspaces
132 Cycles focus to the previous window of a certain class on all workspaces. This
133 can take a single string parameter, in ""s, specifying the class of the window
134 to cycle to. If the parameter is omitted, the class of the currently focused
137 Changes to a specific workspace. This takes a single numerical paramter,
138 specifying the number of the workspace to switch to. Workspace numbers begin at
141 Switches to the next workspace.
143 Switches to the previous workspace.
145 Cycles focus to the next screen (in a multi-head setup).
147 Cycles focus to the previous screen (in a multi-head setup).
150 \fIepist\fR(1) \fIopenbox\fR(1)