⚠ Disclaimer

Warning

• Hyprland and Archlinux are not meant for beginners!
• It is strongly advised that you fully read and understand the documentation before installing.
• This project is based on ml4w-dotfiles, which can be found on the AUR.

What you need to consider before installing:

• This project was just recently made public and still needs many improvements.
• Tested on several models of dell laptops with intel processors and in KVM / qemu virtual machines.
• Not tested on AMD processors or with NVIDIA drivers.
• You might want to view the packages lists, and edit them to remove what you don't want or add extra packages.

Caution

• Removing packages from the lists might break things, especially the AUR packages.

⚙️ Setup and installation

Prerequisites:
If you have not done so already, you need a fresh minimal Archlinux installation.
If you want to use a different distro, which is totally fine, go ahead and install Archlinux anyway.

To install Arch manually, refer to the Arch install guide or, run archinstall from the archiso to install Arch the easy way.

Important

• If installing on bare metal, do not forget to backup your current installation before proceeding.
• Installing in virt-manager requires you to:
  • Enable [3D acceleration] in [Video Virtio].
  • Set [Listen type] to [None] in [Display Spice].
  • Set the virtual machine environment in hyprland.conf.

Usage:
Within your new Arch install, make sure all needed dependencies are installed for hyprarch2:

$ sudo pacman -S --needed --noconfirm wireless_tools dialog os-prober mtools dosfstools base-devel git reflector xdg-utils xdg-user-dirs gum figlet vim openssh

Then, clone hyprarch2 in ~/Downloads/ and run install.sh from ~/Downloads/hyprarch2/:

$ cd ~/Downloads && git clone --depth 1 https://github.com/g5ostXa/hyprarch2.git
$ cd hyprarch2 && ./install.sh

After the installation is completed, use the following to start hyprland from tty:

$ uwsm start hyprland

📦 Main apps

• Terminal: alacritty
• Shell: fish + starship
• Browser: firefox
• App Launcher: rofi-wayland
• Wallpaper front end: waypaper
• Wallpaper back end: swww
• Logout menu: wlogout
• Bar: waybar
• File Manager: nautilus
• Theming: GTK / python-pywal
• GUI Theme App: lxappearance
• Current GTK Theme: tokyonight-gtk-theme-git
• Current Cursor Theme: bibata-cursor-theme
• Editors: neovim / vscodium / obsidian
• AUR helper: User chooses between paru-bin and yay-bin during install.

⌨️ Keybinds

All available keybinds here:
➜ dotfiles/hypr/conf/keybindings.conf

General keybinds:

• ⌨️ SUPER + RETURN : Alacritty
• ⌨️ SUPER + B : Firefox
• ⌨️ SUPER + CTRL + RETURN : Rofi
• ⌨️ SUPER + CTRL + W : Waypaper
• ⌨️ SUPER + SHIFT + B : Reload waybar
• ⌨️ SUPER + CTRL + Q : Wlogout
• ⌨️ SUPER + Q : Killactive
• ⌨️ SUPER + E : Nautilus
• ⌨️ SUPER + SHIFT +N : Toggle hypridle
• ⌨️ SUPER + CTRL +M : Kill hyprland

🖥️ Monitor

Tip

• To configure your monitor(s), you need to edit dotfiles/hypr/conf/monitor.conf

Here's what a manual configuration should look like:

# -------------------------------------------------------------------------------------
# Monitor Setup
# -------------------------------------------------------------------------------------

# General:
monitor=eDP-1,[email protected],0x0,1
monitor=HDMI-A-1,[email protected],auto,1

# Virtual machine:
monitor=Virtual-1,[email protected],0x0,1

For more detailed instructions about how to configure your monitor(s): 🖥 Hyprland Wiki

🌐 Quick links

Wallpaper engine documentation:
➜ docs/wallpaper-waybar/README.md

Wallpaper source:
➜ g5ostXa/wallpaper

Packages lists:
➜ Pacman ➜ AUR

Contributions

If you like my project and want to contribute, feel free to submit a PR and give it a ⭐ !

   __                              __   ___
  / /  __ _____  _______ _________/ /  |_  |
 / _ \/ // / _ \/ __/ _ `/ __/ __/ _ \/ __/
/_//_/\_, / .__/_/  \_,_/_/  \__/_//_/____/
     /___/_/

[hypr@arch~]$ git clone https://github.com/g5ostXa/hyprarch2

📸 Screenshots