Skip to content
ulises-jeremias edited this page Aug 28, 2026 · 51 revisions

HorneroConfig

🏠 HorneroConfig - Comprehensive Dotfiles Framework

Docs | Changelog | Contributing

Awesome AUR Stable AUR Development License: MIT

You might be here looking for (Linux) rice reference or to (full?) replicate my personal configuration of my favorite Window Managers and several apps as well. ⛄

HorneroConfig is your artisanal toolkit for crafting the perfect digital workspace. Named after the industrious hornero bird, renowned for its skillful nest-building, our framework empowers you to construct a robust, functional, and personalized computing environment.

Perfectly suited for a wide array of Desktop Environments and Window Managers, HorneroConfig thrives across different platforms including GitHub Codespaces, Gitpod, VS Code Remote - Containers, or even Linux distributions that are not Arch Linux.

Backed by the versatile Chezmoi, HorneroConfig stands out as a dotfiles manager that adapts flexibly to your needs, streamlining machine setup and ensuring consistency across devices. Embrace the spirit of the hornero, and let HorneroConfig transform your configurations into a harmonious blend of elegance and efficiency.

✨ Key Features

  • 🎨 Advanced Appearance Themes: Switch between beautiful desktop themes instantly
  • 🧠 Smart Colors: Intelligent color adaptation for optimal readability and theme consistency
  • 🐚 Quickshell: Unified QML desktop shell (bar, launcher, dashboard, notifications, AI chat)
  • 🎨 Material Design 3: Intelligent color theming from wallpaper analysis
  • 🌊 Hyprland: Dynamic tiling Wayland compositor with smooth animations
  • 📦 Easy Management: Simple installation and configuration via chezmoi
  • 🔧 100+ Scripts: Comprehensive automation and utility scripts
  • 🔄 Automatic Theming: Seamless wallpaper-to-theme integration
  • 🛡️ Security: Built-in security auditing and hardening tools

Most were written from scratch. Core stack:

  • Compositor 🌊 Hyprland - Dynamic tiling Wayland compositor
  • Desktop Shell 🐚 Quickshell - Unified QML shell (bar, launcher, notifications, dashboard)
  • Launcher Fallback 🚀 terminal prompt - lightweight rescue launcher
  • Notifications 🔔 Built into Quickshell (replaces Mako)
  • Terminal Emulator 🐾 Kitty - GPU-accelerated terminal
  • Shell 🐚 Zsh with Powerlevel10k prompt
  • Lockscreen 🔒 Hyprlock - Secure lock screen
  • Wallpaper 🖼️ Quickshell Background + pywal/M3 via dots-wallpaper-set
  • File Manager 🃏 Thunar with customized side pane
  • and many more!

Dotfiles Screen Overview

Dotfiles Anime Light Theme Overview

Dotfiles Anime Dark Overview

Dotfiles Dark Overview

Nord Two Lines

Launchpad

🚀 Installation & Performance

Chaotic-AUR Repository

HorneroConfig automatically configures the Chaotic-AUR repository during installation. This provides:

  • ⚡ Precompiled Binaries: Skip building AUR packages from source
  • 🎯 Faster Setup: Reduce installation time by 50-70%
  • 🔄 Regular Updates: Automatically maintained packages
  • 📦 Popular Packages: Hyprland + Quickshell ecosystem, pamac-aur, auto-cpufreq, and more

The repository is configured automatically by the chezmoi script at:

home/.chezmoiscripts/linux/run_onchange_before_install-000-chaotic-aur.sh.tmpl

For more information, visit the Chaotic-AUR documentation.

📚 HorneroConfig Wiki

🏠 Getting Started

🪟 Window Manager & Desktop

Hyprland (Wayland)

Visual Components

Terminal & Shell

🔧 Scripts & Utilities

📜 Core Scripts

🎯 Key Tools

Quickshell-first flows:

Media & Screen:

System:

🎵 Studio & Audio

🛡️ System & Hardware

🧪 Development


🔍 Quick Access

Essential:

Recent Updates:

  • Dots Scripts - Quickshell-first command reference
  • 🆕 Hybrid GPU - NVIDIA/Intel power management
  • 🆕 Changelog 2025 - Latest changes

Clone this wiki locally