# dwm

**Repository Path**: tanloong/dwm

## Basic Information

- **Project Name**: dwm
- **Description**: my dwm fork
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-08-10
- **Last Updated**: 2026-02-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

[dwm](https://dwm.suckless.org) -- Dynamic Window Manager
=========================================================

1. Download

go to this [website](https://dwm.suckless.org), download the packed file

2. Default Keybindings

| shortcut               | action                                               |
|------------------------|------------------------------------------------------|
| `Alt`+`0`  | show all windows in all tags |
| `Alt`+`Return`         | to toggle a window between the master and stack area |
| `Alt`+`Shift` +N       | move current window to tag                           |
| `Alt`+`Shift` +`c`     | kill a window                                        |
| `Alt`+`Shift` +`q`     | quit dwm                                             |
| `Alt`+`Shift`+`Return` | open a terminal                                      |
| `Alt`+`d`/`i`          | to change the amount of windows in the master area   |
| `Alt`+`f`              | **floating** layout mode                             |
| `Alt`+`h`/`l`          | resize current window                                |
| `Alt`+`j`/`k`          | move around windows                                  |
| `Alt`+`m`              | **monocle** layout mode                              |
| `Alt`+`t`              | **tiled** layout mode                                |

3. Customized Shortcuts

#define Mod5Mask WINDO

|shortcut|action|
|-|-|
|`WINDO`+`z`| `gnome-terminal` |
|`WINDO` +`r` | screenkey-toggle.sh |
|`PrtSc` | flameshot gui -p $HOME |
|`WINDO` +`x`| chromium |
|`WINDO` +`c`| wps |
|`WINDO` +`space` | goldendict |
| `WINDO` +`k`  | run mapkey |
|`Alt` + `d`|`dmenu`|
| `Alt` +`a`  |  narrow borders |
| `Alt` +`s`  |  widen borders |
| `Alt` +`z`  |  default borders |
| `F11` | ~/scripts/brightness.py -0.05 |
| `F12` | ~/scripts/brightness.py 0.05 |
| `F1` | ~/scripts/vol-mute.sh |
| `F2` | ~/scripts/vol-down.sh |
| `F3` | ~/scripts/vol-up.sh |

4. What Did I Do

- [ ] set `gnome-terminal` instead of `st`, which although is also an awesome suckless software.
- [ ] define `WINDO` `Mod4Mask`
- [ ] set bar to display at bottom
- [ ] downloaded [xcompmgr](https://wiki.archlinux.org/title/Xcompmgr#Installation) for terminal transparency
- [ ] patched [autostart](https://dwm.suckless.org/patches/autostart/), [fullscreen](https://dwm.suckless.org/patches/fullscreen/), and [hide vacant tags](https://dwm.suckless.org/patches/hide_vacant_tags/)
- [ ] modified `dwm-status-refresh.sh` stolen from `thecw`; put the script together with `autostart.sh`, `dwm-status.sh` in `~/.config/dwm`; link the directory to `~/.dwm` (from whitch the `autostart` patch reads files)
- [ ] written `autostart.sh` for `autostart` and put the script in ~/.dwm/
- [ ] set colors
- [ ] wrote a `screenkey-toggle.sh` to start/kill screenkey
- [ ] use [slstatus](https://git.suckless.org/slstatus/) to manage statusbar

5. Patches Applied

<!-- [dwm-hide-and-restore.diff](<<>>) -->
- [dwm-autostart-20210120-cb3f58a.diff](https://dwm.suckless.org/patches/autostart/)
- [dwm-colorbar-6.2.diff](https://dwm.suckless.org/patches/colorbar/)
- [dwm-focusadjacenttag-6.0.diff](https://dwm.suckless.org/patches/focusadjacenttag/)
- [dwm-fullscreen-6.2.diff](https://dwm.suckless.org/patches/fullscreen/)
- [dwm-hide\_vacant\_tags-6.2.diff](https://dwm.suckless.org/patches/hide_vacant_tags/)
- [dwm-noborder-6.2.diff](https://dwm.suckless.org/patches/noborder/)
- [dwm-pertag-20200914-61bb8b2.diff](https://dwm.suckless.org/patches/pertag/)
- [dwm-viewontag-20210312-61bb8b2.diff](https://dwm.suckless.org/patches/viewontag/)

6. Some Notes

Ubuntu uses `gdm3` as display manager, to enter dwm on Ubuntu, edit `/usr/share/xsessions/dwm.desktop`

On Ubuntu system, `vol-toggle.sh` has a [problem](https://askubuntu.com/questions/65764/how-do-i-toggle-sound-with-amixer), which has been solved on `askubuntu.com`.

单个按键像 Fn 或者多媒体键必须要用 16 进制数来表示，可以用 xev 程序来获得。或者查看 /usr/include/X11/XF86keysym.h 中的定义。

`{ 0,                 0xff00,    spawn,       {.v = <keybindname> } }`

这会把 0xff00 键绑定到 <keybindname>。

7. Troubleshooting

failed to patch

empty gaps outside terminal windows

can't uute the PC with amixer after muting

the autostart does not work! -- make sure your autostart.sh is in <<>>, <<>>, or <<>>, and see if the script -- together with any other scripts called by it -- has exited accidentaly.

Putting a keyboard name that contain numbers such as `Mod4Mask` (Windows key) in the `Key` function would cause errors, define a `Mod4Mask` to `WINDOWS` instead.

if you want to map some keys like F11, use `xev` to get the hexadecimal numbers. or include `<X11/XF86keysym.h>` in config.h and use according codes in `/usr/include/X11/XF86keysym.h`

it is recommended that you make a backup for config.h before making new changes, in case you may want to retrieve some changes. using `git` to manage your `dwm/` folder would be a better option.

every time you make some changes to config.h, run `sudo make clean install` and restart dwm to load the changes.

8. References

archwiki
dwm.suckless.org
thecw's videos
kiteAB's videos
askubuntu.com

9. TODO