Dotfiles

A minimal, laptop-friendly BSPWM rice with EWW widgets, focused on stability and simplicity.

Quick Start · Features · Preview · Configuration

---

Overview

This is a streamlined and customized version of gh0stzk's dotfiles, rebuilt with a focus on stability, minimalism and laptop compatibility.

While the original project is an incredible showcase of ricing (featuring 18 unique themes across EWW and Polybar), it relies heavily on custom package sources like the gh0stzk-dotfiles pacman repo and chaotic-aur. Because I prefer to keep my core system free of third-party repositories, I created this standalone version.

Preview

Features

• Window Manager: BSPWM - A tiling window manager that represents windows as leaves of a binary tree.
• Widgets & Bar: EWW - Side/Top bar (workspace highlighting, battery, brightness, volume, network) plus custom widgets for system info, media player, calendar, and more.
• Terminal: Alacritty & Kitty configurations with custom themes.
• Launcher: Rofi for application launching and window switching.
• Fetch Tool: Custom sysfetch script for a clean system overview.
• Theme Engine: Includes the z0mbi3 (minimal) and andrea rices with easy switching via a custom script.
• Notifications: Dunst for lightweight and customizable desktop notifications.

Quick Start

Prerequisites

This rice is built for an Arch Linux or Arch-based distribution (e.g., CachyOS, EndeavourOS, Manjaro).

Warning

Do NOT run the install scripts as root.

Installation

1. Clone the repository:

   git clone https://github.com/ussooraj/bspwm-dotfiles.git
   cd bspwm-dotfiles

2. Run the automated installer:

   ./install.sh

   The installer will:

   • Install all core and AUR dependencies.
   • Install optional packages (SDDM, btop, etc.) based on your input.
   • Backup your existing configurations to ~/.RiceBackup/.
   • Deploy all configuration files.
   • Enable necessary services (mpd, mpDris2).

3. Reboot:

   After installation, log out and select bspwm from your display manager, or simply reboot.

Configuration

All configuration files are stored in the config/ directory and map directly to ~/.config/ after installation.

Component	Description	Configuration Files
BSPWM	Tiling window manager	bspwmrc
SXHKD	Hotkey daemon	sxhkdrc
EWW	Widgets and status bar	eww/
Dunst	Notification daemon	dunstrc
Picom	Compositor for transparency & effects	picom.conf
Rofi	Application launcher	rofi-themes/
Alacritty	Terminal emulator	alacritty.toml
Kitty	Terminal emulator	kitty.conf
Zsh	Shell configuration	.zshrc
GTK	GTK theme settings	settings.ini

Keybindings

Default keybindings are managed via SXHKD. Refer to config/bspwm/config/sxhkdrc for the full list.

Keybinding	Action
Alt + F1	Show keybindings cheatsheet
Super + Return	Launch terminal (Alacritty)
Super + Alt + Return	Launch floating terminal
Super + D	Launch Rofi app launcher
Super + Ctrl + U	Open EWW profile card
Super + Ctrl + C	Open EWW calendar
Super + B	Launch browser
Super + Alt + {H,U}	Hide / unhide bar
Super + Q	Close focused window
Super + Shift + Q	Kill focused window
Super + {Left,Down,Up,Right}	Change window focus
Super + Shift + {Left,Down,Up,Right}	Move floating window
Super + Alt + {Plus,Minus}	Resize window
Super + {1-9,0}	Change workspace
Super + Shift + {1-9,0}	Move focused window to workspace
Alt + Space	Open theme selector (RiceSelector)
Super + R	Open theme editor (RiceEditor)
Super + Alt + S	Screenshot tool
Super + Alt + P	Power menu
Super + G	Toggle Game Mode
Super + Ctrl + N	Toggle Redshift (Night Mode)
XF86Audio{Raise,Lower}Volume	Volume control
XF86MonBrightness{Up,Down}	Brightness control
XF86AudioPlay, XF86AudioNext, XF86AudioPrev	Media control

Acknowledgements

• Original Creator: gh0stzk - The incredible foundation and inspiration for this setup.

License

This project is licensed under the GPL-3.0 License. See the LICENSE file for details.