dwm

dynamic window manager
git clone git://git.yotsev.xyz/dwm.git
Log | Files | Refs | README | LICENSE

README (2580B)


      1 dwm - dynamic window manager
      2 ============================
      3 dwm is an extremely fast, small, and dynamic window manager for X.
      4 
      5 This is my personal fork of it. The default window layout is a
      6 modification of gaplessgrid that only allows for two columns. (I find
      7 this to be the best layout when working mainly with terminals) There
      8 are no borders, the active and inactive windows are distinguished by dim
      9 from a compositor. The color scheme is monokai, although there isn't
     10 much to color in a window manager. It uses the "Liberation" font by
     11 default so you should install it or change it to something you have (or
     12 simply "monospace"). The patches applied are:
     13 
     14 * colorbar
     15 * gaplessgrid (modified)
     16 * swallow
     17 * alwayscenter
     18 * shiftview
     19 * movestack
     20 
     21 This fork is meant to run alongside sxhkd and therefore provides the
     22 most minimal set of key bindings possible. You should use sxhkd for
     23 anything else (like opening a terminal).
     24 
     25 
     26 Requirements
     27 ------------
     28 In order to build dwm you need the Xlib header files.
     29 
     30 
     31 Installation
     32 ------------
     33 Edit config.mk to match your local setup (dwm is installed into
     34 the /usr/local namespace by default).
     35 
     36 Afterwards enter the following command to build and install dwm (if
     37 necessary as root):
     38 
     39     make clean install
     40 
     41 Post-installation (from local changes)
     42 --------------------------------------
     43 You need to setup a compositor with inactive dim (such as picom). As it
     44 is currently, dwm doesn't support the proper EWMH tags (even with the
     45 patch) so the dim from picom catches the status bar. A quick and dirty
     46 fix is to add an exception within picom's config:
     47 
     48     focus-exclude = "x = 0 && y = 0 && override_redirect = true";
     49 
     50 Then you should add the following line to your .xinitrc in order to
     51 change the background color to be the same one as the status bar's:
     52 
     53     hsetroot -solid "#272822" &
     54 
     55 (You might have to install hsetroot.)
     56 
     57 Running dwm
     58 -----------
     59 Add the following line to your .xinitrc to start dwm using startx:
     60 
     61     exec dwm
     62 
     63 In order to connect dwm to a specific display, make sure that
     64 the DISPLAY environment variable is set correctly, e.g.:
     65 
     66     DISPLAY=foo.bar:1 exec dwm
     67 
     68 (This will start dwm on display :1 of the host foo.bar.)
     69 
     70 In order to display status info in the bar, you can do something
     71 like this in your .xinitrc:
     72 
     73     while xsetroot -name "`date` `uptime | sed 's/.*,//'`"
     74     do
     75     	sleep 1
     76     done &
     77     exec dwm
     78 
     79 Or you can install my fork of dwmblocks.
     80 https://git.yotsev.xyz/dwmblocks
     81 
     82 Configuration
     83 -------------
     84 The configuration of dwm is done by creating a custom config.h
     85 and (re)compiling the source code.