💠 AxisDWM: A minimal, keyboard-driven dwm fork with a pastel Gruvbox‑Catppuccin hybrid theme, sensible defaults, and an elegant, info‑rich status bar.
- Sleek Aesthetics: Warm pastel tones inspired by Gruvbox and Catppuccin make your workspace a joy to use.
- Performance‑First: Hand‑patched dwm keeps your system responsive and lightning‑fast.
- Out‑of‑the‑Box Usability: Thoughtful defaults and ergonomic keybindings let you dive straight into work.
- Modular Status Bar: Easily extend or swap modules to display volume, brightness, Wi-Fi, updates, and more.
| Feature | Description |
|---|---|
| 🎨 Color Scheme | Gruvbox‑Catppuccin hybrid with customizable accents. |
| 🧩 Patched dwm | Includes status2d, vanitygaps, movestack, barpadding, notitle, underline-tags, and more. |
| 🖥️ Tag Icons | Semantic workspaces with Nerd Font icons for code, browsing, chat, etc. |
| 🏷️ Intelligent Rules | Auto‑assign apps (Firefox, Telegram, Obsidian) to specific tags. |
| 📊 Dynamic Status Bar | Bash‑based script with modules for system stats, package updates, and notifications. |
| ⌨️ Ergonomic Keybindings | Super‑key driven commands for window management, layouts, and scripts. |
-
Clone repository
git clone https://github.com/df1gg/axis-dwm.git ~/.config/axisdwm cd ~/.config/axisdwm
-
Install dependencies (Arch Linux)
sudo pacman -S --needed base-devel xorg xorg-xinit libx11 libxft libxinerama \ xorg-xsetroot alsa-utils lm_sensors libxkbfile brightnessctl pamixer flameshot slock nerd-fonts-jetbrains-mono
-
Build and install
sudo make clean install
-
Enable in
.xinitrcexec dwm -
Start
startx
Tip: Use your favorite display manager by pointing its session file to this configuration.
-
Keybindings: See
config.hfor a complete list. Common shortcuts:Super+Enter: Launch your default terminal (st)Super+p: dmenuSuper+Shift+c: Close windowSuper+j/k: Navigate windowsSuper+Space: Cycle layouts
-
Status Bar: Modify
scripts/status.shto add/remove modules. Use^c/^bfor color control. -
Customize Bar Colors: Edit
scripts/bar_themes/gruvboxto tweak palette.
- Fork the repo
- Create a feature branch (
git checkout -b feature/awesome) - Commit your changes (
git commit -m "Add awesome feature") - Push to the branch (
git push origin feature/awesome) - Open a Pull Request 🚀
- Report issues or request features via GitHub Issues
AxisDWM is MIT licensed. See LICENSE for details.
Ready to transform your Linux experience? ⭐ Star this repo and let AxisDWM become the centerpiece of your workflow!

