🛠️ kyroceus/dotfiles

My personal dotfiles for setting up a consistent development environment across systems. Powered by stow, systemd user services, and a touch of automation.

📦 Structure

This repo is structured with GNU Stow in mind. Each directory (like zsh, nvim, etc.) corresponds to a self-contained configuration that can be symlinked into the appropriate location in your home directory.

dotfiles/
├── i3
│   └── .config
│       ├── i3
│       └── i3status.conf
├── kitty
│   └── .config
│       └── kitty
├── nvim
│   └── .config
│       └── nvim
├── systemd
│   ├── battery_notifier.sh
│   └── .config
│       └── systemd
├── tmux
│   └── .tmux.conf
├── x
│   ├── .xinitrc
│   └── .Xresources
└── zsh
    └── .zshrc

🚀 Quick Start

1. Clone the repo

git clone https://github.com/kyroceus/dotfiles.git ~/dotfiles
cd ~/dotfiles

2. Install dependencies

Make sure stow is installed:

# Ubuntu/Debian
sudo apt install stow

# Fedora
sudo dnf install stow

# macOS (Homebrew)
brew install stow

# Arch
sudo pacman -S stow

3. Stow your configs

Pick and choose which configs to use:

stow zsh
stow nvim
stow kitty
stow tmux
stow x
stow i3

or could use whole config

stow */

This will symlink the contents into your $HOME directory.

To unstow (remove symlinks):

stow -D */

🧠 systemd User Services (Optional)

The dotfiles contains user-level systemd service for notifying battery status.

Enable lingering for your user (if you want battery notify service to run before login):

sudo loginctl enable-linger $USER

Symlink user services

stow systemd

Then reload and enable your service:

systemctl --user daemon-reexec
systemctl --user daemon-reload
systemctl --user enable --now battery-check.timer

To check all timers you can use

systemctl --user list-timers

🔁 Updating your dotfiles

Since everything is symlinked, just edit the files in ~/dotfiles and commit your changes. Updates will reflect immediately.

📂 Recommended Directory Layout

If you'd like to contribute or fork for your own setup, follow this convention:

• bin/: Scripts and CLI tools
• zsh/, bash/, etc.: Shell-specific configs
• nvim/, vim/: Editor configs
• tmux/: Multiplexer configs
• systemd/: User-level systemd services
• git/: Global git config

🧰 Tools I Use

• Zsh
• Neovim
• Tmux

🤝 Contributions

Feel free to fork or raise PRs if you find useful enhancements. Suggestions welcome!