README.md

Dotfiles

This repository contains my configuration files (dotfiles) for various programs, managed using GNU Stow.

Installation

Prerequisites

Make sure you have GNU Stow installed. On Void Linux, you can install it with:

sudo xbps-install -S stow

Cloning the Repository

Clone this repository into your home directory (or any location you prefer):

git clone https://github.com/lev-linux/dotfiles.git ~/.dotfiles
cd ~/.dotfiles

Stowing Configurations

To create symlinks for a specific program, use:

stow --dotfiles <package>

For example, to apply the configurations for dwm and zsh, run:

stow --dotfiles dwm
stow --dotfiles zsh

This will create symlinks in your home directory (~), pointing to the corresponding files in ~/.dotfiles/dwm/ and ~/.dotfiles/zsh/.

If you need to overwrite existing files, use:

stow --dotfiles -R <package>

before restowing to remove old symlinks.

Directory Structure

Each configuration is stored in a separate directory, mimicking the home directory structure. For example:

~/.dotfiles/
├── dwm/
│   ├── .config/dwm/config.h
│   ├── .config/dwm/autostart.sh
│   └── ...
├── zsh/
│   ├── .zshrc
│   ├── .zshenv
│   └── ...
└── ...

Updating Configurations

To update a configuration, modify the files inside ~/.dotfiles/<package>/, then commit and push the changes.

Unstowing Configurations

To remove symlinks for a specific package, use:

stow --dotfiles -D <package>

Customization

Feel free to modify these dotfiles to suit your workflow. If you use different paths or need additional setups, update this README accordingly!