HorneroConfig · Personal DX desktop
The framework that builds your digital nest. Hyprland + Quickshell + Kitty + Zsh orchestrated by chezmoi and ~46 dots-* scripts. Smart Colors maps wallpaper → palette → scheme → apps with python-materialyoucolor.
One-command install
sh -c "$(curl -fsSL https://github.com/ulises-jeremias/dotfiles/blob/main/scripts/install_dotfiles.sh?raw=true)"yay -S dots-stablechezmoi init --apply ulises-jeremiasdots appearanceNarrative
“Like the hornero, build your digital nest: robust, beautiful, and tailored to you.”
HorneroConfig is named after the hornero, the bird that builds robust nests adapted to its environment. Each layer — from chezmoi to shell — plays a structural role: isolated in development, integrated in use.
The philosophy is modular and resilient: graceful degradation without optional dependencies, a single source of truth in ~/.cache/dots/ and ~/.config/, and automation that turns an empty system into a productive desktop.
The stack unites Hyprland/Wayland with Quickshell (QML + Hornero C++ plugin), GPU-accelerated Kitty, Zsh/Powerlevel10k, and ~46 dots-* scripts. Each of the 22 rices is a self-contained directory with config.json, backgrounds/, and preview.png — no apply.sh.
Chezmoi orchestrates templates and idempotent hooks. Install with chezmoi init --apply ulises-jeremias, then manage appearance with dots appearance and Smart Colors.
Smart Colors analyzes the wallpaper with python-materialyoucolor, detects luminance for light/dark mode, maps semantics (red→error, green→success), and optimizes WCAG contrast. It generates once and caches scheme.json (Material Design 3) plus variants for Hyprland, shell, and GTK.
When you change wallpaper, the Quickshell Colours service regenerates the palette and applies it atomically to bar, borders, kitty, and lock — no hardcoded theme values.
Architecture
Five isolatable layers that chezmoi unites into an atomic system. Bottom-up: declarative foundation (chezmoi) → automation (scripts) → render (terminal + compositor) → interaction (shell). Tab or use screen readers to explore each layer.
Declarative, idempotent foundation
Orchestration of ~46 dots-* utilities
GPU rendering and observability
Modern animated Wayland desktop
Fluid daily interaction
Smart Colors
Four stages: wallpaper → extraction → palette → apps. Pause, replay, or use the static fallback. Honorsprefers-reduced-motion.
Image curated per rice in backgrounds/
dots appearance / dots-wallpaper-set records the change and triggers the pipeline.
Quantization and luminance analysis
python-materialyoucolor extracts dominants, computes luminance, and decides light/dark.
Material Design 3 scheme.json
Generates primary/secondary/tertiary/error/neutral in ~/.cache/dots/smart-colors/.
Atomic application across the desktop
Quickshell Colours, Hyprland, Kitty, GTK, and Hyprlock consume the same source.
↳ Full pipeline visible without animation. Enable the animated view with “Show animation” if your system allows it.
Image curated per rice in backgrounds/
dots appearance / dots-wallpaper-set records the change and triggers the pipeline.
Quantization and luminance analysis
python-materialyoucolor extracts dominants, computes luminance, and decides light/dark.
Material Design 3 scheme.json
Generates primary/secondary/tertiary/error/neutral in ~/.cache/dots/smart-colors/.
Atomic application across the desktop
Quickshell Colours, Hyprland, Kitty, GTK, and Hyprlock consume the same source.
Step 1 of 4: Wallpaper — Image curated per rice in backgrounds/
Gallery
First-party screenshots from dotfiles/static (MIT). Lazy-loaded, descriptive alt, and license notes below — no stock wallpapers or unverified collage assets.
public/media/dotfiles/ are copied fromulises-jeremias/dotfiles/static (MIT, 2019–2025).caelestia-dots/shell — respect GPL-3.0 if redistributing derived binaries.License verification
This site and HorneroConfig share author and base MIT license, with an attributed exception for Quickshell adapted from caelestia-dots/shell (GPL-3.0). Verify before redistributing binaries or wallpapers.
MITLICENSE — Copyright (c) 2025-2026 Ulises Jeremias Cornejo Fandos
Dotfiles feature content and /dotfiles page under the site MIT license.
MITgithub.com/ulises-jeremias/dotfiles/LICENSE (2019-2025)
dots-* scripts, hypr/kitty/zsh/tmux configs, rices, and docs. MIT-compatible reuse.
GPL-3.0caelestia-dots/shell by soramanew — GPL-3.0
Quickshell implementation adapted from caelestia-dots/shell. Redistributing derived binaries requires GPL-3.0 compliance and source.
MIT (dotfiles) — wallpapers varypublic/media/dotfiles/* from dotfiles/static
First-party captures are MIT. Individual rice wallpapers may carry their own licenses — verify before redistribution.
website/LICENSE exists — MIT Copyright (c) 2025-2026 Ulises Jeremias Cornejo Fandos — valid.dotfiles/LICENSE (sibling repo) — MIT 2019-2025 — same author — compatible.caelestia-dots/shell referenced in dotfiles README with attribution and GPL-3.0 — respected in /dotfiles.dotfiles/static/* — MIT — safe for placeholders; per-rice wallpapers — verify individually.Tools: cat LICENSE + manual README review + pnpm knip with no extra conflicting licenses. This page is not legal advice.
Clone, apply a rice and let Smart Colors handle the rest. Your nest, your rules.