Skip to content
vq6oonPublic

About

dwm with dynamic wallpaper colors, a custom status bar and a little cat ๐Ÿพ

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

ย 

History

85 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

dwm rice

My personal dwm setup with all patches already applied. No manual patching needed, just clone, build, and go.

dwm screenshot

Patches

The patches/ folder is kept for reference and credit only. They are already applied to the source.

Dependencies

Build:

sudo apt install build-essential libx11-dev libxft-dev libxinerama-dev git fontforge python3-fontforge fonts-font-awesome

Programs used by the keybindings (install what you need, or change them in config.h):

sudo apt install dmenu kitty thunar scrot maim xclip brightnessctl alsa-utils network-manager bluez rfkill power-profiles-daemon picom

Firefox, VS Code, Discord, Spotify and OBS are launched by name, so install them separately or edit config.h.

The optional extras at the bottom list their own dependencies.

Font

The layout symbols are cat glyphs from waycat by CarloCattano. Each layout gets a different frame: running cats for tile and floating, a sleeping cat for monocle. The original font maps its frames to plain letters, which clashes with normal text in dwm, so the glyphs are moved to the private use area first. The font file is not included in this repo, the script below builds it from the original:

./fonts/install-waycat.sh

Check that it is installed:

fc-list | grep -i waycat

Without the font, the layout symbols show an empty box. To skip it, edit the layouts[] array in config.h and remove the \uE000, \uE002 and \uE010 glyphs.

Installation

For the full desktop setup (wallpaper themes, picom profiles, screenshots, and application configs), see vq6oon/dotfiles. This repository contains only dwm source, patches, and build assets.

git clone https://github.com/vq6oon/dwm.git
cd dwm
./fonts/install-waycat.sh
sudo make clean install

Create the folder used by the screenshot keys:

mkdir -p ~/Pictures/Screenshots

Then start dwm. With startx, add this line to ~/.xinitrc:

exec dwm

With a display manager, add a session entry at /usr/share/xsessions/dwm.desktop:

[Desktop Entry]
Name=dwm
Comment=dynamic window manager
Exec=dwm
Type=Application

Programs that should start at login go in ~/.xsessionrc for a display manager, or in ~/.xinitrc before exec dwm for startx. Full desktop autostart and theme setup live in dotfiles.

Status bar

The status bar is a separate project: sxstatus. The wifi, bluetooth, power profile, picom and camera mirror keys below call its dmenu menus, and the emoji picker uses its dmenu_sx for colors, so clone it to ~/.config/sxstatus. Its icons come from Font Awesome, which is already in fonts[] in config.h.

Keybindings

Super is the modifier (MODKEY in config.h).

Applications

Keybind Action
Super + P Launcher (dmenu)
Super + T Terminal (kitty)
Super + B Browser (firefox)
Super + C Editor (code)
Super + E File manager (thunar)
Super + D Discord
Super + M Spotify
Super + R OBS Studio
Super + V Emoji picker (see below)
Super + Shift + C Mirror camera menu: on / off (see below)
Super + F Mouse driver (Fantech X9 Thor, personal, change or remove in config.h)

Workspaces

Each workspace remembers its own layout, master size and master count (pertag).

Keybind Action
Super + 1~9 Go to workspace 1~9
Super + Shift + 1~9 Move window to workspace 1~9
Super + Ctrl + 1~9 Show workspace 1~9 in addition to the current one
Super + Ctrl + Shift + 1~9 Toggle window on workspace 1~9
Super + Tab Go to previously active workspace
Super + 0 View all workspaces
Super + Shift + 0 Show window on all workspaces

Windows

Keybind Action
Super + J / K Focus next / previous window
Super + Shift + J / K Move window down / up the stack
Super + Return Promote focused window to master area
Super + H / L Decrease / increase master area size
Super + I / O Increase / decrease number of master windows
Super + Q Close window
Super + Shift + T Tiled layout
Super + Shift + F Floating layout
Super + Shift + M Monocle (fullscreen) layout
Super + Space Toggle between current and previous layout
Super + Shift + Space Toggle floating mode for window
Super + - / = Decrease / increase gaps
Super + Shift + = Reset gaps
Super + Arrows Move floating window
Super + Shift + Arrows Resize floating window
Super + Ctrl + Arrows Move floating window to screen edge
Super + Ctrl + Shift + Arrows Stretch floating window to screen edge

Monitors

Keybind Action
Super + , / . Focus previous / next monitor
Super + Shift + , / . Send window to previous / next monitor

Screenshots

Screenshots go to ~/Pictures/Screenshots.

Keybind Action
Super + Print Screenshot, full screen
Super + Shift + Print Screenshot, select region (saved and copied to clipboard)

