Installation - Pahasara/HyprDots GitHub Wiki

This guide will walk you through the process of installing HyprDots, a complete and customized Hyprland environment for Arch Linux.

📋 Prerequisites

Before beginning the installation, ensure your system meets these requirements:

• Arch Linux or an Arch-based distribution (Endeavour, Manjaro, etc.)
• Wayland-compatible graphics hardware and drivers
• Internet connection for downloading packages

🔍 Pre-Installation Checklist

1. Backup your data: The installation script will create backups of your existing configurations, but it's always good practice to backup important data yourself.

2. Update your system: It's recommended to update your system before installation:

   sudo pacman -Syu
   

3. Install git if not already installed:

   sudo pacman -S git
   

🛠️ Installation Steps

1️⃣ Clone the Repository

cd
git clone --depth 1 https://github.com/Pahasara/HyprDots.git
cd HyprDots

2️⃣ Review the Installation Script (Optional)

Before running the installer, you can review what it will do:

less install.sh

The script will:

• Check if your system is compatible
• Create backups of your existing configurations
• Install required packages from official repositories and AUR
• Set up Zsh with Oh My Zsh and plugins
• Configure system services
• Install HyprDots configuration files

3️⃣ Run the Installation Script

chmod +x install.sh
./install.sh

[!WARNING] Do not run the script with sudo. The script will prompt for your password when needed.

During installation:

• You'll be asked to confirm before proceeding
• The script will display progress information
• You may be prompted for your password several times
• At the end, you'll be asked if you want to reboot

4️⃣ Post-Installation

After rebooting, you'll be greeted with the SDDM login screen. Log in to your new Hyprland environment.

Key things to know after first login:

• The Super (Windows) key is the main modifier
• Press Super + Space to open the application launcher
• Press Super + Return to open a terminal
• Press Super + W to open the WiFi menu
• Press Super + X to open the power menu

[!IMPORTANT] If you encounter any issues, please refer to Troubleshooting.

🔄 Updating HyprDots

To update your HyprDots installation in the future:

1. Pull the latest changes:

   cd ~/HyprDots
   git pull
   

2. Run the installation script again:

   ./install.sh
   

The script will detect existing configurations and update them accordingly.

🧹 Uninstallation

If you need to remove HyprDots:

1. Restore your backups (located in ~/hyprdots_backup_*)
2. Or manually remove the configurations.

📚 Next Steps

After installation, check out these pages to learn more:

• Keybindings - Learn all available keyboard shortcuts
• Customization - Personalize your setup
• Components - Learn about included software

---

If you encounter any issues not covered here, please open an issue on GitHub.