gh0stzk/dotfiles is a BSPWM window manager configuration that provides a complete desktop environment with 18 themes and a theme switcher.
The project addresses the need for a lightweight, visually cohesive desktop setup by bundling BSPWM with a modular theming system. Rather than extracting colors from wallpapers like Pywal or Matugen, the tool uses handcrafted color palettes for each theme. A theme selector allows switching between all 18 themes instantly without restarting the session, and the modular system propagates colors across the entire environment including GTK, terminal emulators, Neovim, Rofi, Polybar, Firefox, and numerous other applications and tools.
This configuration suits Linux users who want a minimal window manager setup with visual polish and consistency. It works well for those comfortable with tiling window managers and who value low resource usage—the environment runs under 600 MB of RAM. The approach differs from wallpaper-based theming tools by maintaining handcrafted, carefully selected color palettes that ensure readability and visual appeal across all components. The project includes a wiki covering first steps for new window manager users, keyboard shortcuts, and frequently asked questions.
The project maintains active development with regular updates to the theming system and module support. Documentation is comprehensive, including detailed wiki pages on color modules, Firefox theming, and configuration options. The codebase is written primarily in Shell, reflecting the straightforward scripting approach needed for theme switching and environment configuration.
