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 ~/.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
• pure – minimal and fast ZSH prompt

Editor & Tools

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

Screenshots

Packages to Install

hyprland
hypridle
waybar
wlogout
hyprshot
stow
git
ghostty
pywal
kanshi
swww
zip unzip
wofi
cava
blueman
bluez
zathura
feh
bat
networkmanager
pipewire
pipewire-pulse
yay
brave-bin
imagemagick
yazi
ffmpeg
thunar
swaync
grim
grimblast
discord
wl-clipboard
wl-copy
fastfetch
yay
tldr
gvfs
libnotify
fd