Skip to content

❓ Frequently Asked Questions (FAQ)

This page addresses common issues, troubleshooting steps, and answers to frequent questions regarding this Arch Linux Hyprland setup.

🚀 General & Setup

Q: Do I need a fresh installation of Arch Linux to use this rice?

A: A fresh Arch Linux installation is recommended to prevent software or configuration conflicts. [cite_start]However, you can run the bootstrap scripts on an existing installation as long as you have base-devel, git, and pacman/paru installed.

Q: How do I apply dotfile updates if you push changes to the repository?

A: Since dotfiles are managed via chezmoi, you can pull and apply the latest changes by running:

chezmoi re-add
# or to fetch remote changes:
chezmoi update

Q: How do I change the default shell back to Bash or Fish?

A: By default, the shell setup script configures Zsh with Oh My Zsh. To change your login shell to another installed shell (e.g., Bash), run:

chsh -s $(which bash)

🎨 Display, Themes & Audio

Q: How do I set or change my wallpaper?

A: Wallpaper management is powered by waypaper and hyprpaper. You can launch the GUI wallpaper picker or select from images downloaded to ~/Pictures/Walls/:

  • GUI Picker: Press SUPER + Space and launch Waypaper, or run waypaper in the terminal.
  • Manual Setup: Run the provided wallpaper script:
./walls.sh

Q: Fonts or icons look broken or appear as empty squares.

A: Run the local user font installation script to populate system fonts (Maple Mono NF, Noto Color Emoji, JetBrains Mono Nerd Font) and update your font cache:

chmod +x setup_font_local_user.sh
./setup_font_local_user.sh