$ show HyDE-Project/HyDE
HyDE is a configuration management framework and dotfiles distribution for the Hyprland Wayland compositor. It functions as an automated installer, runtime environment, and dynamic theming engine for a complete Linux desktop experience. The system's core innovation is the 'wallbash' pipeline, which extracts color palettes from wallpapers and propagates them into dozens of application configurations via template substitution. The codebase is a polyglot of Bash, Lua, and Python, reflecting an ongoing architectural migration from shell scripts to structured Lua/Python modules. While tightly coupled to the Hyprland ecosystem and carrying significant technical debt from its rapid evolution (duplicate code, hardcoded paths, overlapping implementations), it demonstrates high craftsmanship in specific areas: a pure-Lua TOML parser, a plugin-based package manager abstraction, versioned migration scripts, and a Unix socket-based IPC pattern for audio visualization. Maintenance is active with a defined release cadence, but the project is in a state of active refactoring, meaning users should expect breaking changes and incomplete migrations between versions.
The LLM identified 8 files worth highlighting for reuse:
A pure Lua TOML parser implementing a significant subset of the TOML spec. It is entirely self-contained in a single file, requires no external dependencies, and can be embedded into any Lua project for parsing TOML configuration files. Demonstrates clean Lua metatable usage for recursive table construction.
A standalone Lua argument parsing library supporting commands, options, mutexes, and automatic shell completion generation for bash, zsh, and fish. It is a single-file, dependency-free module that can be extracted and used in any Lua CLI application. Demonstrates advanced Lua string pattern matching and table manipulation.
A clean, well-documented Python implementation of the XDG Base Directory specification. It provides functions to resolve XDG_CONFIG_HOME, XDG_DATA_HOME, XDG_CACHE_HOME, and related directories with proper fallbacks. It is a single-file, dependency-free utility that can be reused in any Python project requiring standard filesystem layout resolution.
Defines the abstract base class and metadata structure for a plugin-based package manager abstraction layer. It establishes a consistent interface (install, remove, upgrade, search, list_installed, count_updates) that multiple backends (pacman, apt, dnf, flatpak) implement. The pattern is reusable for any project needing to abstract over multiple system package managers.
Implements a Unix socket-based server that broadcasts audio visualization data from cava (Cross-platform Audio Visualizer) to multiple clients (e.g., Waybar modules). It features automatic server shutdown when no clients are connected and a simple text-based protocol. Demonstrates a clean IPC pattern for decoupling data producers from UI consumers.
A comprehensive Wayland screenshot utility built on grim and slurp. It supports area selection, window selection, fullscreen capture, freezing the screen before capture, clipboard integration, editor integration, and multiple output modes (save, copy, edit). It is a standalone, well-argued bash script with clear function separation and error handling.
A PyQt6 application and widget for editing `.dcol` color scheme files. It features a draggable curve editor widget for generating accent colors from a primary color, with presets for various color harmonies (Wallbash, Mono, Pastel, etc.). The CurveEditor widget is a self-contained, reusable GUI component for any application needing color curve manipulation.
A reusable shell argument parsing library that provides structured argument definition, parsing, and validation for bash scripts. It supports flags, options with values, and help text generation. It is a single-file, dependency-free module that can be sourced by any bash script to replace manual argument parsing.