Installation Guide

Installation by one command

Copy and paste into the terminal:

                git clone --depth=1 -b main https://github.com/Mimic890/HyprArch.git ~/HyprArch && cd ~/HyprArch && [ -f Install.sh ] && chmod +x Install.sh && ./Install.sh
            

What does the installer do?

After running the command, the installation of HyprArch will begin. The installation takes place in interactive mode, step by step:

1. Checking your internet connection
   The script will check the Internet connection. If there is no connection, it will ask you to connect to the Internet. If NetworkManager is installed, it will open nmtui for quick connection in the same terminal window. It will also automatically detect your network interface and update the waybar configuration.
2. Activating scripts
   Makes all scripts in the repository folders executable if they were not executable originally.
3. Acquiring sudo privileges
   Requires the user's sudo password to install packages and move files outside the user's directory. Keeps the privilege alive during script execution.
4. Proposal to add the multilib repository
   It will ask whether to add the multilib repository (it is recommended to agree to add it).
5. System update
   Updates the system packages and AUR packages if yay is installed.
6. Creating a backup of the current system
   Creates a backup of the current system (recommended). All backups are stored in the ~/.config/hyprarch/backups/ folder.
7. Installing the necessary packages
   Installs basic packages, installs yay if missing, and installs required packages from both pacman and AUR. Checks that all packages were installed successfully or writes down which were not installed.
8. Screen resolution settings
   Runs the script that configures the resolution of the main screen. It will display all detected screens and ask you to select one from the list.
9. Creating standard directories
   Updates and creates standard XDG directories in the user directory (Video, Downloads, Documents, etc.).
10. Choosing the main shell
    Offers a choice between: fish, zsh, or keeping the current shell.
11. Configuring system services
    Includes services such as sddm, bluetooth, and others.
12. Installing and configuring themes
    GTK themes, Qt, icons, and more.
13. Selecting a theme for Waybar, Rofi, and Nwg-dock-hyprland
    Selecting the theme for waybar, nwg-dock-hyprland, and rofi.
14. Copying configurations
    Copies the configurations selected in the previous step and the configurations for hyprland, waypaper, btop, cava, and others.
15. Configuring SDDM and GRUB
    Configures the theme and configurations of sddm and grub.
16. Determining the video card
    Identifies your video card (AMD, NVIDIA, or Intel Arc) and installs the necessary drivers.
17. Customizing /etc/os-release
    Replaces the default /etc/os-release with HyprArch branding.
18. Wallpaper installation
    Installs wallpapers (basic set: 10–20, full set: 50+).
19. Selecting a text editor in the terminal
    Offers a choice of text editor: nano, vim, nvim (with my customization, astronvim customization, or without customization).
20. Installing CLI utilities
    Installs additional command-line utilities.
21. Installing additional programs
    Choice of additional programs to install (vs code, motrix, gimp, etc.) in the TUI interface. If you choose to install Visual Studio Code, you will be offered to install my custom HyprVSCode (optional).
22. Adding the BlackArch repository (optional)
    Asks if you want to add the BlackArch repository (not recommended for regular users). If you agree, a TUI interface will appear where you can select categories to install with a brief description.
23. Final cleanup
    Optionally restores repository configs and customs to their original state.