https://github.com/lcaohoanq/kts
Kitty Theme Switcher
https://github.com/lcaohoanq/kts
gui kitty-config kitty-terminal kitty-themes python tkinter tkinter-gui
Last synced: 9 months ago
JSON representation
Kitty Theme Switcher
- Host: GitHub
- URL: https://github.com/lcaohoanq/kts
- Owner: lcaohoanq
- Created: 2025-09-23T01:32:13.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-09-23T02:22:19.000Z (9 months ago)
- Last Synced: 2025-09-23T04:06:45.160Z (9 months ago)
- Topics: gui, kitty-config, kitty-terminal, kitty-themes, python, tkinter, tkinter-gui
- Language: Python
- Homepage:
- Size: 4.88 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🎨 Kitty Theme Switcher
A simple GUI tool to browse and apply Kitty terminal themes with real-time preview and persistent configuration.
## Features
- 🔍 **Live Search** - Filter themes as you type
- ⚡ **Instant Apply** - See changes immediately in running Kitty instances
- 💾 **Persistent** - Themes save to config file and persist across restarts
- 📍 **Current Theme** - Shows which theme is currently active
https://github.com/user-attachments/assets/74803885-2dfa-40ef-92e1-38f910d7e745
## Requirements
- Python 3.x with tkinter
- Kitty terminal installed with remote control enabled
- Themes downloaded from [kitty-themes](https://github.com/dexpota/kitty-themes)
## Setup
1. **Install kitty-themes**:
```bash
git clone --depth 1 https://github.com/dexpota/kitty-themes.git ~/.config/kitty/kitty-themes
```
2. **Enable remote control** in `~/.config/kitty/kitty.conf`:
```conf
allow_remote_control yes
listen_on unix:/tmp/mykitty
```
3. **Run the theme switcher**:
```bash
python3 main.py
```
(Run from wherever you placed the script)
## Usage
- **Search**: Type to filter themes instantly
- **Apply**: Click a theme or press Enter for first match
- **Clear**: Click "Clear" button to reset search
- **Quick Apply**: Double-click any theme
Changes apply immediately to running Kitty instances and are saved to your config file for persistence.
## File Structure
```
~/.config/kitty/
├── kitty.conf
└── kitty-themes/themes/
# main.py can be placed anywhere you prefer
```
---
*Browse hundreds of beautiful Kitty themes with ease! 🐱*