Skip to content
Projects

ulises-jeremias/dotfiles has 135 GitHub stars and 7 forks. GitHot measured 0 stars in 24 hours and 0 in 7 days. Last checked 2026-11-17 02:01 UTC. Last push 2026-11-15.

How these counts are measured

Measured star growth

in 24h
0
in 7 days
0
in 15 days
Collecting history
in 1 month
Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

HorneroConfig is a comprehensive dotfiles framework, tailored for seamless customization of diverse window management setups across various operating systems. Just like the skilled hornero bird meticulously shapes its nest, HorneroConfig empowers you to craft a digital environment that's robust, uniquely yours, and beautifully organized!

Developer Tools

README.md

Original

HorneroConfig

🚀 NEVER SKIP THE README - YOUR JOURNEY STARTS HERE! 🚀

🏠 HorneroConfig

✨ The Ultimate Linux Desktop Configuration Framework ✨

Intelligent • Beautiful • Powerful • Seamless

📖 Documentation • 🎨 Gallery • 🚀 Quick Start • 🤝 Contributing

Mentioned in Awesome Arch AUR hornero-config version AUR hornero-shell version MIT License Arch Linux Discord


🌟 What is HorneroConfig?

HorneroConfig Collage

HorneroConfig is a cutting-edge dotfiles framework that transforms your Linux desktop into a masterpiece of functionality and beauty. Named after the industrious hornero bird 🐦, renowned for its skillful nest-building, this framework empowers you to craft the perfect digital workspace.

✨ Highlights

🧠 Smart Color Intelligence — Automatic theme-aware color adaptation
🎨 12 Beautiful Themes — Cyberpunk, Cozy, Vaporwave, Nature & more
⚡ One-Command Setup — From zero to hero in minutes
🌊 Hyprland/Wayland — Modern compositor with smooth animations
🔧 100+ Automation Scripts — Comprehensive tooling ecosystem
🛡️ Security-First — Built-in auditing and hardening
📦 Zero Maintenance — Powered by chezmoi for seamless updates



🎨 Gallery

🖼️ Click to view screenshots

🌙 Dark Theme

Dark Theme

☀️ Light Theme

Light Theme

🚀 Application Launchers

Application Launcher Spotlight Dark


🚀 Quick Installation

⚡ Quick Install (Recommended)

git clone https://github.com/ulises-jeremias/dotfiles ~/.dotfiles
~/.dotfiles/install.sh

install.sh installs chezmoi if needed and runs chezmoi init --apply --source ~/.dotfiles.

🔄 Updating an existing install

cd ~/.dotfiles && git pull
~/.dotfiles/install.sh

This fast-forwards the checkout to the latest main and re-applies it. Your local files outside the chezmoi source are not touched by the pull; chezmoi shows and applies only the managed differences.

📦 Arch Linux (AUR)

yay -S hornero-shell hornero-config hornero-greeter   # HorneroOS product packages

💡 Performance Tip: HorneroConfig automatically configures Chaotic-AUR during installation, providing precompiled binaries for popular AUR packages in the Hyprland + Quickshell ecosystem to significantly reduce installation time.

🛠 More installation methods

Using Chezmoi

chezmoi init --apply ulises-jeremias --source ~/.dotfiles

From Source

git clone https://github.com/ulises-jeremias/dotfiles ~/.dotfiles
~/.dotfiles/install.sh

Manual AUR Build

git clone https://aur.archlinux.org/hornero-shell.git /tmp/hornero-shell
cd /tmp/hornero-shell && makepkg -si

💎 Key Features

🧠 Revolutionary Smart Colors System

Our game-changing smart colors technology automatically analyzes your color palette and intelligently selects optimal colors for UI elements:

✨ Semantic Intelligence — Error, success, warning, info colors that make sense
🎨 Theme Adaptation — Perfect contrast and readability on any background
⚡ Auto-Application — Instantly applies to Quickshell, Hyprland, and scripts via Material Design 3
🔄 Live Updates — Colors refresh automatically when you change wallpapers

📖 Learn more about Smart Colors →

🎨 Appearance Themes & Themes

