dotfiles

Overview

My Arch Linux dotfiles for a clean, lightweight Hyprland setup. Managed with GNU Stow and optimized for a laptop + external monitor workflow.

Install

Warning

Back up your existing configs before installing.

1. Clone the repository

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

2. Install GNU Stow

Arch Linux:

sudo pacman -S stow

(Use your distro’s package manager if not on Arch.)

3. Deploy the dotfiles

install configs selectively, Stow creates symlinks into $HOME.

cd ~/dotfiles
stow hypr nvim zsh waybar wofi ghostty wal mpd rmpc scripts kanshi

4. Reload / apply configs

Some configs require a reload or restart

hyprctl reload
source ~/.config/zsh/.zshrc

Note

• Each directory represents a package managed by Stow
• Files are symlinked into $HOME following the XDG layout (~/.config/...)
• To remove a package: stow -D <package-name>

Dependencies

Core

• hyprland – Wayland compositor
• GNU Stow – dotfile symlink manager
• kanshi – dynamic monitor management

UI / Desktop

• wofi – application launcher
• hyprlock – screen locker
• wlogout – logout menu
• swaync – notification daemon
• pywal – wallpaper-based color theming

Terminal & Shell

• ghostty – terminal emulator
• zsh – shell
• starship – minimal and fast ZSH prompt

Editor & Tools

• Neovim – editor
• tmux – terminal multiplexer
• yazi - terminal file manager
• mpd – Music Player Daemon
• rmpc - terminal based mpd client

Screenshots

Install packages

To install the packages, you can run the installer script directly (Arch Linux only)

curl -sL https://raw.githubusercontent.com/houssamouhra/dotfiles/refs/heads/master/packages.sh | bash

Or, download and run the script manually:

cd dotfiles
./packages.sh