ghostty-rice 0.1.0__tar.gz

ghostty_rice-0.1.0/.gitignore

@@ -0,0 +1,13 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.venv/
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+*.egg
+.DS_Store
+docs/

ghostty_rice-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 jayleonc
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ghostty_rice-0.1.0/PKG-INFO

@@ -0,0 +1,202 @@
+Metadata-Version: 2.4
+Name: ghostty-rice
+Version: 0.1.0
+Summary: Full visual profile manager for Ghostty terminal — beyond just colors.
+Project-URL: Homepage, https://github.com/jayleonc/ghostty-rice
+Project-URL: Repository, https://github.com/jayleonc/ghostty-rice
+Project-URL: Issues, https://github.com/jayleonc/ghostty-rice/issues
+Author: jayleonc
+License-Expression: MIT
+License-File: LICENSE
+Keywords: customization,ghostty,rice,terminal,theme
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Terminals :: Terminal Emulators/X Terminals
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Requires-Dist: click>=8.1
+Requires-Dist: rich>=13.0
+Requires-Dist: tomli>=2.0; python_version < '3.11'
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Description-Content-Type: text/markdown
+
+<h1 align="center">🍚 ghostty-rice</h1>
+
+<p align="center">
+  <b>Full visual profile manager for <a href="https://ghostty.org">Ghostty</a> — beyond just colors.</b>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/ghostty-rice/"><img src="https://img.shields.io/pypi/v/ghostty-rice?style=flat-square&color=blue&logo=pypi&logoColor=white" alt="PyPI"></a>
+  <img src="https://img.shields.io/pypi/pyversions/ghostty-rice?style=flat-square&logo=python&logoColor=white" alt="Python">
+  <a href="https://github.com/jayleonc/ghostty-rice/actions"><img src="https://img.shields.io/github/actions/workflow/status/jayleonc/ghostty-rice/ci.yml?style=flat-square&label=CI&logo=github" alt="CI"></a>
+  <a href="https://github.com/jayleonc/ghostty-rice/blob/main/LICENSE"><img src="https://img.shields.io/github/license/jayleonc/ghostty-rice?style=flat-square" alt="License"></a>
+</p>
+
+<p align="center">
+  <b>English</b> • <a href="./README_ZH.md">简体中文</a>
+</p>
+
+---
+
+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.
+
+```bash
+rice use "Catppuccin Mocha"    # Switch profile, auto-reloads Ghostty
+```
+
+## Why ghostty-rice?
+
+Projects like [catppuccin/ghostty](https://github.com/catppuccin/ghostty) and [iTerm2-Color-Schemes](https://github.com/mbadolato/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
+
+```bash
+pipx install ghostty-rice
+```
+
+<details>
+<summary>Other methods</summary>
+
+```bash
+# With pip
+pip install ghostty-rice
+
+# From source
+git clone https://github.com/jayleonc/ghostty-rice.git
+cd ghostty-rice
+pip install -e .
+```
+
+</details>
+
+## Quick Start
+
+```bash
+# 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:**
+
+```bash
+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/` |
+
+```ini
+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:
+
+```toml
+[profiles."My Theme"]
+description = "My custom visual profile"
+author = "me"
+tags = ["dark", "custom"]
+```
+
+**4. Use it:**
+
+```bash
+rice use "My Theme"
+```
+
+## Diagnostics
+
+```bash
+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.
+
+```bash
+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](LICENSE)

ghostty_rice-0.1.0/README.md

