Skip to main content

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
PathDescriptionSafe to edit?
hypr/hyprland.confMain Hyprland entry point; sources all other hypr configsYes
hypr/configurations/keybinds.confAll keybindingsYes
hypr/monitors.confMonitor layout — written by nwg-displayNo — use nwg-display
hypr/workspaces.confWorkspace rules — written by nwg-displayNo — use nwg-display
hypr/colors/Color variable files generated by matugenNever — auto-generated
hypr/hyprland-gui.confWritten by the Hyprmod GUI settings toolNo — use the GUI
hypr/hypridle.confIdle timeout and lock screen trigger configYes
hypr/hyprlock.confLock screen layout and appearanceYes
hypr/hyprpaper.confWallpaper backend configYes
hypr/hyprsunset.confBlue light filter settingsYes
waybar/config.jsoncWaybar module layout and configurationYes
waybar/style.cssBase Waybar stylesheetYes
waybar/colors.cssColor tokens from matugenNever — auto-generated
waybar/colors-waybar.cssColor tokens from wallustNever — auto-generated
waybar/custom styles/Drop-in presets used by the Waybar style selectorYes
waybar/scripts/Scripts powering Waybar custom modulesYes
rofi/colors/colors-matugen.rasiGenerated Rofi color variablesNever — auto-generated
rofi/applets/bin/Applet launcher scriptsYes
rofi/applets/shared/colors.rasiImports the color file; single source of truth for appletsYes (import only)
rofi/launchers/type-1..7/style-*.rasiVisual styles for each launcher typeYes
kitty/kitty.confKitty terminal configurationYes
kitty/colors/Backup color files (not the active source)Yes
matugen/config.tomlMatugen tool configurationYes
matugen/templates/Templates matugen populates with generated colorsYes
wallust/wallust.tomlWallust tool configurationYes
wallust/templates/Templates wallust populates with generated colorsYes
wal/colorschemes/pywal color scheme overridesYes
wal/templates/pywal templatesYes
swaync/config.jsonNotification center layout and behaviorYes
swaync/style.cssSwaync main stylesheetYes
swaync/colors-swaync.cssGenerated color file imported by style.cssNever — auto-generated
swaync/themes/Alternative theme filesYes
fastfetch/config.jsoncDefault fastfetch configYes
fastfetch/configs/Multiple config variants picked randomly at terminal openYes
fastfetch/noros/Custom ASCII logosYes
cava/configAudio visualizer configYes
btop/btop.confSystem monitor configYes
starship.tomlStarship shell prompt configYes
wallpapers/Wallpaper images scanned by the selectorYes — 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
ScriptDescriptionSafe to edit?
wallsetOpens the Rofi wallpaper selector menuYes
wallset-backendRuns swww, matugen, and wallust after a manual wallpaper pickYes
wallset-backend-startupSame pipeline but triggered on login with a random wallpaperYes
waybar-setOpens the Rofi Waybar style selectorYes
colorscheme-setOpens the color scheme selector menuYes
colorscheme-backendApplies a selected color scheme across componentsYes
wallock-setSets the wallpaper used by hyprlockYes
launcherEntry point for the Rofi app launcherYes
focus-modeToggles focus mode (hides bar, clears distractions)Yes
fastfetch-randomRandomly selects a fastfetch config from ~/.config/fastfetch/configs/Yes
toggle-hyprsunsetToggles the hyprsunset blue light filterYes
pywal_cavaPatches cava with the current pywal color schemeYes

For a detailed explanation of how the theming pipeline connects these scripts and config files, see the theming pipeline page.

Build docs developers (and LLMs) love