Configuration

A theme is applied in three main steps:

1. Loads all necessary files from the PIMP_CONFIG_DIR directory.
2. Generates a single theme_dict by merging your palette, style, and theme settings.
3. Runs your modules, passing them the theme_dict to apply the rice to your system.

The Config Directory

All configuration lives in PIMP_CONFIG_DIR, located at:

• Linux: ~/.config/pimpmyrice/
• Windows & macOS: ~/pimpmyrice/

(~ is your user's home directory)

Note: The configuration directory and its subdirectories are automatically created if they don't exist.

Here's what a typical config directory looks like:

PIMP_CONFIG_DIR/
├── base_style.json
├── themes/
│   └── my_theme/
│       ├── theme.json
│       └── wallpaper.png
├── modules/
│   └── alacritty/
│       ├── module.yaml
│       └── templates/
│           └── alacritty.toml.j2
├── palettes/
│   └── catppuccin_dark.json
└── styles/
    └── no_borders.json

• base_style.json: The foundation for all themes. See the Style docs.
• themes/: All your themes. See the Theme docs.
• modules/: All your modules. See the Module docs.
• palettes/: Global color palettes. See the Palette docs.
• styles/: Global styles. See the Style docs.