Customization - ulises-jeremias/dotfiles GitHub Wiki

🎨 Dotfiles Customization Guide

This repository is designed to be a starting point for your personalized dotfiles setup. You’re encouraged to fork it, adapt it to your needs, and maintain your own GitHub repository with your custom configurations.

[!TIP] The dotfiles use Chezmoi to manage, edit, and apply configuration changes across multiple machines β€” securely and efficiently.

πŸ› οΈ Getting Started with Customization

1. Fork This Repository

Create your own version of the dotfiles:

git clone https://github.com/<your-username>/dotfiles.git ~/.dotfiles

2. Initialize Chezmoi

[!IMPORTANT] This dotfiles setup includes references to my personal LastPass vault for storing sensitive information (like tokens or secrets).
If you plan to use or adapt these configs, make sure to replace or remove any references to LastPass and configure your own preferred secret management method β€” such as Bitwarden, 1Password, pass, gopass, or chezmoi's built-in encrypted secrets.
Double-check any scripts or encrypted templates (*.tmpl) before applying changes.

Link your forked dotfiles directory with chezmoi:

chezmoi init --source ~/.dotfiles

3. Edit Your Configurations

Use chezmoi’s built-in editing command:

chezmoi edit --source ~/.dotfiles

Make the changes that suit your preferences:

  • Theme and style adjustments
  • New keybindings
  • Custom scripts
  • Tool settings and plugins

4. Apply Your Changes

Once you're ready:

chezmoi apply --source ~/.dotfiles

All changes will be synced to your system.

πŸ“ What You Can Customize

  • πŸͺŸ Window manager settings (i3, Openbox, XFCE4)
  • πŸ’» Terminal experience (Zsh, Kitty)
  • 🎨 Theme and color schemes (Rofi, Polybar, Pywal)
  • πŸ› οΈ Utility scripts (dots) and workflow helpers
  • πŸ”’ Security tools and system behaviors

[!TIP] Use chezmoi diff to preview your changes before applying.

🎨 Theming & Visual Customization

Smart Colors System

The dotfiles include an intelligent color system that automatically optimizes colors for any theme:

  • Semantic Colors: Error, success, warning, info colors that adapt to any palette
  • Theme Intelligence: Automatically selects optimal colors based on wallpaper
  • Application Integration: Works with Polybar, EWW, i3, and custom scripts
  • Automatic Updates: Colors refresh automatically when changing wallpapers

Learn more: Smart Colors System

Rice Theme Management

🌍 Multi-Machine Consistency

One of the biggest advantages of using Chezmoi is portable configuration. You can sync your setup across multiple machines using a private or public GitHub repository.

Just run:

chezmoi init [email protected]:<your-username>/dotfiles.git
chezmoi apply

And your personalized setup will be ready!

πŸ†˜ Need Help?

Go ahead β€” personalize everything. Make your desktop, terminal, and tooling truly yours! πŸš€