dwm-jangir - Personal Desktop Environment

dwm-jangir is my personal, meticulously maintained X11 desktop environment. Forked from the popular dwm-titus project, this build is tailored specifically for my workflow, emphasizing rock-solid session reliability, automated system provisioning, and deep aesthetic customization.

Rather than just changing a few C headers, I maintain a strict "upstream delta" workflow, allowing me to continuously pull in upstream improvements while preserving my own extensive system modifications.

Key Engineering Enhancements

1. Robust Session Reliability

The default X11 startup sequence can be fragile. I heavily rewrote the autostart.sh and session management logic to ensure complete reliability on every login:

• Engineered an automated cleanup of stale Quickshell and Handy processes on relogin.
• Implemented strict startup ordering: the StatusNotifier watcher must initialize before launching tray-dependent apps like caffeine-ng.
• Ensured background services like RustDesk detach properly without blocking the window manager initialization.

2. Dynamic Theming & "Rajasthani" Theme

I built a dynamic theme application system (theme-apply.sh) that synchronizes colors across the entire desktop environment.

• Integrated custom themes for modern terminals like Ghostty, Kitty, and Alacritty.
• Designed and implemented a custom Rajasthani theme, ensuring the Quickshell UI (Theme.qml) perfectly matches terminal color schemes on the fly.
• Customized the Quickshell panel branding to feature my personal rahuljangirwork.svg logo.

3. Quickshell Panel Optimization (QML)

To handle dynamic tray icons gracefully, I modified the QML configurations (TrayArea.qml) to reserve a deterministic panel width for all StatusNotifier items. This prevents the panel from jittering or resizing unexpectedly when background apps launch or close.

4. Automated Installation & VM Testing

I maintain a highly modified install.sh and a dedicated dwm-test-vm.sh script to automate the entire setup process.

• The installer natively pulls custom wallpapers from my personal background repository.
• System health checks (dwm-system-health) were fine-tuned to reduce noise and increase command timeouts for slower hardware.
• The setup strictly preserves personal configurations across fresh installations, making disaster recovery instantaneous.

Development Workflow

Maintaining a fork of an active upstream repository requires discipline. I track all my changes in a dedicated UPSTREAM-DELTA.md file and utilize an automated make check validation pipeline. This ensures that when I fetch upstream commits, my session reliability patches, dynamic themes, and custom installation logic remain completely intact.