Home

Hyprland Rice Wiki

Welcome to the Hyprland Rice documentation.

This Wiki contains all guides, explanations, and references related to setting up and using this repository. The main README is intentionally kept short — everything detailed lives here.

---

What is Hyprland Rice?

Hyprland Rice is a modular and interactive setup for Hyprland, designed to make installation and configuration easier without forcing a fixed workflow.

Instead of providing a single hard-coded rice, this project focuses on:

• giving users choices,
• keeping things transparent,
• and staying flexible across different Linux distributions.

You can use this repository as:

• a starting point for a new Hyprland setup,
• a reusable base when reinstalling a system,
• or a reference for organizing your own configs.

---

Project philosophy

• Opt-in by default
  Nothing is installed without your confirmation.
• Distro-aware
  Package installation and behavior vary by distribution and are handled accordingly.
• Non-destructive
  Existing configuration files are backed up before new ones are applied.
• Minimal assumptions
  The project does not assume a specific workflow, theme, or usage style.

Hyprland Rice is not meant to replace learning Hyprland — it’s meant to make getting started (and restarting) smoother.

---

How the installer works (high level)

The installer is an interactive script that:

1. Detects your Linux distribution
2. Installs required core components
3. Offers optional packages (bars, launchers, utilities, etc.)
4. Copies configuration files only if you agree
5. Creates a log file for reference and debugging

For exact steps and prompts, see the Installation pages.

---

Documentation structure

Use the links below to navigate the Wiki:

• Supported Distributions
  Which distros are supported and how support is handled.
• Installation
  Basic installation overview with links to distro-specific guides.
• Packages
  Explanation of the package system (core, extras, distro-specific).
• Logs, Errors, and Bugs
  Where logs are stored and how to debug common issues.
• Support
  How to get help and what to include when reporting issues.

---

NixOS users

NixOS requires a different setup approach due to its declarative nature.

If you are using NixOS, please read the NixOS Installation Guide before attempting to use this repository.

---

Final note

This Wiki will continue to grow as support for more distributions and workflows is added.

If something is unclear, outdated, or missing:

• Check the relevant Wiki section,
• Then open an issue with logs if needed.