FRANKENWM(1)

NAME
FrankenWM - monsterwm's bastard child

SYNOPSIS
frankenwm [-v]

DESCRIPTION
FrankenWM is a dynamic tiling window manager pieced together from other WMs and based on XCB.

MODES
There are currently seven base layouts:

Vertical Stack (Tile) where the master window fill a large space either left or right and the rest of the windows is stacked on the other side,
  ___________ ___________
 | | 1 | | 1 | |
 | M |___| or |___| M |
 | | 2 | | 2 | |
 |_______|___| |___|_______| Dualstack where the master is in the center and the stack is divided onto both the left and right side, or the top and bottom if inverted,
  ___________ ___________
 | 1| | 3| |__1__|__2__|
 |__| M |__| or | M |
 | 2| | 4| |___________|
 |__|_____|__| |__3__|__4__| Bottom stack where the master is on top and the stack is horizontally below it, or if inverted, the other way around,
  ___________ ___________
 | | |__1__|__2__|
 | M | or | |
 |___________| | M |
 |__1__|__2__| |___________| Grid mode where all the windows get sorted in a grid, giving each window roughly the same space on the screen,
  ___________
 | M | 2 |
 |_____|_____|
 | 1 | 3 |
 |_____|_____| Equal mode where all the windows have exactly the same space on the screen, sorting them in either columns or rows, depending on the inverting status,
  ___________ ___________
 | | | | |_____M_____|
 | M | 1 | 2 | or |_____1_____|
 | | | | |_____2_____|
 |___|___|___| |_____3_____| Fibonacci mode where the clients share 50% of the space of the client above them in the stack, getting smaller going down the stack,
  ___________ ___________
 | | 1 | | | 2| 3|
 | M |_____| or | M |__|__|
 | | 2| 3| | | 1 |
 |_____|__|__| |_____|_____| Monocle mode where the clients take up the entire workspace, and additional clients are hidden behind the current shown window,
  ___________
 | |
 | M |
 | |
 |___________| Floating mode where, windows can move and be resized freely in the screen space. Windows retain their floating status until the user switches to a tiling mode.
  ___________
 || | 1| |
 || M |__| |
 ||_____| |
 |___________| When hitting a tiling mode shortcut while being already in this tiling mode, FrankenWM will catch all floating windows and reset them back to tiling as well.

OPTIONS

-v  prints version information to standard output, then exits.

USAGE

  Status bar
frankenwm does not provide a status bar. Consistent with the Unix philosophy, frankenwm provides information to the status bar or panel of choice via text.

  Keyboard and mouse commands
All of frankenwm's commands can be customized by editing config.h and recompiling.

DEFAULT SHORTCUTS

  LAYOUTS

Mod4-Shift-t
    Sets tiled layout

Mod4-Shift-b
    Sets bottom stack layout

Mod4-Shift-g
    Sets grid layout

Mod4-Shift-f
    Sets fibonacci layout

Mod4-Shift-d
    Sets dualstack layout

Mod4-Shift-e
    Sets equal layout

Mod4-Shift-m
    Sets monocle layout

Mod4-Shift-{z,x}
    Cycle through the available tiling modes. Also resets all windows to tiling.

  WINDOW SELECTION

Mod4-{j,k}
    Focus next/previous window

Mod4-Shift-{j,k}
    Move the focussed window down/up the stack

Mod4-Return
    Swaps the focused window to/from master area

Mod4-w
    Toggle between master and previously selected stack window

Mod4-f
    Maximize/fullscreen the current window

Mod4-{m,n}
    Push windows to a minimize "stack"/pull them out. The stack is desktop-specific and the last window minimized gets restored first

Mod4-Shift-i
    Toggle the inverting status, which enables alternate versions of existing layout modes

Mod4-Backspace
    Focus the window that raised an urgent hint. If no such window in current desktop, search other desktops, and focus the desktop and window that raised the urgent hint

  COMMANDS

Mod4-Shift-Return
    Start xterm(1)

Mod4-r
    Start dmenu(1)

Mod4-Shift-c
    Close the focused window

Mod4-s
    Toggle the scratchpad terminal, if enabled. The scratchpad is a custom terminal that always floats and can be toggled from all displays

Mod4-Control-{q}
    Quit frankenwm

  SETTINGS

Mod4-Control-{l,h}
    Increase/decrease master area size

Mod4-Control-{o,p}
    Decrease/increase useless gap size

Mod4-Control-{u,i}
    Decrease/increase the borders around windows

Mod4-Control-b
    Toggles the panel on and off

Mod4-Control-s
    Toggle display of windows on all desktops

  VIRTUAL DESKTOPS

Mod4-{1..n}
    Select the nth workspace. By default, frankenwm is configured with four workspaces

Mod4-Shift-{1..n}
    Move the focused window to the nth workspace

Mod4-Shift-{h,l}
    Switch to the next/previous desktop

Mod4-Control-{h,l}
    Switch to the next/previous desktop and take the current window with you

Mod4-Control-Shift-{h,l}
    Switch to the next/previous desktop and take all of the windows with you

Mod4-Tab
    Toggles to the last selected desktop

  FLOATING WINDOWS

Mod4-c
    Center the focussed window in floating mode on the screen

Mod4-Mod1-{h,j,k,l}
    Move floating windows around

Mod4-Mod1-Control-{h,j,k,l}
    Resize floating windows

Mod4-t
    Reset just the active floating window back into tiling

  MOUSE

Mod4-Button1
    Dragging the mouse will move the selected window

Mod4-Button3
    Dragging the mouse will resize the selected window

CUSTOMIZATION
frankenwm is customized by copying config.def.h to config.h , customizing it and (re)compiling the source code.

SEE ALSO
dmenu(1)

BUGS
frankenwm is under active development. Please report all bugs to the author.

AUTHOR
Robin Schroer <sulami at peerwire dot org>

BASED ON WORKS OF
Jari Vetoniemi <cloudef at cloudef.eu> Ivan Kanakarakis <ivan.kanak at gmail.com>