monsterwm

Personal build of monsterwm
git clone git://git.gormless.xyz/monsterwm.git
Log | Files | Refs | README | LICENSE

monsterwm.1 (6035B)


      1 .TH MONSTERWM 1 monsterwm
      2 .SH NAME
      3 monsterwm \- minimal and dynamic tiling window manager
      4 .SH SYNOPSIS
      5 .B monsterwm
      6 .RB [ \-v ]
      7 .SH DESCRIPTION
      8 .I monsterwm
      9 is a minimal, lightweight, tiny but monstrous, dynamic tiling window manager.
     10 .P
     11 .SH MODES
     12 .I monsterwm
     13 comes with four tiling layouts by default plus the floating mode.
     14 It allows the usual method of tiling window managers, with the new window as
     15 the master window, but also provides the ability to have the new window opened
     16 as the last window (at the bottom) of the stack.
     17 .P
     18 the available modes:
     19 .TP
     20 .B Tile stack
     21 the stack clients are tiled on the side of master.
     22 .TP
     23 .B Bottom stack
     24 the stack clients are tiled beneath the master.
     25 .TP
     26 .B Grid mode
     27 clients are tiled in a grid, equaly sharing and dividing the screen space
     28 .TP
     29 .B Monocle mode
     30 also known as fullscreen or max mode, where the clients take up the entire
     31 screen space. Other clients are hidden behind the current shown window.
     32 On this layout, fullscreen clients don't need and don't have borders.
     33 You can change that behavior with the
     34 .I monocleborders
     35 patch, in the corresponding branch.
     36 .TP
     37 .B Floating mode
     38 windows can move and be resized freely in the screen space, like on a stacking
     39 window manager. Windows retain their floating status until the user switches
     40 to a tiling mode.
     41 .SH OPTIONS
     42 .TP
     43 .B \-v
     44 prints version information to standard output, then exits.
     45 .SH USAGE
     46 .SS Status bar
     47 .P
     48 .I monsterwm
     49 does not provide a status bar. Consistent with the Unix philosophy,
     50 .I monsterwm
     51 provides information to the status bar or panel of choice via ouputing
     52 text with information about the state of the windows.
     53 .P
     54 the available settings in
     55 .I config.h
     56 for the panel/status bar, are:
     57 .TP
     58 .B SHOW_PANEL
     59 whether the panel should be visible or hidden by default
     60 .TP
     61 .B TOP_PANEL
     62 whether the panel should be on top or bottom of the screen
     63 .TP
     64 .B PANEL_HEIGHT
     65 how much space should be left for use by the panel. Set to
     66 .B 0
     67 to disable the panel completely.
     68 .SS Keyboard and mouse commands
     69 All of
     70 .I monsterwm's
     71 commands can be customized by editing
     72 .I config.h
     73 and recompiling.
     74 .P
     75 The default keyboard-bindings include:
     76 .TP
     77 .B Mod1\-b
     78 Toggles the panel on and off.
     79 .TP
     80 .B Mod1\-Backspace
     81 Focus the window with an urgent hint.
     82 Focus the appropriate desktop if needed.
     83 .TP
     84 .B Mod1\-Shift\-c
     85 Close focused window.
     86 .TP
     87 .B Mod1\-j
     88 Focus next window.
     89 .TP
     90 .B Mod1\-k
     91 Focus previous window.
     92 .TP
     93 .B Mod1\-l
     94 Increase master area size.
     95 .TP
     96 .B Mod1\-h
     97 Decrease master area size.
     98 .TP
     99 .B Mod1\-o
    100 Shrink the size of the first stack window.
    101 .TP
    102 .B Mod1\-p
    103 Grow the size of the first stack window.
    104 .TP
    105 .B Mod1\-Ctrl\-h
    106 focus the previous desktop.
    107 .TP
    108 .B Mod1\-Ctrl\-l
    109 focus the next desktop.
    110 .TP
    111 .B Mod1\-Shift\-h
    112 focus the previous desktop that has windows open.
    113 .TP
    114 .B Mod1\-Shift\-l
    115 focus the next desktop that has windows open.
    116 .TP
    117 .B Mod1\-Tab
    118 Toggles to the last selected desktop.
    119 .TP
    120 .B Mod1\-Return
    121 Swaps the focused window to/from master area (tiled layouts only).
    122 .TP
    123 .B Mod1\-Shift\-j
    124 Move the focussed window down the stack
    125 .TP
    126 .B Mod1\-Shift\-k
    127 Move the focussed window up the stack
    128 .TP
    129 .B Mod1\-Shift\-t
    130 Sets tiled layout.
    131 .TP
    132 .B Mod1\-Shift\-m
    133 Sets monocle layout.
    134 .TP
    135 .B Mod1\-Shift\-b
    136 Sets bottom stack layout
    137 .TP
    138 .B Mod1\-Shift\-g
    139 Sets grid layout
    140 .TP
    141 .B Mod1\-Shift\-f
    142 Sets float layout
    143 .TP
    144 .B Mod1\-Shift\-r
    145 Quit with exit value 0 (usefull for restarts of the wm).
    146 .TP
    147 .B Mod1\-Shift\-q
    148 Quit with exit value 1 (differentiate quit from restart).
    149 .TP
    150 .B Mod1\-Shift\-Return
    151 Start
    152 .BR xterm (1).
    153 .TP
    154 .B Mod4\-v
    155 Start
    156 .BR dmenu (1).
    157 .TP
    158 .B MOD4\-{Down,Up,Right,Left} Arrow
    159 move the current window to the corresponding direction.
    160 .TP
    161 .B MOD4\-Shift\-{Down,Up,Right,Left} Arrow
    162 resize the current window to the corresponding direction.
    163 .TP
    164 .B Mod1\-F{1..n}
    165 Move to the nth workspace. By default,
    166 .I monsterwm
    167 is configured with four workspaces.
    168 The setting in
    169 .I config.h
    170 .B FOLLOW_WINDOW
    171 defines whether the focus should change on
    172 the new desktop, where the window moved to.
    173 .TP
    174 .B Mod1\-Shift\-F{1..n}
    175 Move focused window to nth workspace.
    176 .P
    177 The default mouse-bindings include:
    178 .TP
    179 .B Mod1\-Button1
    180 Dragging the mouse will move the selected window
    181 .TP
    182 .B Mod1\-Button3
    183 Dragging the mouse will resize the selected window
    184 .TP
    185 .B Mod4\-Button3
    186 will bring up
    187 .I dmenu
    188 .SS Customization
    189 .I monsterwm
    190 is customized by copying
    191 .I config.def.h
    192 to
    193 .I config.h
    194 and (re)compiling the source code.
    195 .P
    196 settings among others covered above include:
    197 .TP
    198 .B MASTER_SIZE
    199 set the size of the master area that
    200 will be used by the master window
    201 .TP
    202 .B DEFAULT_MODE
    203 set the default tiling mode to be active on startup
    204 .TP
    205 .B ATTACH_ASIDE
    206 whether new stack clients should spawn as the master window,
    207 or the last stack window
    208 .TP
    209 .B FOLLOW_MOUSE
    210 whether to focus the window the mouse just entered
    211 .TP
    212 .B FOLLOW_WINDOW
    213 whether to follow the window to the new desktop where it moved
    214 .TP
    215 .B CLICK_TO_FOCUS
    216 whether an action on a window (eg clicking, or scrolling)
    217 will give the window focus. Disabling this gives the user
    218 the ability to, for example, look up things on a web browser
    219 but not lose focus from the terminal etc.
    220 .TP
    221 .B BORDER_WIDTH
    222 the width of the borders the windows have
    223 .TP
    224 .B FOCUS / UNFOCUS
    225 the colors for the borders of focused and unfocused windows
    226 .TP
    227 .B DESKTOPS
    228 the number of desktops to use
    229 .TP
    230 .B DEFAULT_DESKTOP
    231 which desktop to focus by default
    232 .TP
    233 .B MINWSZ
    234 the minimum window size allowed. Prevents over resizing with
    235 the mouse or keyboard (eg resizing the master area)
    236 .P
    237 users can set
    238 .B rules
    239 on applications, by matching their
    240 .B class
    241 or
    242 .B instance
    243 name. The rules can specify on which
    244 .B desktop
    245 the application should start (or
    246 .B -1
    247 to signify the current desktop), whether the
    248 .B focus
    249 should change to that desktop, when the application starts
    250 and whether the application should start on
    251 .B floating
    252 or tiled mode.
    253 .SH SEE ALSO
    254 .BR dmenu (1)
    255 .SH BUGS
    256 .I monsterwm
    257 is under active development. Please report all bugs to the author.
    258 .SH AUTHOR
    259 Ivan c00kiemon5ter Kanakarakis <ivan.kanak at gmail.com>
    260 
    261