My Linux desktop config: bspwm + sxhkd + polybar, Alacritty, Zellij and Neovim. Colors follow pywal.
| Package | What |
|---|---|
bspwm |
Tiling WM, multi-monitor layout (monitors.sh), autostart |
wal |
pywal templates (polybar, dunst) + apply.sh hook that pushes each new palette to running apps |
sxhkd |
Keybindings |
polybar |
Status bar + scripts (Wi-Fi, VPN, battery, power menu, Claude usage) |
alacritty |
Terminal; colors follow pywal (imports ~/.cache/wal/colors-alacritty.toml) |
picom |
Compositor: transparency, dual_kawase blur, rounded corners, shadows |
zellij |
Terminal multiplexer, custom layout with zjstatus |
herdr |
Herdr agent workspace; terminal theme follows pywal |
nvim |
Neovim config on lazy.nvim, PHP/Laravel focused; catppuccin recolored from pywal |
vim |
Plain Vim on vim-plug; wal.vim colorscheme + airline theme |
starship |
Prompt; palette names mapped to ANSI so colors follow pywal |
dmenu |
Launcher + polybar menus via dmenu.sh wrapper: pywal colors, drawn over polybar on eDP (needs patched dmenu, see below) |
tealdeer |
tldr client; pages auto-update |
dunst |
Notifications; colors from pywal drop-in (template in wal), low battery fixed red |
yazi |
File manager; default ANSI theme + icons stripped of hex colors so all follow pywal |
Each top-level folder is a GNU Stow package mirroring $HOME.
git clone https://github.com/alibori/dotfiles.git ~/dotfiles
cd ~/dotfiles
stow wal bspwm sxhkd polybar alacritty zellij nvim picom herdr qutebrowser starship dmenu tealdeer vim dunst yazi
# zjstatus plugin for the zellij layout (not committed)
mkdir -p ~/.config/zellij/plugins
curl -L -o ~/.config/zellij/plugins/zjstatus.wasm \
https://github.com/dj95/zjstatus/releases/latest/download/zjstatus.wasm
# vim-plug (not committed), then install vim plugins
curl -fLo ~/.vim/autoload/plug.vim --create-dirs \
https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim
vim +PlugInstall +qa
# dmenu 5.3 + lineheight and alpha (0xcc, matches polybar) patches, into ~/.local/bin.
# Needs libxft-dev libxinerama-dev. Without the patches, stock dmenu still works (shorter, opaque).
git clone https://git.suckless.org/dmenu ~/repositories/dmenu && cd ~/repositories/dmenu
git checkout 5.3 # apply tools.suckless.org/dmenu/patches/{line-height,alpha}, set alpha = 0xcc in config.def.h
make && make PREFIX=~/.local installbspwm, sxhkd, polybar, dmenu (patched, see Install), zenity, picom, dunst, feh, maim, alacritty, zellij, neovim, starship, tealdeer, NetworkManager (nmcli), jq, curl, a Nerd Font.
Private values are kept out of git in polybar/.config/polybar/.env:
cp polybar/.config/polybar/.env.example polybar/.config/polybar/.env| Variable | Used by | Purpose |
|---|---|---|
OPENVPN_HOST |
scripts/wg-toggle.sh |
Kill orphaned openvpn client on disconnect (optional) |
bspwm/monitors.shis tied to my monitor setup; edit outputs/modes for yours.bspwmrcexpects a wallpaper under~/Pictures/wallpapers/(not in this repo).
MIT. Third-party themes and plugins keep their own licenses.