Hyprland: Difference between revisions
Prabuanand (talk | contribs) (added wikitags) |
|||
| Line 23: | Line 23: | ||
{{Cmd|# apk add hyprland-wallpapers}} | {{Cmd|# apk add hyprland-wallpapers}} | ||
Or you can just have some file at {{Path|/usr/share/hypr/wall0.png}} or {{Path|/usr/local/share/hypr/wall0.png}} and modify | Or you can just have some file at {{Path|/usr/share/hypr/wall0.png}} or {{Path|/usr/local/share/hypr/wall0.png}} and modify your config file to have a line as follows: {{Cat|~/.config/hypr/hyprland.conf|<nowiki>misc { | ||
{{Cat|~/.config/hypr/hyprland.conf|< | |||
force_default_wallpaper = 0 | force_default_wallpaper = 0 | ||
}</ | }</nowiki>}} | ||
=== Hyprland crashes almost immediately === | === Hyprland crashes almost immediately === | ||
| Line 33: | Line 31: | ||
Hyprland 0.46 has a bug where the default configuration will crash if Xwayland is not installed. You can either install {{pkg|xwayland}}, or disable in your config: | Hyprland 0.46 has a bug where the default configuration will crash if Xwayland is not installed. You can either install {{pkg|xwayland}}, or disable in your config: | ||
{{Cat|~/.config/hypr/hyprland.conf|< | {{Cat|~/.config/hypr/hyprland.conf|<nowiki>xwayland:enabled = false</nowiki>}} | ||
This should be fixed in the next update. | This should be fixed in the next update. | ||
| Line 45: | Line 43: | ||
You can disable the check in your config like so: | You can disable the check in your config like so: | ||
{{Cat|~/.config/hypr/hyprland.conf|< | {{Cat|~/.config/hypr/hyprland.conf|<nowiki>misc:disable_hyprland_qtutils_check = true</nowiki>}} | ||
=== consistent icon theme === | === consistent icon theme === | ||
| Line 51: | Line 49: | ||
Depending on what applications you are running, you only need the HYPRCURSOR_THEME environment, it should work for all modern applications. But since you are reading this, you probably found an incompatible application. You have the option to disable hyprcursors, then you need only one theme. Otherwise you need to download a theme that is available as hyprcursors and xcursors (e.g. rose-pine-hyprcursor). | Depending on what applications you are running, you only need the HYPRCURSOR_THEME environment, it should work for all modern applications. But since you are reading this, you probably found an incompatible application. You have the option to disable hyprcursors, then you need only one theme. Otherwise you need to download a theme that is available as hyprcursors and xcursors (e.g. rose-pine-hyprcursor). | ||
{{Cat|~/.config/hypr/hyprland.conf| | {{Cat|~/.config/hypr/hyprland.conf|<nowiki># Set the theme for most applications | ||
< | |||
# Set the theme for most applications | |||
env = HYPRCURSOR_THEME,$your_hyprcursor_theme | env = HYPRCURSOR_THEME,$your_hyprcursor_theme | ||
env = HYPRCURSOR_SIZE,24 | env = HYPRCURSOR_SIZE,24 | ||
| Line 61: | Line 57: | ||
# Set the theme for some GTK applications | # Set the theme for some GTK applications | ||
exec-once = gsettings set org.gnome.desktop.interface cursor-theme $your_xcursor_theme | exec-once = gsettings set org.gnome.desktop.interface cursor-theme $your_xcursor_theme | ||
exec-once = gsettings set org.gnome.desktop.interface cursor-size 24 | exec-once = gsettings set org.gnome.desktop.interface cursor-size 24</nowiki>}} | ||
</ | |||
If you use gsettings make sure you have installed | If you use gsettings make sure you have installed {{pkg|gsettings-desktop-schemas}} package. | ||
== See Also == | == See Also == | ||
Revision as of 14:51, 9 April 2025
This wiki page is about Hyprland, a wayland based tiling compositor with all the eyecandy, powerful plugins and much more.
Refer to hyprland Tutorial to get started on using Hyprland.
Prerequisites
- Internet connectivity, unless the packages have been pre-fetched into a local cache.
- Install appropriate Graphics driver drivers for your hardware. Without graphics drivers, errors are likely to occur when starting your desktop.
- A non-root user account.
- The community repository must be enabled.
- Set up eudev.
- Install and enable D-Bus. Without D-Bus, icons and keyboard shortcuts may be missing.
- Install wayland-base.This enables elogind as seat manager, enables community repository and enables eudev.
Installation
Install the package hyprland using the command:
# apk add hyprland
Troubleshooting
Black/Magenta checkerboard background: Hyprland failed to load 1 essential asset
As of Hyprland 0.45.0, upstream shows a scary message (and an ugly graphic) if you don't have their wallpapers installed.
The ugly graphic goes away when you've launched a wallpaper utility, but the scary message remains.
The canonical way to solve this is to install hyprland-wallpapers package using the command:
# apk add hyprland-wallpapers
Or you can just have some file at /usr/share/hypr/wall0.png or /usr/local/share/hypr/wall0.png and modify your config file to have a line as follows:
Contents of ~/.config/hypr/hyprland.conf
Hyprland crashes almost immediately
Hyprland 0.46 has a bug where the default configuration will crash if Xwayland is not installed. You can either install xwayland, or disable in your config:
Contents of ~/.config/hypr/hyprland.conf
This should be fixed in the next update.
warning message about hyprland-qtutils
Hyprland 0.46 and newer suggest you install hyprland-qtutils, which is currently not available in alpine.
Your system does not have hyprland-qtutils installed. This is a runtime dependency for some dialogs. Consider installing it.
You can disable the check in your config like so:
Contents of ~/.config/hypr/hyprland.conf
consistent icon theme
Depending on what applications you are running, you only need the HYPRCURSOR_THEME environment, it should work for all modern applications. But since you are reading this, you probably found an incompatible application. You have the option to disable hyprcursors, then you need only one theme. Otherwise you need to download a theme that is available as hyprcursors and xcursors (e.g. rose-pine-hyprcursor).
Contents of ~/.config/hypr/hyprland.conf
If you use gsettings make sure you have installed gsettings-desktop-schemas package.