@@ -0,0 +1,171 @@
+<h1 align="center">🍚 ghostty-rice</h1>
+
+<p align="center">
+  <b>Full visual profile manager for <a href="https://ghostty.org">Ghostty</a> — beyond just colors.</b>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/ghostty-rice/"><img src="https://img.shields.io/pypi/v/ghostty-rice?style=flat-square&color=blue&logo=pypi&logoColor=white" alt="PyPI"></a>
+  <img src="https://img.shields.io/pypi/pyversions/ghostty-rice?style=flat-square&logo=python&logoColor=white" alt="Python">
+  <a href="https://github.com/jayleonc/ghostty-rice/actions"><img src="https://img.shields.io/github/actions/workflow/status/jayleonc/ghostty-rice/ci.yml?style=flat-square&label=CI&logo=github" alt="CI"></a>
+  <a href="https://github.com/jayleonc/ghostty-rice/blob/main/LICENSE"><img src="https://img.shields.io/github/license/jayleonc/ghostty-rice?style=flat-square" alt="License"></a>
+</p>
+
+<p align="center">
+  <b>English</b> • <a href="./README_ZH.md">简体中文</a>
+</p>
+
+---
+
+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.
+
+```bash
+rice use "Catppuccin Mocha"    # Switch profile, auto-reloads Ghostty
+```
+
+## Why ghostty-rice?
+
+Projects like [catppuccin/ghostty](https://github.com/catppuccin/ghostty) and [iTerm2-Color-Schemes](https://github.com/mbadolato/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
+
+```bash
+pipx install ghostty-rice
+```
+
+<details>
+<summary>Other methods</summary>
+
+```bash
+# With pip
+pip install ghostty-rice
+
+# From source
+git clone https://github.com/jayleonc/ghostty-rice.git
+cd ghostty-rice
+pip install -e .
+```
+
+</details>
+
+## Quick Start
+
+```bash
+# 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:**
+
+```bash
+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/` |
+
+```ini
+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:
+
+```toml
+[profiles."My Theme"]
+description = "My custom visual profile"
+author = "me"
+tags = ["dark", "custom"]
+```
+
+**4. Use it:**
+
+```bash
+rice use "My Theme"
+```
+
+## Diagnostics
+
+```bash
+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.
+
+```bash
+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](LICENSE)

ghostty_rice-0.1.0/README_ZH.md

