Faq
This just means they are running through XWayland, which physically cannot scale by fractional amounts.
To force them to run in wayland-native mode, see the Master Tutorial.
If they can’t, see the XWayland page.
Possible causes:
Your themes are not set up properly, making apps crash.
Use something like qt6ct (Qt) and nwg-look (GTK) (*for GTK you can also
set up themes with envvars) to set up your themes.
Your PC is very, very old.
In that case, see the Installation Page and try compiling with LEGACY_RENDERER
For more info about bugs and crashes, see this wiki page
Are you on NVIDIA? If so, then you have been a naughty boy and haven’t listened
to my tips on other pages. Use the WLR_NO_HARDWARE_CURSORS=1 environment
variable.
For Nvidia graphics - This issue appears to be resolved when using Nvidia Drivers 525.60.11 or later, but it may persist with older drivers.
Outside those, there is a way to fix it that might work for you though:
Option 1: Use only the external monitor
By using WLR_DRM_DEVICES=/dev/dri/card1 (or card0) you can force Hyprland to use only your dGPU,
meaning your laptop’s screen will be gone but your external one will work.
Option 2: Use all outputs, at the cost of battery life.
By switching your laptop to only use the dGPU in the BIOS, you might be able to get everything to work, at the cost of high battery usage.
Please note these are highly model-specific and might or might not work. If they don’t, you’re unfortunately out of luck.
You might try a USB-C to HDMI adapter though, maybe that could route the external monitor through the iGPU.
Install grim and slurp
Use a keybind (or execute) grim -g "$(slurp)", select a region. A screenshot
will pop into your ~/Pictures/ (You can configure grim and slurp, see their
GitHub pages).
If you want those screenshots to go directly to your clipboard, consider using wl-copy, from wl-clipboard. Here’s an example binding:
bind = , Print, exec, grim -g "$(slurp -d)" - | wl-copy
For a more complete utility, try our own screenshotting utility:
Grimblast.
For recording videos, wf-recorder, wl-screenrec or OBS Studio could be used.
Check Screensharing.
Also install qt6-wayland if you plan to use obs.
See Wallpapers.
Not that much heavier than Xorg. If you want maximum performance, consider turning off the blur and animations.
Try changing the mode in your config. If your preferred one doesn’t work, try a
lower one. A good way to list all modes is to get wlr-randr and do a
wlr-randr --dryrun
Change the VRR option to 2 (fullscreen), so that it is only used in games.
This happens because the brightness on some monitors can depends on the refresh
rate, and rapidly changing refresh rates (for example, when the screen momentarily
updates after pressing a key) will cause rapid changes in brightness.
Open a terminal where you cloned the repo.
git pull
make all && sudo make install
If you are using the AUR (hyprland-git) package, you will need to cleanbuild to update the package. Paru has been problematic with updating before, use Yay.
Use a wayland-compatible locking utility using WLR protocols, e.g. swaylock.
See hyprcursor
https://github.com/swaywm/sway/wiki/GTK-3-settings-on-Wayland
Make sure you have a notification daemon running, for example dunst. Autostart
it with the exec-once keyword.
Waybar has a set of caveats or settings that you need to be aware of. See Status bars for solutions.
Using the window rules to assign apps to workspace you can open a bunch of applications on various workspaces. The following method will start these apps silently (i.e. without the flickering from workspace to workspace).
Put the following in your hyprland.conf: (example)
exec-once=[workspace 1 silent] kitty
exec-once=[workspace 1 silent] subl
exec-once=[workspace 3 silent] mailspring
exec-once=[workspace 4 silent] firefox
if you want workspaces to automatically go to a monitor upon connection, use the following:
In hyprland.conf:
exec-once=handle_monitor_connect.sh
where handle_monitor_connect.sh is: (example)
#!/bin/sh
handle() {
case $1 in monitoradded*)
hyprctl dispatch moveworkspacetomonitor "1 1"
hyprctl dispatch moveworkspacetomonitor "2 1"
hyprctl dispatch moveworkspacetomonitor "4 1"
hyprctl dispatch moveworkspacetomonitor "5 1"
esac
}
socat - "UNIX-CONNECT:/tmp/hypr/${HYPRLAND_INSTANCE_SIGNATURE}/.socket2.sock" | while read -r line; do handle "$line"; done
if you want workspaces 1 2 4 5 to go to monitor 1 when connecting it.
Please note this requires socat to be installed.
Use Open Tablet Driver to configure your tablet. In the future it will be supported in the config. Until then, OTD is the way to go.
~/.config/hypr/hyprland.conf
exec-once=dbus-update-activation-environment --systemd WAYLAND_DISPLAY XDG_CURRENT_DESKTOP
Make sure that your portals launch after this gets executed. For some people, they might launch before that has happened.
In such cases, a script like this:
#!/usr/bin/env bash
sleep 4
killall -e xdg-desktop-portal-wlr
killall xdg-desktop-portal
/usr/lib/xdg-desktop-portal-wlr &
sleep 4
/usr/lib/xdg-desktop-portal &
launched with exec-once should fix all issues. Adjust the sleep durations to taste.
The env keyword is used for this purpose. For example:
env = XDG_CURRENT_DESKTOP,Hyprland
You can simply intercept the middle-click action all together, via hyprland binds for example. The drawbacks to this solution are that 1. it disables the rest of the functionality of the middle-click action, such as auto scroll, closing browser tabs, etc., and 2. many applications (such as kitty) manually intercept the middle-click events and bind them to paste from the primary buffer themselves, bypassing the solution altogether. For this solution, add this bind to your config:
bind = , mouse:274, exec, ;. Note that the exact bindcode may vary, so you may want to check it with wev first.
Alternative method using wl-paste (warning: major power consumption)
The middle-click paste action pastes from a separate buffer (primary buffer) than what the regular clipboard uses (clipboard buffer). Since the primary buffer is unrelated to the clipboard buffer, it’s easy to simply keep the primary buffer empty, allowing the middle-click action to retain the rest of its functionality without having anything to paste. Run the following command (in your config with exec-once, for example) to achieve this:
wl-paste -p --watch wl-copy -p '' (wl-paste -p --watch watches for changes to the primary buffer, wl-copy -p '' clears the primary buffer)
As you can see, however, this creates an endless loop (found copied text -> copy -> found copied text…). Therefore this method is not recommended.
Useful Optimizations:
decoration:blur = falseanddecoration:drop_shadow = falseto disable fancy but battery hungry effects.misc:vfr = true, since it’ll lower the amount of sent frames when nothing is happening on-screen.
Read this trick.
See The XDPH Page.
You most likely have multiple portal impls / an impl is failing to launch.
Some programs like flameshot (currently) has limited wayland support so on most Wayland compositors, you will have to do few tweaks. For Hyprland, you can add these window rules to your config to make said programs work with both of your screens.
windowrulev2=move 0 0,title:^(flameshot)
windowrulev2=nofullscreenrequest,title:^(flameshot)
Many laptops have a built-in function to toggle SUPER between single key press mode and hold mode. This is usually indicated by a padlock on the SUPER key.
First, install and run wev, then press SUPER. If you see a key press event followed by an instant key release event, then it’s likely your SUPER key is set to single press mode.
On most laptops this can be fixed by pressing FN+SUPER and verified in wev. You should be able to hold SUPER and not see an instant release event. In case FN+SUPER doesn’t work, consult your laptop’s manual.
This is expected, as Hyprland takes precedence.
A simple fix is to create an empty “passthrough” submap:
bind = MOD,KEY,submap,passthru
submap = passthru
bind = SUPER,Escape,submap,reset
submap = reset
set MOD and KEY to desired values.
By pressing the selected combo you will enter a mode where hyprland ignores your keybinds and passes them on to the vm.
Then, pressing SUPER + Escape will leave that mode.
In some apps like Steam or VSCode, the drop-down windows may disappear if you hover over them. This can be fixed with window rules.
First, find the title and class of the pop-up window with hyprctl clients. You can try something like sleep 3 && hyprctl clients so you have time to open the pop-up. It should look something like this:
Window 55d794495400 -> :
...
class: [CLASS here]
title: [TITLE here]
...
If the pop-up disappears as you hover over it, you can add to your config:
windowrulev2 = stayfocused, title:^(TITLE)$, class:^(CLASS)$
This has a downside of not being able to click on anything in the main UI until you’ve interacted with the pop-up.
If the pop-up disappears immediately, you can use:
windowrulev2 = minsize 1 1, title:^(TITLE)$, class:^(CLASS)$
On instances where you have a steam library on another drive that you have to add, Hyprland’s file picker would not normally appear when selecting a directory from steam.
Steam has its own file picker, however, it’s not functional. Install
xdg-desktop-portal-gtk to show the desktop’s file picker.