hyprwm/hyprland-wiki
1
0
Fork 0
mirror of https://github.com/hyprwm/hyprland-wiki.git synced 2024-12-22 17:49:48 +01:00
Code Issues Projects Releases Packages Wiki Activity

Update FAQ

Browse source 
Co-authored-by: NotAShelf <itsashelf@gmail.com>
Co-authored-by: Antonino Scordino <a.scordino.07@gmail.com>
Co-authored-by: vaxerski <43317083+vaxerski@users.noreply.github.com>
This commit is contained in:
Mihai Fufezan 2022-10-23 17:37:31 +03:00
parent e33199fe54
commit 35c5576242
No known key found for this signature in database
GPG key ID: 5899325F2F120900
1 changed files with 75 additions and 90 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

165
pages/FAQ/_index.md
View file

@ -1,7 +1,8 @@
　
# Table of Contents
{{< toc format=html >}}
### Nothing renders / screen is empty / crash on opening first app
# Nothing renders / screen is empty / crash on opening first app
Possible causes:
@ -10,121 +11,109 @@ Possible causes:
Use something like `qt5ct` (QT) and `lxappearance` (GTK) (\*for GTK you can also
set up themes with envvars) to set up your themes.
> Your PC is very, very old.
> Your PC is very, _very_ old.
In that case, see the
[Installation Page](../../Getting-Started/Installation) and
try compiling with LEGACY_RENDERER
*For more info about bugs and crashes, see this*
*[wiki page](../../Crashes-and-Bugs)*
_For more info about bugs and crashes, see this_
_[wiki page](../../Crashes-and-Bugs)_
### Me cursor no render?
# Me cursor no render?
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.
### My external monitor is blank / doesn't render / receives no signal (laptop)
# My external monitor is blank / doesn't render / receives no signal (laptop)
For Radeon graphics - unfortunately, it's a bug in wlroots, and I can't
do much about it other than wait for the wlroots devs to fix it:
For Radeon graphics - unfortunately, it's a bug in wlroots, and not much
can be done other than waiting for the wlroots devs to fix it:
[https://gitlab.freedesktop.org/wlroots/wlroots/-/issues/3451](https://gitlab.freedesktop.org/wlroots/wlroots/-/issues/3451)
For Nvidia graphics - unfortunately, it's a wlroots issue as well, most likely due to Nvidia's
lack of support and proprietary drivers.
There is a way to fix it that *might* work for you though:
There is a way to fix it that _might_ work for you though:
**Option 1:** Use *only* the external monitor
**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,
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.*
_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.
### How do I screenshot?
# How do I screenshot?
Install `grim-git` and `slurp`
Install `grim` and `slurp`
Use a keybind (or execute) `grim -g $(slurp)`, select a region. A screenshot
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).
For a more complete utility, try our own
For a more complete utility, try our own screenshotting utility:
[Grimblast](https://github.com/hyprwm/contrib).
### Screenshare / OBS no worky!
For recording videos, wf-recorder or OBS Studio could be used.
# Screenshare / OBS no worky
Check [Screensharing](../Useful-Utilities/Screen-Sharing).
### How do I change my wallpaper?
# How do I change my wallpaper?
See [Wallpapers](../Useful-Utilities/Wallpapers).
### My workspace (2, 3, or any other) is like... bugged?
You did the below, unknowingly.
### My games work poorly, especially proton ones!
# My games work poorly, especially proton ones
Use `gamescope`, tends to fix any and all issues with wayland/Hyprland.
### How heavy is this?
# How heavy is this?
Not that much heavier than Xorg. If you want maximum performance, consider
turning off the blur and animations.
### Blur makes my GPU cry :(
You probably forgot to turn on `decoration:blur_new_optimizations`. Thank me
later.
### My monitor no worky!
# My monitor no worky
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`
### How do I get a coredump?
# How do I update?
*These instructions are ONLY for systemd. If you use anything else, you should
know what you're doing.*
Open a terminal where you cloned the repo.
```bash
git pull
sudo make clear
sudo make cleaninstall
```
Launch `coredumpctl` in a terminal. Press <key>END</key> on the keyboard to go
to the end. Note the **last** (the one furthest to the bottom) crash that has
`/usr/bin/Hyprland` as an executable. Remember the PID of it (the first number
after the date in a given line) exit (<key>Ctrl</key>+<key>C</key>) type
`coredumpctl info PID` where `PID` is the remembered PID. Send the entire thing
as a file.
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.
### How do I update?
open a terminal where you cloned the repo.
`git pull && sudo make clear && sudo make install`
### Waybar popups render behind the windows??
You have misconfigured Waybar. Make sure the `layer` in the waybar config is set to `top`, and not `bottom`.
### How do I screen lock?
# How do I screen lock?
Use a wayland-compatible locking utility using WLR protocols, e.g. `swaylock`.
### How do I change me mouse cursor?
# How do I change me mouse cursor?
Use a tool like for example `lxappearance` to change the GTK cursor.
After that, add `exec-once=hyprctl setcursor [THEME] [SIZE]` to your config and
restart Hyprland.
For QT applications, Hyprland exports XCURSOR_SIZE as 24, which is the default.
You can overwrite this by exporting XCURSOR_SIZE to a different value in your wrapper.
Alternatively, change the config files manually according to the
[XDG specification (Arch Wiki link)](https://wiki.archlinux.org/title/Cursor_themes#Configuration).
@ -136,24 +125,21 @@ all good!
If it still doesn't work...
### GTK Settings no work / whatever!
# GTK Settings no work / whatever
[https://github.com/swaywm/sway/wiki/GTK-3-settings-on-Wayland](https://github.com/swaywm/sway/wiki/GTK-3-settings-on-Wayland)
### My \[program name\] is freezing!
# My \[program name\] is freezing
Make sure you have a notification daemon running, for example `dunst`. Autostart
it with the `exec-once` keyword.
### I want to use Waybar, but the workspaces don't work!
# Waybar workspaces no worky???
Check [Status bars](../Useful-Utilities/Status-Bars).
Waybar has a set of caveats or settings that you need to be aware of. See
[Status bars](../Useful-Utilities/Status-Bars) for solutions.
### Waybar doesn't show the active workspace!
Use the style for `#workspaces button.active`
### How do I autostart my favorite apps?
# How do I autostart my favorite apps?
Using the window rules to assign apps to workspace you can setup a session start
script to open a bunch of applications on various workspaces. The following
@ -181,7 +167,7 @@ exec-once=cleanup_after_start.sh
where `cleanup_after_start.sh` script contains:
```sh
```bash
sleep 10
hyprctl keyword windowrule "workspace unset,kitty"
hyprctl keyword windowrule "workspace unset,Subl"
@ -191,7 +177,7 @@ hyprctl keyword windowrule "workspace unset,firefox"
in `sleep 10`, the 10 seconds is of course only a suggestion.
### How do I move my favorite workspaces to a new monitor when I plug it in?
# How do I move my favorite workspaces to a new monitor when I plug it in?
if you want workspaces to automatically go to a monitor upon connection, use the
following:
@ -204,7 +190,7 @@ exec-once=handle_monitor_connect.sh
where `handle_monitor_connect.sh` is: (example)
```sh
```bash
#!/bin/sh
function handle {
@ -223,29 +209,32 @@ if you want workspaces 1 2 4 5 to go to monitor 1 when connecting it.
Please note this requires `socat` to be installed.
### My tablet no worky??
# My tablet no worky??
Use [Open Tablet Driver](https://github.com/OpenTabletDriver/OpenTabletDriver)
to configure your tablet. In the future it will be supported in the config.
Until then, OTD.
Until then, OTD is the way to go.
### Some of my apps take a really long time to open...?
# Some of my apps take a really long time to open...?
*~/.config/hypr/hyprland.conf*
_~/.config/hypr/hyprland.conf_
```ini
exec-once=dbus-update-activation-environment --systemd WAYLAND_DISPLAY XDG_CURRENT_DESKTOP
```
and
```ini
exec-once=systemctl --user import-environment WAYLAND_DISPLAY XDG_CURRENT_DESKTOP
```
Make sure that your portals launch *after* this gets executed. For some people,
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:
```sh
```bash
#!/bin/bash
sleep 4
killall xdg-desktop-portal-wlr
@ -254,19 +243,15 @@ killall xdg-desktop-portal
sleep 4
/usr/lib/xdg-desktop-portal &
```
launched with `exec-once` should fix all issues. Adjust the sleep durations to taste.
### My cursor in QT apps is too big!
The QT cursor size can be fixed by setting the envvar `XCURSOR_SIZE=24`. You
should probably add it to your exported envvars.
### How do I export envvars for Hyprland?
# How do I export envvars for Hyprland?
As with any Display Server, Xorg included, you should probably make a script to
launch it, for example:
```ini
```bash
export AMONG_US=1
exec Hyprland
```
@ -274,31 +259,31 @@ exec Hyprland
and launch that.
For Display Manager users, you can replace the `exec` entry in
the `.desktop` file to point to your script.
the `.desktop` file to point to your script. You are recommended
to use absolute paths, such as `/home/username/Script` instead of `~/Script`
### I get random white flashes!
# I get random white flashes
Try disabling VFR with `misc:no_vfr=1`.
### How do I make Hyprland draw as little power as possible on my laptop?
# How do I make Hyprland draw as little power as possible on my laptop?
I assume you already have `damage_tracking` on full. If you don't, do it. It's
I assume you already have `damage_tracking` on full. If you don't, change it. It's
heavily advised to use `full` regardless of anything.
Optimization options:
**_Useful Optimizations_**:
*feel free to ignore any that you find causing issues*
* `decoration:blur_new_optimizations = true`, to use new optimizations for
blurring.
`decoration:blur_new_optimizations = true`
* `decoration:blur = false` and `decoration:drop_shadow = false` to disable
fancy but battery hungry effects.
`decoration:blur = false`
* `misc:no_vfr = false`, since it'll lower the refresh rate when nothing is happening on-screen.
`decoration:drop_shadow = false`
* `misc:disable_autoreload = true` to stop Hyprland from reloading configuration
file each time that it changes.
`misc:no_vfr = false`
*possibly* `misc:disable_autoreload = true`
### How to fix games with window dancing?
# How to fix games with window dancing?
Read [this trick](../Configuring/Uncommon-tips--tricks/#window-dancing).