mfwm

A tiling fork of dylanaraps sowm.
git clone git://depsterr.com/git/mfwm
Log | Files | Refs | README | LICENSE

README.md (3501B)


      1 # sowm (*~~Simple~~ Shitty Opinionated Window Manager*)
      2 
      3 <a href="https://user-images.githubusercontent.com/6799467/66687576-9747c200-ec72-11e9-947d-5b96753eab03.jpg"><img src="https://user-images.githubusercontent.com/6799467/66687576-9747c200-ec72-11e9-947d-5b96753eab03.jpg" width="43%" align="right"></a>
      4 
      5 An itsy bitsy floating window manager (*220~ sloc!*).
      6 
      7 - Floating only.
      8 - Fullscreen toggle.
      9 - Window centering.
     10 - Mix of mouse and keyboard workflow.
     11 - Focus with cursor.
     12 - Rounded corners (*[through patch](https://github.com/dylanaraps/sowm/pull/58)*)
     13 - Titlebars (*[through patch](https://github.com/dylanaraps/sowm/pull/57)*)
     14 
     15 <a href="https://user-images.githubusercontent.com/6799467/66687814-8cd9f800-ec73-11e9-97b8-6ae77876bd1b.jpg"><img src="https://user-images.githubusercontent.com/6799467/66687814-8cd9f800-ec73-11e9-97b8-6ae77876bd1b.jpg" width="43%" align="right"></a>
     16 
     17 - Alt-Tab window focusing.
     18 - All windows die on exit.
     19 - No window borders.
     20 - [No ICCCM](https://web.archive.org/web/20190617214524/https://raw.githubusercontent.com/kfish/xsel/1a1c5edf0dc129055f7764c666da2dd468df6016/rant.txt).
     21 - No EWMH.
     22 - etc etc etc
     23 
     24 
     25 <br>
     26 
     27 Patches available here: https://github.com/dylanaraps/sowm/pulls
     28 
     29 ## Default Keybindings
     30 
     31 **Window Management**
     32 
     33 | combo                      | action                 |
     34 | -------------------------- | -----------------------|
     35 | `Mouse`                    | focus under cursor     |
     36 | `MOD4` + `Left Mouse`      | move window            |
     37 | `MOD4` + `Right Mouse`     | resize window          |
     38 | `MOD4` + `f`               | maximize toggle        |
     39 | `MOD4` + `c`               | center window          |
     40 | `MOD4` + `q`               | kill window            |
     41 | `MOD4` + `1-9`             | desktop swap           |
     42 | `MOD4` + `Shift` +`1-9`    | send window to desktop |
     43 | `MOD1` + `TAB` (*alt-tab*) | focus cycle            |
     44 
     45 **Programs**
     46 
     47 | combo                    | action           | program        |
     48 | ------------------------ | ---------------- | -------------- |
     49 | `MOD4` + `Return`        | terminal         | `st`           |
     50 | `MOD4` + `d`             | dmenu            | `dmenu_run`    |
     51 | `MOD4` + `p`             | scrot            | `scr`          |
     52 | `MOD4` + `w`             | wallpaper cycler | `bud`          |
     53 | `XF86_AudioLowerVolume`  | volume down      | `amixer`       |
     54 | `XF86_AudioRaiseVolume`  | volume up        | `amixer`       |
     55 | `XF86_AudioMute`         | volume toggle    | `amixer`       |
     56 | `XF86_MonBrightnessUp`   | brightness up    | `bri`          |
     57 | `XF86_MonBrightnessDown` | brightness down  | `bri`          |
     58 
     59 
     60 ## Dependencies
     61 
     62 - `xlib` (*usually `libX11`*).
     63 
     64 
     65 ## Installation
     66 
     67 1) Copy `config.def.h` to `config.h` and modify it to suit your needs.
     68 2) Run `make` to build `sowm`.
     69 3) Copy it to your path or run `make install`.
     70     - `DESTDIR` and `PREFIX` are supported.
     71 4) (Optional) Apply patch with `git apply patches/patch-name`
     72     - In case of applying multiple patches, it has to be done **manually**.
     73 
     74 If you are using GDM, save the following to `/usr/share/xsessions/sowm.desktop`. It is still recommended to start `sowm` from `.xinitrc` or through
     75 [your own xinit implementation](https://github.com/dylanaraps/bin/blob/dfd9a9ff4555efb1cc966f8473339f37d13698ba/x).
     76 
     77 ```
     78 [Desktop Entry]
     79 Name=sowm
     80 Comment=This session runs sowm as desktop manager
     81 Exec=sowm
     82 Type=Application
     83 ```
     84 
     85 
     86 ## Thanks
     87 
     88 - 2bwm
     89 - SmallWM
     90 - berry
     91 - catwm
     92 - dminiwm
     93 - dwm
     94 - monsterwm
     95 - openbox
     96 - possumwm
     97 - swm
     98 - tinywm