Skip to content

🛠 Installation Guide

This guide walks you through bootstrapping and setting up this Arch Linux hyprland configuration on a fresh installation.

📋 Prerequisites

Before starting, ensure you have:

  1. A fresh or working Arch Linux installation.
  2. An active internet connection.
  3. Git cloned repository (or access to the script execution environment).

🚀 Step-by-Step Installation

Step 1: System Bootstrap (install-arch.sh)

The primary bootstrap script handles package management, AUR setup, and directory initialization.

What it does:

  • Installs paru-bin (AUR helper) if not already installed.
  • Installs system packages listed in `pkglist.txt'.
  • Installs visual themes (papirus-icon-theme, bibata-cursor-theme-bin).
  • Runs xdg-user-dirs-update to set up standard directories (~/Downloads, ~/Documents, etc.).
  • Pre-creates target configuration directories under ~/.config/ (Hyprland, Waybar, Rofi, Ghostty, etc.).

Run Command:

chmod +x install-arch.sh
./install-arch.sh

Step 2: Shell Setup (setup-zsh.sh)

Sets up zsh as main interactive shell with oh-my0-zsh and plugins. What it does:

  • Installs zsh, git and curl if missing.
  • Install oh-my-zsh
  • Clones essential plugins *zsh-syntax-highlighting,*zsh-history-substring-search, *you-should-use
  • Fetches .zshrc and backing up existing config.
  • Changes default user shell to zsh.

Run Command:

chmod +x setup-zsh.sh
./setup-zsh.sh

Step 3: Local Fonts Installation '(setup_font_local_user.sh)'

Installs custom fonts directly to your user font directory.

What it does:

  • Copies font files (Maple Mono NF, Noto Color Emoji, etc.) from the repository's font folder to ~/.local/share/fonts/.
  • Rebuilds the system font cache (fc-cache -fv).

Run Command:

chmod +x setup_font_local_user.sh
./setup_font_local_user.sh

Step 4: Wallpapers Setup (wall.sh)

Downloads and prepares the wallpaper collection.

What it does:

  • Creates ~/Pictures/Walls if the directory doesn't exist.
  • Downloads the rice wallpaper collection into the target directory.

Run Command:

chmod +x wall.sh
./wall.sh

Step 5: Dotfiles Deployment (chezmoi)

Deploy your actual dotfile configurations using Chezmoi.

# Initialize and apply chezmoi state
chezmoi init [https://gitlab.com/asumito/dots.git](https://gitlab.com/asumito/dots.git)
chezmoi apply

🔄 Post-Installation

  • Reboot or Log Out: Log out of your session or reboot your system.
  • Display Manager: Log in via SDDM and choose the Hyprland session.
  • Verify Shell: Run exec zsh or launch a new terminal (Ghostty/Kitty) to ensure Zsh and Starship prompt loaded correctly.