Theming

iNiR supports multiple theming approaches: wallpaper-based colors, preset themes, and manual customization.

Global Styles

iNiR has five visual styles that change how panels look:

#Material

Solid backgrounds, classic Material Design aesthetic.

• Opaque panels
• Material Design colors
• Subtle shadows
• Best for readability

#Cards

Card-based layout with subtle shadows.

• Rounded corners
• Soft drop shadows
• Clean modern look
• Medium resource usage

#Aurora

Glass blur, translucent panels.

• Blurred backgrounds
• Transparent panels
• Adapts to wallpaper
• More GPU intensive

#iNiR

TUI-inspired, minimal aesthetic.

• Thin borders
• Minimal shadows
• Clean lines
• Lowest resource usage

#Angel

Neo-brutalism with frosted glass.

• Escalonado shadows
• Bold typography
• Striking aesthetic
• Higher GPU usage

Switch styles in settings or via config:

"appearance": {
  "globalStyle": "material"
}

Wallpaper-Based Theming

iNiR uses matugen to extract Material You colors from your wallpaper.

#How It Works

1. You set a wallpaper
2. Matugen analyzes the image
3. Colors are extracted and saved
4. iNiR applies the color scheme
5. Terminal themes are generated

#Setting a Wallpaper

Use the wallpaper selector:

qs -c ii ipc call wallpaperSelector toggle

Or press Ctrl+Alt+T.

#Manual Wallpaper

Edit config:

"background": {
  "wallpaperPath": "/path/to/wallpaper.jpg"
}

Restart iNiR to apply.

#Generated Files

Matugen creates:

• ~/.local/state/quickshell/user/generated/colors.json - Color palette
• ~/.config/foot/colors.ini - Foot terminal theme
• ~/.config/kitty/current-theme.conf - Kitty terminal theme
• ~/.config/alacritty/colors.toml - Alacritty theme
• GTK theme files

Theme Presets

iNiR ships 41 built-in presets. Select in settings under Appearance → Theme.

Dark presets:

Light presets:

Custom Themes

#Creating a Theme

Themes are defined in the matugen config. To create a custom theme:

1. Copy an existing theme template
2. Modify colors
3. Save to matugen config directory
4. Select in iNiR settings

#Theme Structure

Themes define:

• Primary color
• Secondary color
• Tertiary color
• Background colors
• Surface colors
• Error colors

See matugen documentation for the full schema.

Dark and Light Modes

iNiR automatically detects your system theme preference. You can also force a mode:

"appearance": {
  "darkMode": true
}

The documentation site has a theme toggle in the sidebar.

Transparency

Control panel transparency:

"appearance": {
  "transparency": {
    "enable": true,
    "automatic": true,
    "backgroundTransparency": 0.15,
    "contentTransparency": 0.9
  }
}

• automatic - Adjusts based on wallpaper vibrancy
• backgroundTransparency - Panel background opacity
• contentTransparency - Content overlay opacity

Accent Colors

The primary color from your theme is used as the accent:

• Active workspace indicator
• Selected items
• Progress bars
• Buttons

Font Configuration

iNiR uses system fonts. Configure in your system settings or GTK config.

Recommended fonts:

• Sans-serif: Inter, Roboto, system default
• Monospace: JetBrains Mono, Fira Code

Terminal Theming

iNiR automatically generates terminal themes for:

• Foot
• Kitty
• Alacritty
• Wezterm
• Ghostty
• Konsole

Themes are regenerated when you change wallpaper or theme preset.

GTK Theming

iNiR applies GTK themes via matugen templates. Your GTK apps will match your shell theme.

Config location: ~/.config/gtk-3.0/settings.ini

Icon Themes

iNiR doesn't manage icon themes. Set your preferred icon theme in GTK settings:

gsettings set org.gnome.desktop.interface icon-theme 'Papirus-Dark'

Cursor Themes

Set cursor theme in GTK settings:

gsettings set org.gnome.desktop.interface cursor-theme 'Adwaita'

Troubleshooting Themes

#Colors not updating

1. Check if matugen is installed
2. Verify wallpaper path is correct
3. Restart iNiR
4. Check logs for matugen errors

#Terminal theme not applying

1. Check if terminal config file exists
2. Verify terminal is using the generated theme file
3. Restart terminal

#GTK apps don't match

1. Check GTK config: ~/.config/gtk-3.0/settings.ini
2. Verify matugen templates are installed
3. Restart GTK apps

Advanced Theming

For complete control, edit the matugen config directly:

nano ~/.config/matugen/config.toml

See matugen documentation for all options.