Arch Linux Installer & Desktop Setup

Interactive scripts for installing Arch Linux on Hardware or VMs and setting up a modern Hyprland desktop environment.

Scripts

Script	Purpose
install-arch.sh	Base Arch Linux installation (partitioning, bootloader, users, graphics drivers)
setup-ambxst.sh	Hyprland + Ambxst desktop environment setup
setup-hyprland.sh	Hyprland + Nucleus Shell full desktop environment setup

Features

• Gum TUI: A beautiful terminal interface for base installation via gum.
• Driver Support: Built-in support for Intel (Arc/Integrated), AMD (Radeon), Nvidia (Proprietary/Open/DKMS), and VM (VirtIO) graphics.
• Hardware & VM Compatible: Handles NVMe/SATA partitioning and bootloader setup automatically.

---

How to Use

1. Base Installation

Run this script inside the Arch Linux live ISO environment.

curl -O https://raw.githubusercontent.com/128bytes8/arch-installer/master/install-arch.sh
chmod +x install-arch.sh
./install-arch.sh

2a. Desktop Setup — Hyprland + Nucleus Shell (Recommended)

After rebooting into your new system, run this script for a complete Hyprland desktop with Nucleus Shell.

curl -O https://raw.githubusercontent.com/128bytes8/arch-installer/master/setup-hyprland.sh
chmod +x setup-hyprland.sh
./setup-hyprland.sh

What it installs:

Category	Packages
Compositor	Hyprland (scrolling layout)
Shell	Nucleus Shell (bar, dock, launcher, power menu, sidebars)
Login Manager	SDDM + VoidSDDM theme
Terminal	Ghostty
Browser	Helium Browser
File Manager	Thunar + all extensions (thumbnails, archives, media tags, drive mounting)
Media Player	mpv + noelsimbolon/mpv-config
AI IDE	Antigravity
Cursor Theme	Bibata Modern Classic
Font	VCR OSD Mono (system 10pt / terminal 14pt)
Utilities	xclip, udiskie, gvfs (MTP, SMB, NFS, etc.)

What it configures:

• Hyprland — Scrolling layout (windows scroll horizontally), Ghostty as terminal, Thunar as file manager, Nucleus Shell autostart
• Bibata Modern Classic — Set as default cursor via env vars + hyprctl setcursor
• VCR OSD Mono — System font (10pt via GTK3/GTK4/gsettings), terminal font (14pt via Ghostty config)
• SDDM — Enabled with VoidSDDM theme
• Wallpaper — Downloaded and set via Nucleus Shell config
• Drive mounting — udisks2 + udiskie for automatic USB/external drive support

Keybinds:

Shortcut	Action
SUPER + RETURN	Open Ghostty terminal
SUPER + Q	Close active window
SUPER + E	Open Thunar file manager
SUPER + SPACE	Open Nucleus Shell launcher
SUPER + V	Toggle floating
SUPER + ←/→	Focus columns (scrolling layout)
SUPER + SHIFT + ←/→	Swap columns
SUPER + [/]	Resize columns
SUPER + 1-0	Switch workspaces

2b. Desktop Setup — Hyprland + Ambxst (Legacy)

Alternative setup using Ambxst instead of Nucleus Shell.

curl -O https://raw.githubusercontent.com/128bytes8/arch-installer/master/setup-ambxst.sh
chmod +x setup-ambxst.sh
./setup-ambxst.sh

---

Requirements

• Arch Linux (base install or live ISO for install-arch.sh)
• yay AUR helper (required for setup-hyprland.sh and setup-ambxst.sh)
• Internet connection