I installed Hyprland on June 21st, 2025 for the first time. Here is my first rice.

This rice isn't as sophisticated as the ones you'd likely see on Reddit.

I don't really have the will to through install 200 apps and plugins (which doesn't mean this rice doesn't have any of them).

I don't want the bland out-of-the-box experience, neither something too complicated.

So I made this rice starting from the default configs, and adding and changing just what i needed.

This config is used on my Arch setup since June 2025. In case you use a different distribution, you can send a pull request to add it to the list below.

Packages expected to be installed for the rice to work properly:

• hyprland:
• waybar: the top bar
• wofi: the search app
• hyprpaper: wallpaper and random sentence at the bottom
• hyprlock: the lockscreen

Hyprland's config expects you to have:

• kitty as the $terminal app
• thunar as the $fileManager app
• wofi as the $dmenu app
• hyprshot as the app for screenshots for the following key combos: (yes, these two are inside the bind stuff >:)
  • Win+S
  • Win+Shift+S

If you're here, you should know how to change these settings c:

I put it in the assets folder, or you can get it from Unsplash.

Download it and keep it somewhere safe. Make sure to remember the path

Install the AdwaitaMono Nerd Font (search if your distro's package manager provides it, or Download it manually and Install it system-wide (I don't know if it works if you install it per-user, but you can send a pull request/issue if it works :))

The font is required for hyprlock, waybar, wofi and kitty. You can change it in their respective config (or style.css) files.

Download the repository (i don't have releases yet) as a ZIP file and extract it.

Before copying the files to your home directory, there are a few parameters to set up. You can copy them to a temprary place to avoid messing up the repository files (in case of future updates)

In hyprland.conf, if you choose to use hyprshot for screenshots, you can set the HYPRSHOT_DIR environment variable to the path where you'd save your screenshots, or you can simply delete the line if you want to save them to your Pictures folder.

env = HYPRSHOT_DIR,/path/for/Hyprshots

(yes, i call the screenshots "hyprshots" if you mind)

In the input section, make sure to choose your preferred layout(s). If using more than one layout, you can change the shortcut for switching between layouts. The default one is Win+Space.

input {
    kb_layout = layout      <-- replace this
    kb_variant =
    kb_model =
    kb_options = grp:win_space_toggle
    kb_rules =
...
}

You must set the path to the previously downloaded wallpaper twice:

preload = /path/to/desert_bg.jpeg   <-- change this

#set the default wallpaper(s) seen on initial workspace(s) --depending on the number of monitors used
wallpaper = monitor-here, /path/to/desert_bg.jpeg   <-- change this

You can now copy all the folders in the dotconfig directory to $HOME/.config.

You can reboot now (as i didn't set up a proper End Session command/macro/something yet :|).

Here are a few customized keyboard shortcuts:

(SUPER/Win is the mod key btw)

mod + Return: Open terminal (kitty)

mod + Shift + Q: Kill process

mod + Shift + R: Reload Waybar

mod + L: Run hyprlock

(Hyprshot) mod + S: Screenshot a region

(Hyprshot) mod + Shift + S: Screenshot a window

In case of any problem you can report it via Github Issues. Make sure to specify basic info like the OS you're using, a somehow detailed description of the behaviour (not the "[Component] doesn't work"), steps to reproduce such behaviour and, if any, add a log of the fault as it can help a lot.

Thanks for trying this rice :D

-- by Omar (RepubblicaTech)