-
Notifications
You must be signed in to change notification settings - Fork 0
Installation Guide ‐ Gentoo
This page describes a manual way to use Hyprland Rice on Gentoo systems.
Gentoo users are expected to manage their own packages, USE flags, and services. This guide focuses on safely reusing configuration files and assets from this repository without triggering unnecessary system rebuilds.
- This project does not provide an automated installer for Gentoo
- No system-wide commands are required
- No assumptions are made about your USE flags or kernel
If Hyprland already works on your system, this guide will not change that.
Before using Hyprland Rice on Gentoo, ensure that:
- Hyprland is already installed and launches correctly
- Wayland works on your system
- Required services (PipeWire, seat management, portals) are already configured
If Hyprland does not launch, fix that first before proceeding.
Hyprland-Rice provides pre-made configuration files that can be reused on Gentoo.
Recommended workflow:
- Clone the repository
- Review files inside
config/hypr - Copy the configuration directory manually
mkdir -p ~/.config cp -r config/hypr ~/.config/
Do not overwrite existing configs unless you know what you are replacing. Backing up manually is recommended.
If you already use compatible tools, you may also copy:
- Waybar configuration (
config/waybar) - Terminal configuration (
config/kitty) - Notification daemon configuration (
config/mako)
Only copy configurations for tools you already have installed.
Wallpapers can be safely reused without affecting your system.
You may:
- Copy wallpapers from
assets/wallpapers - Reference them in your Hyprland configuration
- Manage them however your setup prefers
- No package installation commands
- No USE flag recommendations
- No kernel or driver assumptions
- No system-wide configuration changes
This is intentional to avoid unnecessary rebuilds or conflicts.
If something does not work after applying configs:
- Start Hyprland from a TTY and read error output
- Comment out sections in
hyprland.confgradually - Verify paths inside the configuration match your system
Gentoo users are encouraged to adapt configs incrementally.