Ulises Jeremias Dotfiles Save
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!
NEVER SKIP / IGNORE / AVOID README
🏠 HorneroConfig - Comprehensive Dotfiles Framework
:octocat: HI THERE! THANKS FOR DROPPING BY!
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.
TAP ❲☰❳ TO NAVIGATE THE HARMONY OF CONFIGURATION
Most were written from scratch. Some details:
- Window Manager 🍱 i3 and/or Openbox and/or XFCE!
- Panel 🌸 Polybar which is a fast and easy-to-use status bar!
- Application Launcher 🚀 Rofi which is blazing fast!
- Desktop Notification 🌿 Dunst which is minimalist!
- Terminal Emulator 🌿 Alacritty which is GPU accelerated!
- Shell 🐚 Zsh with several post-installation tweaks!
- Compositor 🍧 Picom fork by FT-Labs for that perfection topping with Animations!
- File Manager 🃏 Thunar with a customized side pane!
- Widgets 🎨 Eww with 2 different pre-backed widgets!
- and many more!
Managed with chezmoi, a great dotfiles manager.
Getting started 🚀
You can use a convenient script to install the dotfiles on any machine with a single command. Simply run the following command in your terminal:
sh -c "$(wget -qO- "https://github.com/ulises-jeremias/dotfiles/blob/master/scripts/install_dotfiles.sh?raw=true")"
💡 We use
wgethere because it comes preinstalled with most Linux distributions. But you can also usecurl:sh -c "$(curl -fsSL "https://github.com/ulises-jeremias/dotfiles/blob/master/scripts/install_dotfiles.sh?raw=true")"
This will install the dotfiles in ~/.dotfiles.
🌟 Other ways to install the dotfiles
Using Chezmoi
This is the recommended method to install HorneroConfig. It will set up the latest stable version of HorneroConfig on your system using Chezmoi, a robust and adaptable dotfiles manager. With Chezmoi, you can easily manage your configuration files across multiple machines, maintaining consistency and simplifying the setup process.
chezmoi init --apply ulises-jeremias --source ~/.dotfiles
This will install the dotfiles in ~/.dotfiles.
From source
Use this for any OS that is not
Arch LinuxorArch Linux based distro. This will install unstable versions of HorneroConfig. You can switch to a stable version by using any existing git tag.
git clone https://github.com/ulises-jeremias/dotfiles ~/.dotfiles
~/.dotfiles/install
The installation script allows you to install all the necessary dependencies to make your dotfiles config work correctly.
From the Arch-Linux User Repository (AUR)
-
Using a helper like yay
Install dots-stable
yay dots-stableor install the rolling release dots-git
yay dots-git -
Using
makepkgInstall dots-stable
git clone https://aur.archlinux.org/dots-stable.git /tmp/dots-stable cd /tmp/dots-stable makepkg -sior install the rolling release dots-git
git clone https://aur.archlinux.org/dots-git.git /tmp/dots-git cd /tmp/dots-git makepkg -si
🎨 Post install Customization
You can fork this repository and customize it to suit your preferences and workflow. You are encouraged to maintain a separate GitHub repository of configurations for your own dotfiles and keep this repository as a template!
Expand to see the steps to customize your environment!
We use Chezmoi to manage the dotfiles. Chezmoi is a sophisticated yet easy-to-use command-line tool that helps you manage your dotfiles across multiple machines. It is designed to be secure, flexible, and easy to use.
To customize the dotfiles, follow these steps:
-
Run the command
chezmoi init --source ~/.dotfilesto initialize Chezmoi. -
Run the command
chezmoi edit --source ~/.dotfilesto open the dotfiles directory. -
Customize the dotfiles to suit your preferences and workflow.
-
Run the command
chezmoi apply --source ~/.dotfilesto apply the changes.
Read more about this at Customization Docs.
🛡️ Privacy and Security
Although I like making it look as nice as possible, these dotfiles also try to be private and secure!
You can read more about this at Privacy and Security Docs.
🧪 Testing
We use Vagrant to test the installation of HorneroConfig in different Operating Systems and machine architectures.
Expand to learn how to run a testing environment!
To run the testing environment, just execute the following commands:
git clone https://github.com/ulises-jeremias/dotfiles
cd ./dotfiles
# start the VM
./bin/play
# provision the VM
./bin/play --provision
# remove the VM
./bin/play --remove
# use -h to know more about the available options
🤝 Contributing
Contributions, issues and feature requests are welcome! Check out the Contributing Guide for more details!
Bellow you can find a list of all the amazing contributors who have made this project possible:
Made with contributors-img.
Open Source Agenda Badge
