$ show Ronin-CK/HyprQuickFrame
HyprQuickFrame is a native screenshot utility for Hyprland built using the Quickshell framework. It provides an overlay-based UI for capturing screenshots in region, window, or full-screen modes, with options to edit, save to disk, copy to clipboard, or share via KDE Connect. The application features shader-based dimming, animated transitions, and dynamic theme synchronization with wallpapers via Noctalia. The architecture centers around a QML application shell that manages state and delegates to specialized UI components (RegionSelector, WindowSelector, ControlBar, etc.). Screenshot capture is performed by spawning external processes (grim, wl-clipboard, editors) based on the selected mode. The theme system allows users to customize colors and animations via a TOML file, with a Python script available to sync colors from Noctalia-generated palettes. Key reusable components include a custom animated toggle button (QuickToggle.qml), a segmented control bar (ControlBar.qml), a TOML-based theme parser (Theme.qml), and a Noctalia theme synchronization script (sync_theme.py). These components are designed with minimal dependencies and demonstrate advanced QML animation techniques and configuration patterns.
The LLM identified 4 files worth highlighting for reuse:
A reusable animated segmented control for mode selection with dynamic width adjustment based on active toggles. Uses spring animations for smooth transitions and is decoupled from application logic via theme and mode properties.
A custom toggle button with spring-based position/scale animations, pulse effects, and support for both icon and image sources. Demonstrates advanced QML animation techniques and is fully self-contained with no internal dependencies.
A QtObject that parses TOML configuration with fallback values and automatic conversion of CSS-style rgba and 8-digit hex colors to Qt rgba values. Provides a clean API for theming QML applications with minimal boilerplate.
A standalone Python script that synchronizes color schemes from Noctalia's JSON output to a TOML theme file. Uses a predefined mapping to update specific color keys and handles opacity adjustments for background colors.