ghostty-rice 0.1.0

Full visual profile manager for Ghostty terminal — beyond just colors.

🍚 ghostty-rice

Full visual profile manager for Ghostty — beyond just colors.

English • 简体中文

---

Color themes only change 16 ANSI colors. ghostty-rice manages complete visual profiles — colors, opacity, blur, titlebar, cursor, padding, icons — and switches them with a single command.

rice use "Catppuccin Mocha"    # Switch profile, auto-reloads Ghostty

Why ghostty-rice?

Projects like catppuccin/ghostty and iTerm2-Color-Schemes are color palettes. A terminal's look is more than 16 colors:

Other Color Schemes	🍚 ghostty-rice
✅ Foreground & Background	✅ Everything they do, plus:
✅ 16 ANSI Palette Colors	✅ Window Opacity & Blur Effects
❌ Titlebar Style	✅ Titlebar Style (tabs, transparent, hidden)
❌ Cursor Customization	✅ Cursor Shape, Color & Animation
❌ Window Spacing	✅ Window Padding & Spacing
❌ App Icon	✅ App Icon Variant

Install

pipx install ghostty-rice

Other methods

# With pip
pip install ghostty-rice

# From source
git clone https://github.com/jayleonc/ghostty-rice.git
cd ghostty-rice
pip install -e .

Quick Start

# List available profiles
rice list

# Switch profile (auto-reloads Ghostty)
rice use "Catppuccin Mocha"

# Preview without switching
rice preview "Cyber"

# Check setup
rice doctor

# See current profile
rice current

Built-in Profiles

Profile	Style
☕ Catppuccin Mocha	Warm, cozy, the most popular dev palette
🌲 Rose Pine	Elegant dark with automatic light/dark switching
🤖 Cyber	High transparency, hidden chrome, holographic icon
⬜ Minimal	No titlebar, no blur, just code
🧊 Frosted	macOS native frosted glass, light mode

Custom Profiles

Profile files follow Ghostty's own format — plain key = value, no file extension, filename is the profile name.

1. Create from an existing profile:

rice create "My Theme" --from "Catppuccin Mocha"

2. Or write one from scratch:

Create a file in your Ghostty config directory under rice-profiles/:

Platform	Path
macOS	~/Library/Application Support/com.mitchellh.ghostty/rice-profiles/
Linux	~/.config/ghostty/rice-profiles/

theme = Catppuccin Mocha
background-opacity = 0.90
background-blur = macos-glass-regular
macos-titlebar-style = transparent
window-padding-x = 12
window-padding-y = 8
cursor-style = block
cursor-style-blink = true

3. Add metadata (optional) in manifest.toml alongside your profiles:

[profiles."My Theme"]
description = "My custom visual profile"
author = "me"
tags = ["dark", "custom"]

4. Use it:

rice use "My Theme"

Diagnostics

rice doctor

Checks Ghostty installation, version, running state, automation permissions, config directory, and profile status in one command.

How It Works

ghostty-rice preserves your base Ghostty config (shell, fonts, keybinds) and only manages the visual profile section. When you switch profiles:

1. Your base config stays untouched
2. The profile section is replaced
3. Ghostty is auto-reloaded (macOS: native AppleScript API, Linux: xdotool)

Platform Support

Platform	Profile switching	Auto-reload
macOS	Full	Native AppleScript API
Linux	Full	Via xdotool (optional)

Contributing

Contributions welcome — especially new profiles, platform support, and shader management.

git clone https://github.com/jayleonc/ghostty-rice.git
cd ghostty-rice
uv venv .venv && source .venv/bin/activate
uv pip install -e ".[dev]"
pytest

License

MIT