A personal, environment-aware dotfiles setup built with chezmoi
Overview · Stack · How it works · Installation
These are my personal dotfiles, managed with chezmoi. The setup is designed to be environment-aware — it adapts based on whether you're on a personal machine, at work, or at school.
Two desktop suites are supported:
- Standard — The classic Hyprland stack: Waybar for the bar, SwayNC for notifications, Wlogout for the power menu, Dunst as an alternative notification daemon, and Rofi as the launcher.
- Quickshell — A single Quickshell instance that replaces waybar, swaync, wlogout, and more with a unified, scriptable shell. Choose this if you want one cohesive panel instead of separate programs.
| Category | Programs |
|---|---|
| Compositor | Hyprland |
| Shell | Fish |
| Terminal | Kitty, Alacritty |
| Editor | Neovim, Zed |
| Bar | Waybar, Quickshell |
| Notifications | SwayNC, Dunst |
| Launcher | Rofi, Albert |
| Logout | Wlogout |
| Theming | Matugen |
| File Manager | Yazi |
| Music | MPD |
| Package Manager | Paru |
| Other | yt-dlp, EasyEffects, FreeTube |
The setup uses chezmoi templates to prompt for your environment on first run and generate a tailored configuration:
- Environment — Choose between
personal,work, orschool. Each restricts or enables different configs. - Machine type — For personal setups:
laptop,desktop, orserver. - Desktop suite — Pick your UI stack:
standard(waybar + swaync + wlogout),quickshell, ornone. - Window manager — Currently
hyprland. - Gaming — Optional gaming extras (MangoHud, gamemode, etc).
All of this is driven by .chezmoi.toml.tmpl and .chezmoiignore.tmpl. Legacy WM configs (bspwm, qtile, polybar, sxhkd) are archived on the archive/legacy-wm-configs branch.
# Install chezmoi
sh -c "$(curl -fsLS get.chezmoi.io)"
# Apply dotfiles (will prompt for environment on first run)
chezmoi init --apply maplepy/dotfilesOr clone and apply manually:
chezmoi init --apply https://github.com/maplepy/dotfiles.git- Arch Linux (or Arch-based distro)
- chezmoi
- Hyprland (for the standard/quickshell suites)