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.

Rofi is the unified menu system for this rice. It serves as the application launcher, power menu, mode switcher, Waybar style selector, and the front-end for applets like volume, brightness, battery, and wallpaper theming. Every Rofi window is themed automatically from the current wallpaper colors through two generated color files.

​
File structure

~/.config/rofi/
├── colors-matugen.rasi          # ⚠ Generated by matugen on wallpaper change — do not edit
├── colors-wallust.rasi          # ⚠ Generated by wallust on wallpaper change — do not edit
├── colors/                      # Additional color schemes (optional)
├── launchers/                   # Different launcher styles (type-1 through type-7)
│   ├── type-1/
│   │   ├── launcher.sh          # Script to launch this launcher type
│   │   └── style-*.rasi         # Rofi theme files for this launcher type
│   ├── type-2/
│   │   ├── launcher.sh
│   │   └── style-*.rasi
│   └── ... (similar for types 3–7)
├── applets/                     # Custom applets (widgets) for the launchers
│   ├── shared/                  # Shared resources (theme.bash, colors.rasi, fonts.rasi)
│   ├── type-1/                  # Applets for type-1 launchers
│   │   ├── style-*.rasi
│   │   └── ...
│   └── bin/                     # Scripts powering the applets
│       ├── waltheme.sh          # Wallpaper/theme changer applet
│       ├── battery.sh           # Battery status applet
│       ├── volume.sh            # Volume control applet
│       ├── brightness.sh        # Brightness control applet
│       ├── apps.sh              # Application launcher applet
│       └── ... (other applet scripts)

​
How the files relate

Rofi is launched via the launcher.sh scripts inside each launchers/type-*/ directory. These scripts call rofi with a specific .rasi theme file that defines the window layout and visual style. Each .rasi theme file imports its colors from one of two auto-generated files:
  • colors-matugen.rasi — Material You palette from Matugen
  • colors-wallust.rasi — 16-color terminal palette from Wallust
Both color files are regenerated automatically on every wallpaper change, so Rofi always matches the current theme without any manual intervention.

​
How colors work

FileGenerated byWhen
colors-matugen.rasimatugenOn every wallpaper change
colors-wallust.rasiwallustOn every wallpaper change
To change how colors map to Rofi elements, edit the generator templates rather than the output files:
  • ~/.config/matugen/templates/ for Material You colors (look for .rasi templates)
  • ~/.config/wallust/templates/ for terminal palette colors (look for .rasi templates)

​
Changing launchers and applets

1

Switch launcher types

Run the launcher.sh for the type you want, for example:
~/.config/rofi/launchers/type-1/launcher.sh
Each type (1–7) offers a different layout and visual style. You can bind any of these to a keybind in ~/.config/hypr/configurations/keybinds.conf.
2

Customize a launcher's appearance

Edit the .rasi files in the launcher’s style directory:
~/.config/rofi/launchers/type-1/style-1.rasi
Each style-*.rasi file controls sizing, padding, fonts, and which color variables from colors-matugen.rasi or colors-wallust.rasi are used for each element.
3

Add or modify applets

Applets have two layers you can edit:
  • Functionality: edit the scripts in ~/.config/rofi/applets/bin/
  • Appearance: edit the .rasi files in ~/.config/rofi/applets/type-*/
  • Shared styles: edit ~/.config/rofi/applets/shared/ for fonts, colors, and layout used by all applets

​
Available applets

The applets/bin/ directory contains scripts that each power a specific Rofi-based applet:
ScriptPurpose
waltheme.shWallpaper and theme changer
battery.shBattery status and details
volume.shAudio volume control
brightness.shScreen brightness control
apps.shApplication launcher applet
Additional applet scripts may also be present in that directory for other system functions.
Never edit colors-matugen.rasi or colors-wallust.rasi by hand. Both files are overwritten by Matugen and Wallust on every wallpaper change, so any manual edits will be lost immediately.

Build docs developers (and LLMs) love

Get started for freeTalk to us