A source-driven Linux desktop engineering project that turns
dwm,st, anddmenuinto a cohesive, reproducible workstation on Void Linux.
Void System is a custom desktop stack built on the Suckless toolchain and tuned for keyboard-first engineering workflows. Instead of layering heavyweight desktop abstractions, it composes a minimal window manager, terminal, launcher, and shell scripts into a maintainable system that can be rebuilt from source at any time.
It focuses on:
- Deterministic behavior through compile-time configuration (
config.h,config.mk). - Low-overhead UX with direct X11 event handling and minimal background services.
- Operational tooling for day-to-day tasks (status telemetry, power actions, removable media).
Real-world use cases:
- Software engineering sessions with multiple tiled terminals, browser windows, and file explorers.
- Laptop workflows that need fast suspend/reboot controls and live battery/network visibility.
- Long-running work sessions where preserving workspace tags after window manager restart reduces context loss.
This timeline preserves context from the original root README and links it to detailed docs:
2023-09-23: Addeddwmandstas the base desktop runtime.2023-09-24: Added NoBorder and SplitStatus fordwm, plus ScrollBack forst(see Patch Chronology).2023-09-26: Added FakeFullScreen and HideVacantTags fordwm(see Patch Catalog).2023-09-27: Added Alpha and PreserveOnRestart fordwm(see Patch Catalog).2023-10-02: Addeddmenuto complete launcher/control workflows (see System Configuration Guide).
The system architecture is shown below.
The diagram captures session bootstrap, runtime services, status telemetry flow, and the source-level patch/configuration layer.
- Patch-integrated
dwmbehavior for hide-vacant-tags, split-status support, alpha bar rendering, and restart tag preservation. - Keyboard-centric navigation and task execution through
dwmkeymaps plussxhkdhotkeys. - Real-time status bar pipeline with RAM, CPU, battery, network, volume, USB mount state, and clock updates.
- Minimal control utilities for power operations and USB mount/unmount flows using
dmenuas the command surface. - Multi-monitor support via Xinerama-enabled builds.
- Uses source-level configuration (
config.h) over runtime theme frameworks to keep behavior auditable and diffable. - Implements workspace continuity through
_NET_CLIENT_INFOtag/monitor properties indwm, reducing disruption during recompiles and restarts. - Keeps the status path lightweight by writing directly to X root window name (
xsetroot) once per second. - Separates concerns cleanly: core WM logic in C, operator workflows in POSIX shell, and environment bootstrap in dotfiles.
- Balances aesthetics and performance by combining alpha patches in
dwmandstwithpicomblur/opacity policies.
- Language: C (Suckless components), POSIX shell (automation scripts)
- Platform: Void Linux, X11
- Windowing/UI:
dwm6.4,st0.9,dmenu5.2 - Graphics/Text: Xlib, Xft, Xrender, Fontconfig, Freetype
- Runtime tooling:
sxhkd,picom, PulseAudio/ALSA utilities,xsetroot,lsblk,notify-send - Build system: Make (
make,make install)
Install required build and runtime dependencies on Void Linux:
sudo xbps-install -S base-devel git pkg-config \
libX11-devel libXft-devel libXinerama-devel \
fontconfig-devel freetype-devel \
xorg picom sxhkd xwallpaper dmenugit clone <repo-url>
cd Void-System
cd dwm && sudo make clean install && cd ..
cd st && sudo make clean install && cd ..
cd dmenu && sudo make clean install && cd ..mkdir -p ~/.config/sxhkd ~/.config/picom ~/.local/bin
cp configurations/.bashrc ~/.bashrc
cp configurations/.bash_profile ~/.bash_profile
cp configurations/.xinitrc ~/.xinitrc
cp configurations/.config/sxhkd/sxhkdrc ~/.config/sxhkd/sxhkdrc
cp configurations/.config/picom/picom.conf ~/.config/picom/picom.conf
cp scripts/*.sh ~/.local/bin/
chmod +x ~/.local/bin/*.sh- Log in on
tty1;.bash_profiletriggersstartx, which launches the configureddwmsession. - Use
Super + Returnfor terminal,Super + pfor launcher, and configured hotkeys for USB/audio/power controls.
- A reproducible, source-controlled desktop environment with no opaque GUI settings drift.
- Fast interaction model optimized for keyboard-driven multitasking and development workflows.
- Session resilience: tag assignments are preserved across
dwmrestarts through EWMH client metadata. - Low runtime overhead with a simple status telemetry loop and minimal background services.
- Clear customization traceability through versioned patch artifacts and explicit configuration files.
