ulises-jeremias/dotfiles
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.
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 ToolsREADME.md
Original
🚀 NEVER SKIP THE README - YOUR JOURNEY STARTS HERE! 🚀
🏠 HorneroConfig
✨ The Ultimate Linux Desktop Configuration Framework ✨
Intelligent • Beautiful • Powerful • Seamless
📖 Documentation • 🎨 Gallery • 🚀 Quick Start • 🤝 Contributing
🌟 What is HorneroConfig?

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

☀️ Light Theme

🚀 Application Launchers

🚀 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
🎨 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
🔧 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
🛠️ 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
🧪 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
🔧 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
- Installation script:
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
📖 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
🤝 Contributing
We welcome all contributions! 🎉
🐛 Bug reports • ✨ Feature requests • 🎨 New themes • 📚 Documentation • 🔧 Code
🙏 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