Hyprland

hyprland is Article description::an open-source written in C++.

Installation
Hyprland is not an official package on Gentoo (yet). The package is available in the GURU.

Configuration
To view all available configuration options:

Also the hyprland wiki is an excellent documentation.

Files
Each user running hyprland can edit the default configuration file in order to run a customized session. The path of the file should be the default location

Terminal emulator
The Gentoo Wiki lists terminal emulators that support Wayland on the Wayland Desktop Landscape page. Popular choices include or, which works natively with Wayland if the   environment variable is set to.

Waybar
can be used as a highly customizable status bar. It requires some extra configuration and patches for hyprland.

Use flags
Compile waybar with to make the wlr/workspaces widget work.

Switching workspaces by clicking
Put this is patch into It makes waybars workspaces switcher use.

--- a/src/modules/wlr/workspace_manager.cpp +++ b/src/modules/wlr/workspace_manager.cpp @@ -511,7 +511,8 @@ auto Workspace::handle_clicked(GdkEventButton *bt) -> bool { if (action.empty) return true; else if (action == "activate") { -   zext_workspace_handle_v1_activate(workspace_handle_); +   const std::string command = "hyprctl dispatch workspace " + name_; +	system(command.c_str); } else if (action == "close") { zext_workspace_handle_v1_remove(workspace_handle_); } else {

Persistent workspaces
A patch for persistent workspaces was recently merged in Waybars Github repository, but it is not available yet in the current versioned package on Gentoo. Emerge waybar as live ebuild (9999) to get this feature.

Other status bars
See Wayland Desktop Landscape.

= xdg-desktop-portal-hyprland = xdg-desktop-portals are helper programs for desktop environments. The work by managing D-BUS interfaces and exposing them as 'portals'. On Wayland they are often needed because, unlike X, Wayland does not allow windows to easily talk to each other. If some programs start up very slowly in hyprland on if screensharin does not work, a problem with the xdg-desktop-portal is likely the reason. Hyprland does work with the, but screensharing will not work with this. Hyprland upstream forked xdg-desktop-portal-wlr into gui-libs/xdg-desktop-portal-hyprland (available in the GURU),

xdg-desktop-portal-hyprland needs to be started ofter Hyprland starts. This is done the easiert using hyprlands exec-once function. It is also a good idea to tell D-BUS, that the current desktop is Hyprland To do so, this should be put in the Hyprland config: env = XDG_CURRENT_DESKTOP=Hyprland env = XDG_SESSION_TYPE=wayland env = XDG_SESSION_DESKTOP=Hyprland exec-once = wl-clipboard-history -t exec-once = dbus-update-activation-environment --systemd WAYLAND_DISPLAY XDG_CURRENT_DESKTOP

OpenRC users should not worry to much about the  flag here. The command will update the systemd --user environmen if possible, so it will simply not do that on OpenRC.

Also a script should be executed at start. This script will start the xdg-desktop-portal-hyprland. exec-once = ~/.config/hypr/xdg-portal-hyprland

The script can reside anywhere, here it is in ~/.config//hypr/xdg-portal-hyprland The contents are as follows sleep 1 killall xdg-desktop-portal-hyprland killall xdg-desktop-portal-gnome killall xdg-desktop-portal-wlr killall xdg-desktop-portal /usr/libexec/xdg-desktop-portal-hyprland & sleep 2 /usr/lib/xdg-desktop-portal &
 * 1) !/bin/bash

This will ensure that no other desktop portal is running while using Hyprland, which can cause problems.

xdg-desktop-portal-gnome
Even though the other portals processes get killed in the script from the earlier point, xdg-desktop-portal-gnome causes problems with Hyprland. Hyprland warns about that at startup when it detects xdg-desktop-portal-gnome on the system. When using Hyprland, xdg-desktop-portal-gnome should be uninstalled from the system:

Gnome will still work, but it could have some lacking functionality (like besaid screensharing).

Because depends on the portal,  will be pulled in with every portage world set update. Portages /etc/portage/profile/package.provided package.provided feature could be used to prevent pulling in xdg-desktop-portal-gnome.