suckless_conf

Overview

this is a personal configuration and patched build of dwm, st, dmenu, and dwmblocks.

The repository keeps the suckless style: the behavior is changed directly through C headers/source patches, then the programs are rebuilt.

Usage

dwm shortcuts

The main modifier is Super.

• Super + d: open dmenu_run
• Super + Return: open st
• Super + b: toggle the bar
• Super + j: focus the next window
• Super + k: focus the previous window
• Super + h: decrease the master area size
• Super + l: increase the master area size
• Super + i: toggle between one and two master windows
• Super + Return: zoom the focused window into the master area
• Super + Tab: switch back to the previous tag view
• Super + q: close the focused window
• Super + Shift + q: quit dwm
• Super + t: use tiled layout
• Super + f: use floating layout
• Super + m: use monocle layout
• Super + Space: cycle layout
• Super + Shift + Space: toggle floating for the focused window
• Super + s: toggle sticky mode for the focused window
• Super + comma: focus the previous monitor
• Super + period: focus the next monitor
• Super + Shift + comma: move the focused window to the previous monitor
• Super + Shift + period: move the focused window to the next monitor

Status and hardware bindings:

• Super + n: open the WiFi/Network status menu
• Super + p: open the power status menu
• volume up/down/mute keys: control PulseAudio volume through pactl (these are optional)
• Print: save a full screenshot under $HOME/pics/screenshot
• Control + Print: select an area and save the screenshot
• Shift + Print: copy a full screenshot to the clipboard
• Control + Shift + Print: select an area and copy it to the clipboard

Mouse bindings:

• left click the layout symbol: cycle layout
• right click the layout symbol: switch to monocle
• middle click the window title: zoom the focused window
• click the status bar: send the click to dwmblocks
• Super + left mouse on a window: move it
• Super + middle mouse on a window: toggle floating
• Super + right mouse on a window: resize it
• left click a tag: view it
• right click a tag: toggle it
• Super + left click a tag: move the focused window to it
• Super + right click a tag: toggle the focused window on it

st shortcuts

The terminal uses FiraCode Nerd Font and a dark gray / pastel green palette.

• Control + Shift + PageUp: increase font size
• Control + Shift + PageDown: decrease font size
• Control + Shift + Home: reset font size
• Control + Shift + c: copy selection
• Control + Shift + v: paste from clipboard
• Control + Shift + y: paste selection
• Shift + Insert: paste selection
• Shift + PageUp: scroll up
• Shift + PageDown: scroll down
• mouse wheel: scroll through terminal history
• Shift + mouse wheel: send terminal page-up/page-down escape sequences

dmenu

dmenu is configured as a centered launcher instead of the default thin top bar.

• centered window
• 960px configured width
• 720px configured height
• 2px pastel green border
• 21 visible lines
• 3 grid columns
• FiraCode Nerd Font
• dark gray normal background with pastel green selection

dwmblocks

The status bar is built from four blocks:

• WiFi status, interval 0, signal 1
• disk usage for /, refreshed every 60 seconds, signal 6
• power status, interval 0, signal 2
• clock, interval 0, signal 7

The WiFi and power blocks are click-aware. They receive click data from dwm, then use that to open small menus/actions near the clicked status block.

Patches and custom additions

dwm

• alpha/bar-alpha support for transparent or alpha-aware bar drawing
• status2d-style status rendering with inline color/control sequences
• statuscmd-style click handling for sending mouse clicks to dwmblocks
• sticky-window support through Super + s
• a custom tilewide layout using the [][]= symbol
• a custom togglenmaster helper that switches between one and two master windows
• bar padding values for tag/status spacing
• rules for Gimp, Firefox, and Discord
• screenshot bindings using maim and xclip
• volume bindings using pactl

st

• alpha support with alpha = 0.8
• scrollback support through keyboard and mouse bindings
• anysize-style terminal alignment so spare pixels can be centered instead of forced to one side
• Harfbuzz integration for better glyph shaping and ligatures
• graphics/image support, including image placeholders, image cache limits, and redraw support
• pastel terminal palette matching the desktop theme
• clipboard and selection shortcuts
• Shift-based mouse behavior for terminal applications that capture the mouse

dmenu

• centered-window support
• configurable menu width and height
• border support with a pastel green border
• grid display support through multiple columns
• fixed FiraCode Nerd Font configuration
• matching dark gray and pastel green palette

dwmblocks

• WiFi, disk, power, and clock blocks
• realtime signal updates
• click handling with button and x-position forwarding from dwm
• WiFi and power scripts that can show menus/actions instead of only printing static text

Installation

The repository includes an install script that builds and installs dmenu, dwm, dwmblocks, and st.

Visit the repository for source and setup instructions.