| # shared-gui — GTK3 Base Class |
|
|
| Shared GTK3 base for all desktop apps in this setup. |
| Provides `BaseApp`: a themed GTK3 window with Catppuccin + COSMIC dark/light auto-detection. |
|
|
| ## What BaseApp provides |
|
|
| - GTK3 window with HeaderBar, content area, StatusBar |
| - Catppuccin theme (auto-detects COSMIC dark/light mode, live-updates on theme switch) |
| - Helper methods: `set_subtitle()`, `add_header_widget()`, `set_status()`, `start_refresh()`, `add_css()` |
| - CSS classes: `.base-card`, `.base-toolbar`, `.base-badge`, `.base-badge-ok/warn/error`, `.base-accent-btn` |
|
|
| **Dependency:** `~/Projekte/ClaudeCodePanel/theme.py` must exist (provides `build_css`, `get_palette`, `setup_theme_watcher`). |
|
|
| ## How to import |
|
|
| ```python |
| import sys |
| from pathlib import Path |
| sys.path.insert(0, str(Path.home() / "Projekte" / "shared-gui")) |
| from gui_base import BaseApp |
| |
| import gi |
| gi.require_version("Gtk", "3.0") |
| from gi.repository import Gtk |
| |
| class MyApp(BaseApp): |
| def __init__(self): |
| super().__init__("My App", 800, 600) |
| label = Gtk.Label(label="Hello") |
| self.content_box.pack_start(label, True, True, 0) |
| |
| MyApp().run() |
| ``` |
|
|
| ## Projects using it |
|
|
| - `~/Projekte/ClaudeCodePanel/` — Claude session monitor |
| - `~/Projekte/Sidecar/` — Sidecar GTK3 GUI (v2+) |
|
|
| ## Requirements |
|
|
| ```bash |
| # PyGObject (GTK3 Python bindings) |
| sudo apt install python3-gi python3-gi-cairo gir1.2-gtk-3.0 |
| ``` |
|
|
| No pip dependencies — GTK3 bindings come from the system package manager. |
|
|