@@ -0,0 +1,173 @@
+<h1 align="center">🍚 ghostty-rice</h1>
+
+<p align="center">
+  <b><a href="https://ghostty.org">Ghostty</a> 终端的全方位视觉配置管理器 —— 不只是换颜色。</b>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/ghostty-rice/"><img src="https://img.shields.io/pypi/v/ghostty-rice?style=flat-square&color=blue&logo=pypi&logoColor=white" alt="PyPI"></a>
+  <img src="https://img.shields.io/pypi/pyversions/ghostty-rice?style=flat-square&logo=python&logoColor=white" alt="Python">
+  <a href="https://github.com/jayleonc/ghostty-rice/actions"><img src="https://img.shields.io/github/actions/workflow/status/jayleonc/ghostty-rice/ci.yml?style=flat-square&label=CI&logo=github" alt="CI"></a>
+  <a href="https://github.com/jayleonc/ghostty-rice/blob/main/LICENSE"><img src="https://img.shields.io/github/license/jayleonc/ghostty-rice?style=flat-square" alt="License"></a>
+</p>
+
+<p align="center">
+  <a href="./README.md">English</a> • <b>简体中文</b>
+</p>
+
+---
+
+传统主题只改 16 色调色盘。**ghostty-rice** 管理完整的视觉方案 —— 颜色、透明度、毛玻璃、标题栏、光标、边距、图标 —— 一条命令全部切换。
+
+```bash
+rice use "Catppuccin Mocha"    # 切换方案，Ghostty 自动重载
+```
+
+## 为什么需要 ghostty-rice？
+
+[catppuccin/ghostty](https://github.com/catppuccin/ghostty) 和 [iTerm2-Color-Schemes](https://github.com/mbadolato/iTerm2-Color-Schemes) 是优秀的调色盘项目。但终端的视觉体验远不止 16 个颜色：
+
+| 传统调色盘项目 | 🍚 `ghostty-rice` |
+|---------------|-------------------|
+| ✅ 前景色与背景色 | ✅ **涵盖左侧所有内容，外加：** |
+| ✅ 16 色 ANSI 调色盘 | ✅ 窗口透明度与毛玻璃效果 |
+| ❌ 标题栏样式 | ✅ 标题栏样式（标签页 / 透明 / 隐藏） |
+| ❌ 光标定制 | ✅ 光标形状、颜色与动画 |
+| ❌ 窗口内外边距 | ✅ 窗口内边距定制 |
+| ❌ App 图标 | ✅ App 图标一键切换 |
+
+**一句话：它们是调色盘，我们是整套视觉方案。**
+
+## 安装
+
+```bash
+pipx install ghostty-rice
+```
+
+<details>
+<summary>其他安装方式</summary>
+
+```bash
+# pip 安装
+pip install ghostty-rice
+
+# 从源码安装
+git clone https://github.com/jayleonc/ghostty-rice.git
+cd ghostty-rice
+pip install -e .
+```
+
+</details>
+
+## 快速上手
+
+```bash
+# 查看所有可用方案
+rice list
+
+# 切换方案（自动重载 Ghostty）
+rice use "Catppuccin Mocha"
+
+# 预览方案（不切换）
+rice preview "Cyber"
+
+# 一键检查环境
+rice doctor
+
+# 查看当前方案
+rice current
+```
+
+## 内置方案
+
+| 方案 | 风格 |
+|------|------|
+| ☕ **Catppuccin Mocha** | 温暖柔和，程序员圈最火的配色 |
+| 🌲 **Rose Pine** | 优雅暗色，跟随系统自动切换明暗 |
+| 🤖 **Cyber** | 赛博朋克 —— 高透明度、隐藏标题栏、全息图标 |
+| ⬜ **Minimal** | 极简 —— 无标题栏、无模糊、只有代码 |
+| 🧊 **Frosted** | macOS 原生毛玻璃，亮色模式 |
+
+## 自定义方案
+
+方案文件完全遵循 Ghostty 原生格式 —— 纯 `key = value`，无文件扩展名，文件名即方案名。
+
+**1. 从已有方案创建：**
+
+```bash
+rice create "My Theme" --from "Catppuccin Mocha"
+```
+
+**2. 或者从零开始：**
+
+在 Ghostty 配置目录的 `rice-profiles/` 下创建文件：
+
+| 平台 | 路径 |
+|------|------|
+| macOS | `~/Library/Application Support/com.mitchellh.ghostty/rice-profiles/` |
+| Linux | `~/.config/ghostty/rice-profiles/` |
+
+```ini
+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. 添加元数据**（可选），在同目录下的 `manifest.toml` 中：
+
+```toml
+[profiles."My Theme"]
+description = "我的自定义方案"
+author = "me"
+tags = ["dark", "custom"]
+```
+
+**4. 使用：**
+
+```bash
+rice use "My Theme"
+```
+
+## 环境诊断
+
+```bash
+rice doctor
+```
+
+一键检查：Ghostty 安装状态、版本号、运行状态、自动化权限、配置目录、方案加载情况。
+
+## 工作原理
+
+ghostty-rice 会保留你的基础配置（Shell、字体、快捷键等），只管理视觉方案部分。切换时：
+
+1. 基础配置原封不动
+2. 视觉方案部分被替换
+3. Ghostty 自动重载（macOS 通过原生 AppleScript API，Linux 通过 xdotool）
+
+## 平台支持
+
+| 平台 | 方案切换 | 自动重载 |
+|------|---------|---------|
+| macOS | 完整支持 | 原生 AppleScript API |
+| Linux | 完整支持 | xdotool（可选） |
+
+## 参与贡献
+
+欢迎贡献 —— 特别是新的视觉方案、平台支持、Shader 管理。
+
+```bash
+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
+```
+
+## 开源协议
+
+[MIT](LICENSE)

ghostty_rice-0.1.0/ghostty_rice/__init__.py

@@ -0,0 +1,3 @@
+"""ghostty-rice — Full visual profile manager for Ghostty terminal."""
+
+__version__ = "0.1.0"