Hardware and network

Keybind Action
Super + F6 / F5 Volume up / down
Super + F3 Toggle mute
Super + F9 / F8 Brightness up / down
Super + F10 Caffeine toggle (block screen blank / DPMS)
Super + N Wifi menu
Super + Shift + N Toggle wifi
Super + G Bluetooth menu
Super + Shift + G Toggle bluetooth

System

There is no confirmation for reboot and shutdown.

Keybind Action
Super + Y Theme menu: light / dark
Super + Shift + Y Toggle theme (light / dark)
Super + Shift + P Power profile menu (needs power-profiles-daemon)
Super + Ctrl + P Picom mode menu: blur + opacity + vsync, opacity + vsync, vsync only, off
Super + Shift + B Toggle status bar
Super + Shift + F5 Reload bar colors from X resources
Super + Shift + R Reboot
Super + Shift + S Shutdown
Super + Shift + Q Quit dwm

Theme from wallpaper (optional)

Bar colors can follow the wallpaper using pywal and the xrdb patch. The complete theme scripts and pywal templates are in vq6oon/dotfiles; install the dotfiles repo to use them. The status bar from sxstatus, notifications, kitty, and Firefox can follow the generated palette too.

For manual startup ordering, merge the generated dwm colors before starting dwm and sxstatus:

xrdb -merge ~/.cache/wal/dwm-xres
~/.local/bin/theme-watch &

The dotfiles repo owns wallpaper watcher/theme commands and pywal templates. This repo only contains dwm's xrdb integration. Without pywal, dwm uses the colors in config.h.

To make kitty follow wallpaper colors, add include ~/.cache/wal/colors-kitty.conf to ~/.config/kitty/kitty.conf. Pywalfox is separately needed for Firefox wallpaper colors.

Emoji picker (optional)

Type emoji in any app with Super + V, using bemoji and dmenu.

sudo apt install xclip xdotool curl fonts-noto-color-emoji
git clone https://github.com/marty-oehme/bemoji /tmp/bemoji
install -m 755 /tmp/bemoji/bemoji ~/.local/bin/bemoji

The emoji list is downloaded on first run, so it needs an internet connection once.

Mirror camera (optional)

Super + Shift + C opens a menu to start or stop a mirrored copy of the webcam on a v4l2loopback device. Pick that loopback camera in your video app, not the real one, which ffmpeg holds while the mirror is on. The menu comes from sxstatus. Set Cam and Out at the top of menus/cam_menu: use the stable path from ls /dev/v4l/by-id/ (the one ending in index0) for the camera, because /dev/videoN numbers change between reboots.

sudo apt install ffmpeg v4l2loopback-dkms v4l-utils
sudo modprobe v4l2loopback video_nr=10 card_label="Mirror Cam" exclusive_caps=1

To load the module at every boot, put the options in /etc/modprobe.d/v4l2loopback.conf:

options v4l2loopback video_nr=10 card_label="Mirror Cam" exclusive_caps=1

and the module name in /etc/modules-load.d/v4l2loopback.conf:

v4l2loopback

Transparency and blur (optional)

Opacity and blur come from picom, not from dwm. Ready-made picom profiles live in dotfiles, not in this dwm repo. The profiles range from vsync-only to dual kawase blur:

Mode What it does
vsync vsync only, no transparency
opacity vsync and 0.8 window opacity
blur opacity and dual kawase blur, without vsync
blurvsync opacity, dual kawase blur and vsync (heaviest)
sudo apt install picom

Use the picom profiles provided by the dotfiles repo. The profile menu is part of the sxstatus submodule.

Super + Ctrl + P opens a menu to switch between the modes or turn picom off, and the choice is remembered for the next login. The menu comes from sxstatus. To start the last chosen mode at login, add this to ~/.xsessionrc:

~/.config/sxstatus/menus/picom_menu restore &

Blur is heavy on the GPU and can cause stutter and audio crackle while screen sharing or mirroring a phone with scrcpy. Use the vsync mode or turn picom off while streaming.

Configuration

All settings live in config.h (config.def.h is kept in sync). Edit it, then rebuild with sudo make clean install and restart dwm.

Dotfiles

This repository focuses on dwm. Shared desktop configuration, pywal theme scripts/templates, picom profiles, and the screenshot are maintained separately in vq6oon/dotfiles.

Credits

Based on dwm by suckless.org. Original license is in LICENSE, original readme in README.dwm.

Cat font by CarloCattano/waycat. Wallpaper colors by pywal. Emoji picker by bemoji.

About

dwm with dynamic wallpaper colors, a custom status bar and a little cat ๐Ÿพ

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages