Documentation Index
Fetch the complete documentation index at: https://mintlify.com/Noro18/linux-ricing-dotfiles/llms.txt
Use this file to discover all available pages before exploring further.
This page maps out every significant file and directory that lands in your home folder after deploying the dotfiles. Files marked ⚠️ are written by the theming pipeline on every wallpaper change — editing them directly will have no lasting effect. For everything else, the table after each tree notes whether the file is safe to edit by hand.
Files marked ⚠️ are auto-generated and overwritten on every wallpaper change. Edit templates in ~/.config/matugen/templates/ or ~/.config/wallust/templates/ instead.
~/.config/
~/.config/
├── hypr/
│ ├── hyprland.conf # Main entry point — imports keybinds, monitors, workspaces
│ ├── configurations/
│ │ └── keybinds.conf # All keybindings (imported by hyprland.conf)
│ ├── monitors.conf # Generated by nwg-display — do not edit manually
│ ├── workspaces.conf # Generated by nwg-display — do not edit manually
│ ├── colors/ # Auto-generated color vars by matugen — do not edit manually
│ ├── hypridle.conf # Idle/lock screen behavior
│ ├── hyprlock.conf # Lock screen appearance
│ ├── hyprpaper.conf # Wallpaper backend config
│ └── hyprsunset.conf # Blue light filter config
│ └── hyprland-gui.conf # File generated by the GUI Hyprland settings Hyprmod
│
├── waybar/
│ ├── config.jsonc # Main Waybar config (modules, layout)
│ ├── style.css # Base styles
│ ├── colors.css # ⚠️ Auto-generated by matugen — do not edit
│ ├── colors-waybar.css # ⚠️ Auto-generated by wallust — do not edit
│ ├── custom styles/ # Drop-in style presets — used by the Waybar style selector
│ ├── scripts/ # Scripts used by Waybar modules
│ └── generated/ # Other generated output files
│
├── rofi/
│ ├── colors/
│ │ └── colors-matugen.rasi # ⚠️ Auto-generated color vars — do not edit
│ ├── colors-matugen.rasi # Root-level copy/symlink of the color file
│ ├── applets/
│ │ ├── bin/ # Applet launcher scripts (powermenu, volume, wallpaper, etc.)
│ │ ├── shared/
│ │ │ └── colors.rasi # Imports colors-matugen.rasi — the single source of truth
│ │ └── type-1..5/ # Style variants for applets (style-1.rasi, style-2.rasi, etc.)
│ └── launchers/
│ ├── type-1..7/ # App launcher layout variants
│ │ ├── launcher.sh # Script to launch this layout
│ │ ├── shared/
│ │ │ └── colors.rasi # Imports root colors — do not edit
│ │ └── style-*.rasi # Visual styles for this launcher type
│
├── kitty/
│ ├── kitty.conf # Main config — references ~/.cache/wallust/colors-kitty.conf
│ └── colors/ # Backup/alternative color files (not the active source)
│
├── matugen/
│ ├── config.toml # Matugen configuration
│ └── templates/ # Templates matugen fills with generated colors
│
├── wallust/
│ ├── wallust.toml # Main wallust config
│ └── templates/ # Templates wallust fills with generated colors
│
├── wal/
│ ├── colorschemes/ # pywal color scheme overrides
│ └── templates/ # pywal templates
│
├── swaync/
│ ├── config.json # Notification center config
│ ├── style.css # Main stylesheet (imports colors-swaync.css)
│ ├── colors-swaync.css # ⚠️ Auto-generated by matugen — do not edit
│ └── themes/ # Alternative theme files
│
├── fastfetch/
│ ├── config.jsonc # Main fastfetch config
│ ├── configs/ # Multiple config variants — one is picked randomly on terminal open
│ └── noros/ # Custom ASCII logos used by the configs
│
├── cava/
│ ├── config # Audio visualizer config
│ └── themes/ # Color themes for cava
│
├── btop/
│ └── btop.conf # System monitor config
│
├── starship.toml # Shell prompt config (Starship)
│
└── wallpapers/ # All wallpapers — scanned by the wallpaper selector menu
| Path | Description | Safe to edit? |
|---|
hypr/hyprland.conf | Main Hyprland entry point; sources all other hypr configs | Yes |
hypr/configurations/keybinds.conf | All keybindings | Yes |
hypr/monitors.conf | Monitor layout — written by nwg-display | No — use nwg-display |
hypr/workspaces.conf | Workspace rules — written by nwg-display | No — use nwg-display |
hypr/colors/ | Color variable files generated by matugen | Never — auto-generated |
hypr/hyprland-gui.conf | Written by the Hyprmod GUI settings tool | No — use the GUI |
hypr/hypridle.conf | Idle timeout and lock screen trigger config | Yes |
hypr/hyprlock.conf | Lock screen layout and appearance | Yes |
hypr/hyprpaper.conf | Wallpaper backend config | Yes |
hypr/hyprsunset.conf | Blue light filter settings | Yes |
waybar/config.jsonc | Waybar module layout and configuration | Yes |
waybar/style.css | Base Waybar stylesheet | Yes |
waybar/colors.css | Color tokens from matugen | Never — auto-generated |
waybar/colors-waybar.css | Color tokens from wallust | Never — auto-generated |
waybar/custom styles/ | Drop-in presets used by the Waybar style selector | Yes |
waybar/scripts/ | Scripts powering Waybar custom modules | Yes |
rofi/colors/colors-matugen.rasi | Generated Rofi color variables | Never — auto-generated |
rofi/applets/bin/ | Applet launcher scripts | Yes |
rofi/applets/shared/colors.rasi | Imports the color file; single source of truth for applets | Yes (import only) |
rofi/launchers/type-1..7/style-*.rasi | Visual styles for each launcher type | Yes |
kitty/kitty.conf | Kitty terminal configuration | Yes |
kitty/colors/ | Backup color files (not the active source) | Yes |
matugen/config.toml | Matugen tool configuration | Yes |
matugen/templates/ | Templates matugen populates with generated colors | Yes |
wallust/wallust.toml | Wallust tool configuration | Yes |
wallust/templates/ | Templates wallust populates with generated colors | Yes |
wal/colorschemes/ | pywal color scheme overrides | Yes |
wal/templates/ | pywal templates | Yes |
swaync/config.json | Notification center layout and behavior | Yes |
swaync/style.css | Swaync main stylesheet | Yes |
swaync/colors-swaync.css | Generated color file imported by style.css | Never — auto-generated |
swaync/themes/ | Alternative theme files | Yes |
fastfetch/config.jsonc | Default fastfetch config | Yes |
fastfetch/configs/ | Multiple config variants picked randomly at terminal open | Yes |
fastfetch/noros/ | Custom ASCII logos | Yes |
cava/config | Audio visualizer config | Yes |
btop/btop.conf | System monitor config | Yes |
starship.toml | Starship shell prompt config | Yes |
wallpapers/ | Wallpaper images scanned by the selector | Yes — add images here |
~/.local/bin/
~/.local/bin/
├── wallset # Opens the wallpaper selector menu
├── wallset-backend # Runs after manual wallpaper selection
├── wallset-backend-startup # Runs on login — picks a random wallpaper
├── waybar-set # Opens the Waybar style selector
├── waybar-menu # Waybar-related menu helper
├── colorscheme-set # Opens the color scheme selector
├── colorscheme-backend # Applies a selected color scheme
├── wallock-set # Sets the lock screen wallpaper
├── wallock-set-backend # Backend for lock screen wallpaper changes
├── launcher # Rofi app launcher entry point
├── focus-menu # Focus mode menu
├── focus-mode # Toggles focus mode
├── fastfetch-random # Picks a random fastfetch config on terminal open
├── autostart_kitty # Kitty autostart helper
├── toggle-hyprsunset # Toggles the blue light filter on/off
├── adjust-hyprsunset # Adjusts hyprsunset temperature
├── pywal_cava # Applies pywal colors to cava
├── pywalch.sh # pywal color helper script
├── rofi-custom.sh # Custom Rofi invocation script
├── battery # Battery status helper
├── close_all_windows # Closes all open windows
├── killall # Utility to kill processes
├── setfhd # Sets display to FHD resolution
├── sethd # Sets display to HD resolution
├── adb_wifi # ADB over Wi-Fi helper
├── open-chat-gpt # Opens ChatGPT in the browser
└── lyra-assistant # Lyra AI assistant launcher
| Script | Description | Safe to edit? |
|---|
wallset | Opens the Rofi wallpaper selector menu | Yes |
wallset-backend | Runs swww, matugen, and wallust after a manual wallpaper pick | Yes |
wallset-backend-startup | Same pipeline but triggered on login with a random wallpaper | Yes |
waybar-set | Opens the Rofi Waybar style selector | Yes |
colorscheme-set | Opens the color scheme selector menu | Yes |
colorscheme-backend | Applies a selected color scheme across components | Yes |
wallock-set | Sets the wallpaper used by hyprlock | Yes |
launcher | Entry point for the Rofi app launcher | Yes |
focus-mode | Toggles focus mode (hides bar, clears distractions) | Yes |
fastfetch-random | Randomly selects a fastfetch config from ~/.config/fastfetch/configs/ | Yes |
toggle-hyprsunset | Toggles the hyprsunset blue light filter | Yes |
pywal_cava | Patches cava with the current pywal color scheme | Yes |
For a detailed explanation of how the theming pipeline connects these scripts and config files, see the theming pipeline page.