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

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

# 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.