How saatvik333/niri-dotfiles works
This repository is a Niri desktop configuration: users interact with the compositor and its configured desktop tools, while Wallust provides the documented wallpaper-based, system-wide theming capability. The README documents application and wallpaper-selector keybinds, theme generation, and the roles of major tools. No source excerpts were available, so links beyond those documented relationships are omitted; configuration details such as exact script dispatch are not asserted.
Main entry points: config.kdl Niri Compositor · wallust.toml Wallust Theme Generator · wallpapers Wallpaper Collection · vicinae.json Vicinae Launcher
Components 19
Desktop Session
- Niri Compositor
niri/config.kdl - Waybar Status Bar
waybar/config.jsonc - Mako Notifications
mako/config - GTKLock
gtklock/config.ini
Launch And Media
- Rofi
rofi/config.rasi - Vicinae Launcher
vicinae/vicinae.json - Wallpaper Selector
scripts/bgselector.sh - Media Controls
scripts/media-control.sh
Dynamic Theming
- Wallust Theme Generator
wallust/wallust.toml - Wallpaper Collection
wallpapers - Theme Templates
wallust/templates
User Environment
- Fish Shell
fish/config.fish - Zsh Shell
zsh/config.zsh - Alacritty Terminal
alacritty/alacritty.toml - Kitty Terminal
kitty/kitty.conf - Neovim Editor
nvim/init.lua - Yazi File Manager
yazi/yazi.toml - Starship Prompt
starship/starship.toml
Other components
- Desktop User
Connections 8
- Desktop User → Niri Compositor: uses
- Niri Compositor → Alacritty Terminal: opens
- Niri Compositor → Kitty Terminal: opens
- Niri Compositor → Vicinae Launcher: opens
- Niri Compositor → Yazi File Manager: opens
- Niri Compositor → Wallpaper Selector: opens selector
- Wallpaper Collection → Wallust Theme Generator: provides images
- Wallust Theme Generator → Theme Templates: renders colors