Retro-Orange, a Gruvbox themed Hyprland setup

---

Installation Guide

This guide assumes a fresh Arch Linux install. Everything is organized into layers - install what you need.

Layer 1: Essentials (Recommended for everyone)

# Install base packages
sudo pacman -S --needed \
  hyprland sddm waybar rofi dunst kitty starship systemd \
  git grim wl-clipboard playerctl bluez bluez-utils \
  networkmanager pipewire pipewire-pulse wireplumber \
  nerd-fonts

# Install yay (AUR helper)
git clone https://aur.archlinux.org/yay.git /tmp/yay && cd /tmp/yay && makepkg -si

# Install essential AUR packages
yay -S zen-browser nautilus

Layer 2: Shell & Terminal

# Install zsh essentials
sudo pacman -S zsh lsd fastfetch
yay -S zsh-autosuggestions zsh-syntax-highlighting

# Install oh-my-zsh
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

# Copy zsh config
cp .zshrc ~

# Install starship (prompt)
sudo pacman -S starship

# Copy starship config
mkdir -p ~/.config/starship
cp config/starship/starship.toml ~/.config/starship/

Layer 3: Per-Component Extras

Install only what you want to use:

Component	Command
waybar	sudo pacman -S cava nordvpn curl jq gcalcli usbutils
nvim	sudo pacman -S git cargo nodejs npm
kitty font	yay -S ttf-caskaydia-cove-nerd
hyprland extras	sudo pacman -S hyprlock hyprpicker hyprshot satty swww
eww widgets	yay -S eww

Copy Configs

# Copy all XDG configs
cp -r config/* ~/.config/

# Copy Pi settings and custom theme
mkdir -p ~/.pi/agent/themes
cp pi/agent/settings.json ~/.pi/agent/
cp pi/agent/themes/*.json ~/.pi/agent/themes/

# Install cursor theme
mkdir -p ~/.local/share/icons
tar -xf cursor_theme/Simp1e-Gruvbox-Dark.tar.xz -C ~/.local/share/icons/

# Install fonts
fc-cache -fv

Workstation Notes

The Waybar config includes optional workstation widgets for Eww and robot ethernet status. To customize robot ethernet, create this untracked file after copying configs:

cat > ~/.config/waybar/scripts/robot-eth.conf <<'EOF'
ROBOT_IP=192.168.42.1
IFACES="enp0s31f6 enp7s0"
# ROBOT_CONNECTION="Wired connection 1"
EOF

If the file is missing, the widgets use safe defaults and still render.

Login Screen (SDDM)

# Copy gruvbox-sddm theme files
sudo cp -r config/sddm/* /usr/share/sddm/themes/gruvbox-sddm/

# Configure SDDM to use the theme
echo "[Theme]
Current=gruvbox-sddm" | sudo tee /etc/sddm.conf

---

Optional Programs

Not included in the install scripts - install manually if wanted:

Program	Install
Zen Browser	yay -S zen-browser
Vesktop (Discord)	yay -S vesktop
Spicetify	yay -S spicetify-cli
Steam	sudo pacman -S steam
Gqrx (SDR)	yay -S gqrx gtk-4.0 kvantum qt5ct

---

Package Reference

• requirements-base.txt - Core packages (hyprland, waybar, rofi, etc.)
• requirements-aur.txt - AUR packages (yay, zen-browser, vesktop, nautilus)
• config/*/requirements.txt - Per-component extras

---

Programs Used (not in this repo)

• Browser: Zen Browser with custom theme
• Discord: Vesktop with custom Gruvbox theme
• File Manager: Nautilus