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

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

This template is based on the original HorneroConfig dotfiles and provides a clean, customizable starting point for your own dotfiles journey.

• 🧠 Smart Color Intelligence - Revolutionary color system that adapts to any theme
• 🎨 Beautiful Rice Themes - 12+ stunning pre-configured desktop themes
• ⚡ One-Command Setup - From zero to hero in minutes
• 🔧 100+ Automation Scripts - Comprehensive tooling ecosystem
• 🪟 Multi-WM Support - Works with i3, Openbox, XFCE4, and more
• 🛡️ Security-First - Built-in security auditing and hardening
• 📦 Zero Maintenance - Powered by chezmoi for seamless updates
• 🔄 Template Ready - Fork and customize without losing core functionality

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

• 🎯 Semantic Intelligence: Error, success, warning, info colors that make sense
• 🎨 Theme Adaptation: Perfect contrast and readability on any background
• ⚡ Auto-Application: Instantly applies to Polybar, EWW, i3, and all scripts
• 🔄 Live Updates: Colors refresh automatically when you change wallpapers

🌙 Dark Theme Showcase

☀️ Light Theme Excellence

🚀 Application Launcher

This is a template repository - a clean, reusable version of the original HorneroConfig dotfiles.

• ✅ Personal credentials removed - No LastPass dependencies
• ✅ Generic placeholders - Easy to customize for your needs
• ✅ Template-ready SSH keys - Placeholder files for your keys
• ✅ Configurable API keys - Set your own service tokens
• ✅ Clean git history - Start fresh with your own commits

1. Fork this repository on GitHub
2. Clone your fork: git clone https://github.com/<your-username>/dotfiles-template ~/.dotfiles
3. Run setup: cd ~/.dotfiles && ./install.sh
4. Customize: Follow the Template Setup Guide

💡 New to dotfiles? Check the Template Setup Guide for detailed instructions.

1. Fork this repository to create your own dotfiles:

   # Replace <your-username> with your GitHub username
   git clone https://github.com/<your-username>/dotfiles-template ~/.dotfiles

2. Install using the template:

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

If you want to use the original dotfiles directly:

sh -c "$(wget -qO- "https://github.com/ulises-jeremias/dotfiles-template/blob/main/scripts/install_dotfiles.sh?raw=true")"

💡 Alternative with curl:

sh -c "$(curl -fsSL "https://github.com/ulises-jeremias/dotfiles-template/blob/main/scripts/install_dotfiles.sh?raw=true")"

# Stable release
yay -S dots-stable

# Development release (latest features)
yay -S dots-git

# For your forked template repository
chezmoi init --apply <your-username> --source ~/.dotfiles

# For the original repository (not recommended for personal use)
chezmoi init --apply ulises-jeremias/dotfiles-template --source ~/.dotfiles

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

git clone https://aur.archlinux.org/dots-stable.git /tmp/dots-stable
cd /tmp/dots-stable && makepkg -si

Choose from our curated collection of stunning desktop themes:

# Interactive theme selector
dots rofi-rice-selector

# Apply specific theme
dots rice apply gruvbox-anime

# Apply minimalistic theme
dots rice apply gruvbox-minimalistic

# Apply nature theme
dots rice apply landscape-dark

# List all available themes
dots rice list

Access a comprehensive toolkit through the dots command:

# Interactive script browser
dots scripts

# System management
dots sysupdate          # Comprehensive system updates
dots backup             # Automated backups with scheduling
dots security-audit     # Security analysis and hardening

# Theming & visuals
dots smart-colors       # Intelligent color analysis
dots wal-reload         # Complete theme refresh
dots rofi-rice-selector # Visual theme picker

# System monitoring
dots monitor            # Display management
dots performance        # System benchmarks
dots weather-info       # Weather integration

Experience the future of desktop theming:

# Analyze your current palette
dots smart-colors --analyze

# Export colors for different applications
dots smart-colors --export --format=polybar
dots smart-colors --export --format=eww
dots smart-colors --export --format=i3

# Get optimal color for specific concepts
dots smart-colors --concept=error --format=hex
dots smart-colors --concept=success --format=rgb

• 🔍 Security Auditing: Comprehensive system security analysis
• 🛡️ Hardening Tools: Automated security configuration
• 🔐 Privacy Protection: Privacy-focused defaults and tools
• 📊 Security Monitoring: Continuous security health checks

# Run complete security audit
dots security-audit

# Apply security hardening
dots security-audit --apply

# Check system security status
dots security-audit --status

Test HorneroConfig safely with our Vagrant-based playground:

git clone https://github.com/ulises-jeremias/dotfiles
cd dotfiles

# Start testing environment
./bin/play

# Provision with different WMs
./bin/play --provision i3
./bin/play --provision openbox

# Clean up
./bin/play --remove

Contribute with confidence using our quality tools:

# Install development dependencies
pip install pre-commit

# Set up git hooks
pre-commit install

# Run quality checks
pre-commit run --all-files

Comprehensive guides for every aspect:

• 🏠 Getting Started - Your first steps
• 🎨 Rice System - Theme management
• 🧠 Smart Colors - Intelligent theming
• 📊 Polybar Config - Status bar setup
• 🎛️ EWW Widgets - Modern widgets
• 🔧 Scripts Guide - Automation tools
• 🛡️ Security - Privacy & security

Join our amazing community! We welcome:

• 🐛 Bug Reports - Help us improve
• ✨ Feature Requests - Share your ideas
• 🎨 New Rice Themes - Show your creativity
• 📚 Documentation - Help others learn
• 🔧 Code Contributions - Make it better

Made with ❤️ by our amazing community