https://wiki.archlinux.org/api.php?action=feedcontributions&user=Sampctech&feedformat=atomArchWiki - User contributions [en]2024-03-28T14:11:27ZUser contributionsMediaWiki 1.41.0https://wiki.archlinux.org/index.php?title=FrankenWM&diff=579990FrankenWM2019-08-15T20:18:51Z<p>Sampctech: /* AUR */</p>
<hr />
<div>[[Category:Dynamic WMs]]<br />
[[ja:FrankenWM]]<br />
FrankenWM is a dynamic tiling [[window manager]], comparable to dwm or awesome. This means there are a number of predefined layouts that are used to tile the windows. The source code is based on monsterwm-xcb, but includes a lot of bugfixes and additonal features like extensive runtime configuration, a scratchpad window, window minimizing, floating control via keyboard and currently 13 different tiling layouts.<br />
<br />
== Installation ==<br />
<br />
You can get FrankenWM by [[install]]ing the {{AUR|frankenwm-git}} package or directly from [https://github.com/sulami/FrankenWM Github]. Any Configuration has to be done at compile time, so you might want to have a look at the section below.<br />
<br />
=== AUR ===<br />
<br />
When using the AUR-version, you can supply you own {{ic|config.h}} which will be used instead of the default config.<br />
<br />
=== Git ===<br />
<br />
{{Note| Compiling manually requires you to get the dependencies needed yourself, which are {{ic|libxcb xcb-util xcb-util-wm xcb-util-keysyms}} (as well as {{ic|make}} and {{ic|gcc}}).}}<br />
<br />
When using the Git-version, you will need to copy {{ic|config.def.h}} to {{ic|config.h}} and make the modifications you need before compiling FrankenWM. Then you can run {{ic|make}} and {{ic|sudo make install}} to install the binaries and manpage.<br />
<br />
=== Launching FrankenWM ===<br />
<br />
FrankenWM is usually started using the {{ic|.xinitrc}}, either manually via {{ic|startx}} or automatically using a display manager like {{ic|slim}} or {{ic|lightdm}}.<br />
<br />
== Configuration ==<br />
<br />
Configuration is done at compile time by edititing {{ic|config.h}}. There are lots of comments in the default config ({{ic|config.def.h}}) which explain what the settings are doing.<br />
<br />
== Usage ==<br />
<br />
The basic usage includes opening a terminal ({{ic|Meta+Enter}}), opening dmenu ({{ic|Meta+r}}) and closing windows ({{ic|Meta+c}}). There is a complete, sorted list of the default keybinds and explanations of the tiling layouts in the manpage, which you can view with {{ic|man ./frankenwm.1}} before install, or {{ic|man frankenwm}} after install.<br />
<br />
== Panels ==<br />
<br />
FrankenWM does not come with a panel included, but gives you the possibility to leave space either at the top or bottom for one, like {{ic|conky}} or {{ic|dzen}}. There are a couple of settings in the config to configure this space.<br />
<br />
If you want to use FrankenWM's status in your bar, you can pipe FrankenWM to a shell script to parse the output and pipe it to a bar. Sample scripts to accomplish this with a few different bar are located [https://gist.github.com/sulami/d6a53179d6d7479e0709 here].<br />
<br />
== Troubleshooting ==<br />
<br />
=== I do not see anything ===<br />
<br />
This is normal behaviour, as FrankenWM does not come with a bar included or a desktop background, so after running {{ic|frankenwm}} without anything else, you will probably see a black screen. See Panels above for information on how to add a panel to your desktop. Wallpapers can be set by using software like xsetroot, feh or hsetroot.<br />
<br />
=== I cannot open a terminal/menu ===<br />
<br />
Have a look at the {{ic|config.h}} used to build your currently running version of FrankenWM, which is located in the build directory. Make sure that both the shortcut to run the {{ic|termcmd}}/{{ic|menucmd}} command and the {{ic|termcmd}}/{{ic|menucmd}} itself are set properly to start an installed terminal/menu.</div>Sampctech