Welcome to my dotfiles repository! Here you'll find my personal configuration files for various tools and applications. I use GNU Stow to manage these dotfiles, making it simple to deploy and organize my setup on different systems.
To set up these dotfiles on your system, follow these steps:
-
Ensure GNU Stow is installed on your system:
# For Debian-based systems sudo apt-get install stow # For Arch-based systems sudo pacman -S stow # For Red Hat-based systems sudo yum install stow # For macOS brew install stow
-
Clone the repository to your home directory:
git clone https://github.com/smazmi/dotfiles.git ~/.dotfiles -
Navigate to the repository:
cd ~/.dotfiles
🚀 Usage
This dotfiles repository is organized by tool or application. Use Stow to apply the configuration for a particular tool. For example:
stow kitty
stow lvim
stow neofetch
# ... and so onor stow */ can be used to symlink all the configurations at once.
Feel free to mix and match configurations based on your preferences.
The repository structure is organized as follows:
.
├── 📂 bat
├── 📂 kitty
├── 📂 fastfetch
├── 📂 nvim
├── 📂 lvim
├── 📂 neofetch
├── 📂 tmux
├── 📂 xremap
├── 📂 yazi
├── 📂 zsh
├── 🖼 logo.png
├── 📄 README.md
├── 📄 .gitignore
└── 📄 .stow-local-ignore
Each directory corresponds to a specific tool or application with its respective configuration files.
This dotfiles repository utilizes a local stow ignore mechanism with the .stow-local-ignore file. It allows customization of the stowing process by excluding specified files or directories locally.
The .stow-local-ignore file is designed to skip certain configurations during stowing, offering flexibility. This is particularly useful for keeping sensitive or machine-specific information local.
-
Examine the existing
.stow-local-ignorefile for specified patterns. -
Modify the file to exclude files or directories according to your preferences.
If changes are made to .stow-local-ignore, restow using:
stow -R configuration-nameBy leveraging this local stow ignore feature, you can maintain a clean, organized set of configurations while respecting local nuances.
Feel free to customize these dotfiles to suit your preferences. Modify the configuration files or add your own. To keep things organized, consider creating a separate folder for your custom configurations.
If you have improvements or additional configurations to share, open an issue or submit a pull request. Contributions are welcome!