Choose from 12 stunning themes organized by aesthetic: Cyberpunk, Cozy, Vaporwave, Nature, and Cosmic. Run dots appearance theme list for the full, current list:

dots appearance theme list              # See all available themes
dots appearance theme apply vapor-dreams

📖 Explore all themes →

🔧 Core Stack

🌊 Hyprland — Dynamic tiling Wayland compositor
🐚 Quickshell — Unified QML desktop shell (bar, launcher, dashboard, notifications, AI chat)
🐾 Kitty — GPU-accelerated terminal emulator
🐚 Zsh + Powerlevel10k — Feature-rich shell with beautiful prompt
🔒 Hyprlock — Secure lock screen
🖼️ Quickshell wallpaper flow — Unified wallpaper management via horneroctl wallpaper set
🎨 Appearance Themes — Instant theme switching with Material Design 3 colors

📖 Complete component list →

🛠️ Powerful Automation

Access 100+ built-in scripts via the dots command:

horneroctl package upgrade --yes  # Comprehensive system updates
horneroctl appearance colors      # Intelligent color analysis
horneroctl apps audit             # Security analysis and hardening
horneroctl appearance theme       # Appearance themes

📂 horneroctl config — Inspect and snapshot configuration
🔄 horneroctl package upgrade — Sync with upstream changes

📖 Scripts documentation →


🧪 Development & Testing

🎮 Safe Testing Environment

Try HorneroConfig risk-free with our Vagrant playground:

git clone https://github.com/ulises-jeremias/dotfiles && cd dotfiles
./bin/play                        # Start VM
./bin/play --provision hyprland   # Provision with Hyprland
./bin/play --remove               # Clean up

📖 Testing guide →

🔧 Contributing

We use pre-commit for code quality:

Install uv first:

  • Arch Linux: sudo pacman -S uv
  • Other platforms:
    • Installation script: curl -LsSf https://astral.sh/uv/install.sh | sh
    • Homebrew: brew install uv
uv tool install pre-commit  # Install pre-commit
# One-shot alternative: uvx pre-commit run --all-files

pre-commit install          # Set up hooks
pre-commit run --all-files  # Run all checks

🤝 Contributing guide → | Development standards →


📖 Documentation

📚 For Users

🏠 Getting Started — First steps and basic setup
🎨 Appearance Themes — Theme management
🧠 Smart Colors — Intelligent theming
🐚 Quickshell — Desktop shell configuration
🔧 Scripts — Automation tools
🛡️ Security — Privacy and security

🤖 For Developers & AI Agents

📋 AGENTS.md — Quick reference guide
🏗️ Architecture — Design principles
📐 ADRs — Architecture decisions
🔒 Security — Security practices
⚡ Performance — Optimization strategies


🌍 Platform Support

🐧 Arch Linux — Full support with AUR packages (primary target)
🐧 Ubuntu/Debian — Partial: the Docker install fragment supports Ubuntu/Pop!_OS; everything else is Arch-only (manual porting required)
☁️ Cloud Dev — GitHub Codespaces, Gitpod, VS Code Remote

📖 Platform-specific guides →


🤝 Contributing

We welcome all contributions! 🎉

🐛 Bug reports • ✨ Feature requests • 🎨 New themes • 📚 Documentation • 🔧 Code

🌟 Contributors


🙏 Credits & Attribution

Quickshell Desktop Shell

The Quickshell implementation in HorneroConfig was highly inspired by and adapted from the amazing work of the caelestia-dots/shell project by @soramanew.

  • Original Project: caelestia-dots/shell
  • License: GNU General Public License v3.0 (GPL-3.0)
  • What we adapted: UI/UX design, desktop shell architecture, C++ plugin structure

The original GPL-3.0 license is preserved in home/dot_config/quickshell/LICENSE. We are deeply grateful for the beautiful and functional desktop shell that inspired our implementation.


💝 Show Your Support

If HorneroConfig has improved your Linux experience:

⭐ Star this repo • 🐦 Share it • 🤝 Contribute


🏠 HorneroConfig
Building the perfect digital nest, one configuration at a time

Licensed under MIT License • Made with ❤️ for the Linux community