Advertisement
Not a member of Pastebin yet?
Sign Up,
it unlocks many cool features!
- .TH MONSTERWM 1 monsterwm
- .SH NAME
- monsterwm \- minimal and dynamic tiling window manager
- .SH SYNOPSIS
- .B monsterwm
- .RB [ \-v ]
- .SH DESCRIPTION
- .I monsterwm
- is a minimal, lightweight, tiny but monstrous, dynamic tiling window manager.
- .P
- .SH MODES
- .I monsterwm
- comes with four tiling layouts by default plus the floating mode.
- It allows the usual method of tiling window managers, with the new window as
- the master window, but also provides the ability to have the new window opened
- as the last window (at the bottom) of the stack.
- .P
- the available modes:
- .TP
- .B Tile stack
- the stack clients are tiled on the side of master.
- .TP
- .B Bottom stack
- the stack clients are tiled beneath the master.
- .TP
- .B Grid mode
- clients are tiled in a grid, equaly sharing and dividing the screen space
- .TP
- .B Monocle mode
- also known as fullscreen or max mode, where the clients take up the entire
- screen space. Other clients are hidden behind the current shown window.
- On this layout, fullscreen clients don't need and don't have borders.
- You can change that behavior with the
- .I monocleborders
- patch, in the corresponding branch.
- .TP
- .B Floating mode
- windows can move and be resized freely in the screen space, like on a stacking
- window manager. Windows retain their floating status until the user switches
- to a tiling mode.
- .SH OPTIONS
- .TP
- .B \-v
- prints version information to standard output, then exits.
- .SH USAGE
- .SS Status bar
- .P
- .I monsterwm
- does not provide a status bar. Consistent with the Unix philosophy,
- .I monsterwm
- provides information to the status bar or panel of choice via ouputing
- text with information about the state of the windows.
- .P
- the available settings in
- .I config.h
- for the panel/status bar, are:
- .TP
- .B SHOW_PANEL
- whether the panel should be visible or hidden by default
- .TP
- .B TOP_PANEL
- whether the panel should be on top or bottom of the screen
- .TP
- .B PANEL_HEIGHT
- how much space should be left for use by the panel. Set to
- .B 0
- to disable the panel completely.
- .SS Keyboard and mouse commands
- All of
- .I monsterwm's
- commands can be customized by editing
- .I config.h
- and recompiling.
- .P
- The default keyboard-bindings include:
- .TP
- .B Mod1\-b
- Toggles the panel on and off.
- .TP
- .B Mod1\-Backspace
- Focus the window with an urgent hint.
- Focus the appropriate desktop if needed.
- .TP
- .B Mod1\-Shift\-c
- Close focused window.
- .TP
- .B Mod1\-j
- Focus next window.
- .TP
- .B Mod1\-k
- Focus previous window.
- .TP
- .B Mod1\-l
- Increase master area size.
- .TP
- .B Mod1\-h
- Decrease master area size.
- .TP
- .B Mod1\-o
- Shrink the size of the first stack window.
- .TP
- .B Mod1\-p
- Grow the size of the first stack window.
- .TP
- .B Mod1\-Ctrl\-h
- focus the previous desktop.
- .TP
- .B Mod1\-Ctrl\-l
- focus the next desktop.
- .TP
- .B Mod1\-Shift\-h
- focus the previous desktop that has windows open.
- .TP
- .B Mod1\-Shift\-l
- focus the next desktop that has windows open.
- .TP
- .B Mod1\-Tab
- Toggles to the last selected desktop.
- .TP
- .B Mod1\-Return
- Swaps the focused window to/from master area (tiled layouts only).
- .TP
- .B Mod1\-Shift\-j
- Move the focussed window down the stack
- .TP
- .B Mod1\-Shift\-k
- Move the focussed window up the stack
- .TP
- .B Mod1\-Shift\-t
- Sets tiled layout.
- .TP
- .B Mod1\-Shift\-m
- Sets monocle layout.
- .TP
- .B Mod1\-Shift\-b
- Sets bottom stack layout
- .TP
- .B Mod1\-Shift\-g
- Sets grid layout
- .TP
- .B Mod1\-Shift\-f
- Sets float layout
- .TP
- .B Mod1\-Shift\-r
- Quit with exit value 0 (usefull for restarts of the wm).
- .TP
- .B Mod1\-Shift\-q
- Quit with exit value 1 (differentiate quit from restart).
- .TP
- .B Mod1\-Shift\-Return
- Start
- .BR xterm (1).
- .TP
- .B Mod4\-v
- Start
- .BR dmenu (1).
- .TP
- .B MOD4\-{Down,Up,Right,Left} Arrow
- move the current window to the corresponding direction.
- .TP
- .B MOD4\-Shift\-{Down,Up,Right,Left} Arrow
- resize the current window to the corresponding direction.
- .TP
- .B Mod1\-F{1..n}
- Move to the nth workspace. By default,
- .I monsterwm
- is configured with four workspaces.
- The setting in
- .I config.h
- .B FOLLOW_WINDOW
- defines whether the focus should change on
- the new desktop, where the window moved to.
- .TP
- .B Mod1\-Shift\-F{1..n}
- Move focused window to nth workspace.
- .P
- The default mouse-bindings include:
- .TP
- .B Mod1\-Button1
- Dragging the mouse will move the selected window
- .TP
- .B Mod1\-Button3
- Dragging the mouse will resize the selected window
- .TP
- .B Mod4\-Button3
- will bring up
- .I dmenu
- .SS Customization
- .I monsterwm
- is customized by copying
- .I config.def.h
- to
- .I config.h
- and (re)compiling the source code.
- .P
- settings among others covered above include:
- .TP
- .B MASTER_SIZE
- set the size of the master area that
- will be used by the master window
- .TP
- .B DEFAULT_MODE
- set the default tiling mode to be active on startup
- .TP
- .B ATTACH_ASIDE
- whether new stack clients should spawn as the master window,
- or the last stack window
- .TP
- .B FOLLOW_MOUSE
- whether to focus the window the mouse just entered
- .TP
- .B FOLLOW_WINDOW
- whether to follow the window to the new desktop where it moved
- .TP
- .B CLICK_TO_FOCUS
- whether an action on a window (eg clicking, or scrolling)
- will give the window focus. Disabling this gives the user
- the ability to, for example, look up things on a web browser
- but not lose focus from the terminal etc.
- .TP
- .B BORDER_WIDTH
- the width of the borders the windows have
- .TP
- .B FOCUS / UNFOCUS
- the colors for the borders of focused and unfocused windows
- .TP
- .B DESKTOPS
- the number of desktops to use
- .TP
- .B DEFAULT_DESKTOP
- which desktop to focus by default
- .TP
- .B MINWSZ
- the minimum window size allowed. Prevents over resizing with
- the mouse or keyboard (eg resizing the master area)
- .P
- users can set
- .B rules
- on applications, by matching their
- .B class
- or
- .B instance
- name. The rules can specify on which
- .B desktop
- the application should start (or
- .B -1
- to signify the current desktop), whether the
- .B focus
- should change to that desktop, when the application starts
- and whether the application should start on
- .B floating
- or tiled mode.
- .SH SEE ALSO
- .BR dmenu (1)
- .SH BUGS
- .I monsterwm
- is under active development. Please report all bugs to the author.
- .SH AUTHOR
- Ivan c00kiemon5ter Kanakarakis <ivan.kanak at gmail.com>
Advertisement
Add Comment
Please, Sign In to add comment
Advertisement