Skip to content

Fast dynamic tiling window manager based on monsterwm-xcb

License

Notifications You must be signed in to change notification settings

RoastPotatoes/FrankenWM

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

FrankenWM

"monsterwm's bastard child" or "not the wm your desktop needs, but the one it deserves"

FrankenWM is a dynamic tiling WM (comparable to dwm or Awesome), featuring the v-stack, b-stack, grid, fibonacci, dualstack, equal and monocle layouts out of the box. If you want to, you can add gaps between the windows as well.

It was once based on monsterwm but has undergone many greater changes including adding pieces from other WMs (hence the name) and porting all sorts of stuff from Xlib to XCB. Many of the original monsterwm patches have been ported as well.

All settings must be set at compile time by editing config.h and it does not feature a status bar (but supports leaving preconfigured space for one). Refer to the monsterwm docs for examples on how to parse the output to use it in a status bar.

Installation

You need xcb and xcb-utils then, copy config.def.h as config.h and edit to suit your needs. Build and install.

$ cp config.def.h config.h
$ $EDITOR config.h
$ make
# make clean install

The packages in Arch Linux needed for example would be libxcb xcb-util xcb-util-wm xcb-util-keysyms

Configuration

Configuration is done by editing config.h before compiling FrankenWM. If you want an advanced configuration example, you can have a look at my personal config.

Usage

I took the time to write a really nice and pretty manpage (man frankenwm, or man ./frankenwm.1 if you want to read it before installing) covering the tiling modes and all of the default shortcuts.

Bugs

Bugs can be reported here: FrankenWM issues

Thanks

Parts of FrankenWM come from:

Inspiration from:

About

Fast dynamic tiling window manager based on monsterwm-xcb

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published