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.

Kitty is the GPU-accelerated terminal emulator used in this rice. It supports true color, image rendering, tiling, and fast text display. Its color theme is driven entirely by Wallust — every time the wallpaper changes, Wallust regenerates a 16-color palette and writes it to ~/.cache/wallust/colors-kitty.conf, which Kitty includes automatically.

File structure

~/.config/kitty/
├── kitty.conf                # Main configuration file
├── colors/
│   └── colors.conf           # Optional static colors (not used in this setup)
└── custom.conf               # Optional user overrides (not versioned)

How colors work

Kitty gets its colors from Wallust, which generates a full 16-color terminal palette from the current wallpaper and writes it as a Kitty-compatible config file.
FileGenerated byWhen
~/.cache/wallust/colors-kitty.confwallustOn every wallpaper change
The generated file defines color0 through color15, foreground, and background. Kitty uses these for all terminal text colors, the background, cursor, selection, and any application that uses terminal color escapes. The include line in kitty.conf that activates this:
include ~/.cache/wallust/colors-kitty.conf
A commented-out alternative (include ./colors/colors.conf) is also present in the file for switching to a static color scheme if you prefer. To change how Wallust maps wallpaper colors to Kitty variables, edit the Wallust template at ~/.config/wallust/templates/kitty.conf.
Never edit ~/.cache/wallust/colors-kitty.conf by hand. It is overwritten by Wallust on every wallpaper change.
To change how wallpaper colors are translated into Kitty’s color palette, edit ~/.config/wallust/templates/kitty.conf. That template controls which wallpaper-extracted color maps to color0, foreground, background, and so on.

Key configuration options

The following settings are taken directly from kitty.conf:
OptionValueEffect
font_familyJetBrainsMono Nerd FontEnables icons and programming ligatures
font_size11Base font size in points
window_padding_width20Inner padding on all sides in pixels
hide_window_decorationsyesRemoves the title bar for a cleaner look
background_opacity0.990% opaque background (slight transparency)
scrollback_lines2000Lines of scrollback history kept in memory
cursor_blink_interval0.5Cursor blinks every 0.5 seconds
cursor_stop_blinking_after1Cursor stops blinking after 1 second of inactivity
selection_foregroundnoneUses terminal default selection foreground
selection_backgroundnoneUses terminal default selection background
The selection_foreground and selection_background values of none mean Kitty defers to the theme — so selection colors follow the Wallust-generated palette automatically.

Build docs developers (and LLMs) love