xiwm

commit

437af966d1373e33d4d3b3f1bfe6c7d9e88ee4c0

parent

19e3f8cf07b60f7ca54baa6548fcdb61c364c2b1

Author

Tobias Bengfort <tobias.bengfort@posteo.de>

Date

2019-10-12 21:21

add README

Diffstat

1 files changed, 58 insertions, 0 deletions

diff --git a/README.md b/README.md

@@ -0,0 +1,58 @@
   -1     1 # xiwm
   -1     2 
   -1     3 This is a simple window manager I hacked together in my free time. It is based
   -1     4 on [dwm](https://dwm.suckless.org)'s code, but the functionality is more
   -1     5 influenced by [openbox](https://openbox.org).
   -1     6 
   -1     7 ## Features
   -1     8 
   -1     9 -	like dwm
   -1    10 	-	extremely small (only ~1000 lines of C, roughly half of dwm)
   -1    11 	-	supports tiling (see below for details)
   -1    12 	-	configured by editing the source code
   -1    13 -	like openbox
   -1    14 	-	reads `~/.config/xiwm/environment` and `~/.config/xiwm/autostart.sh`
   -1    15 	-	supports multiple desktops (instead of dwm's tags)
   -1    16 	-	works with external panels/bars (I use lxpanel)
   -1    17 -	no multi monitor support
   -1    18 
   -1    19 ## Default key bindings
   -1    20 
   -1    21 -	`A-C-t`     launch terminal
   -1    22 -	`W-r`       launch dmenu
   -1    23 -	`A-Tab`     focus next window
   -1    24 -	`A-S-Tab`   focus previous window
   -1    25 -	`A-l`       increase left column width
   -1    26 -	`A-h`       decrease left column width
   -1    27 -	`A-F4`      close window
   -1    28 -	`A-S-q`     quit
   -1    29 -	`W-F1`      go to desktop 1
   -1    30 -	`W-F2`      go to desktop 2
   -1    31 -	`W-F3`      go to desktop 3
   -1    32 -	`A-C-Right` go to next desktop
   -1    33 -	`A-C-Left`  go to previous desktop
   -1    34 -	`A-S-Right` move window to next desktop
   -1    35 -	`A-S-Left`  move window to previous desktop
   -1    36 -	`A-Down`    set window to floating mode
   -1    37 -	`A-Up`      maximize window
   -1    38 -	`A-Left`    move window to left column
   -1    39 -	`A-Right`   move window to right column
   -1    40 
   -1    41 ## Layout concept
   -1    42 
   -1    43 With floating window managers it is simple to control where an individual
   -1    44 window is, it is hard to control general properties such as avoiding overlap.
   -1    45 With tiling window managers it is simple to control exactly those general
   -1    46 properties. The flipside is that it gets much harder to position an individual
   -1    47 window.
   -1    48 
   -1    49 I usually have all my windows maximized. Just sometimes I want to position two
   -1    50 windows side by side. This works reasonably well with floating window managers,
   -1    51 but I wanted to see if I could improve on that.
   -1    52 
   -1    53 With xiwm, all windows start out maximized. However, you can position them on
   -1    54 the left or right. When you focus one of the positioned windows, all of them
   -1    55 are raised.
   -1    56 
   -1    57 I am not sure yet if the positioning should influence the tab order. Still
   -1    58 experimenting.