FAQ: Re-order and clarify some headings

* Move some Waybar configuration problems to 'Useful Utilities/Status-Bars.md'
* Move 'coredumpctl' usage over to 'Contributing and Debugging/_index.md'
* Explain the "optimization options"
* Replace some code block's language from 'ini' to 'bash', and 'sh' with 'bash'
This commit is contained in:
Antonino Scordino 2022-10-19 16:44:04 +02:00
parent df7c16f2bd
commit 770ff2c79b
No known key found for this signature in database
GPG key ID: F20FDE4C896FC2CB
3 changed files with 43 additions and 50 deletions

View file

@ -61,7 +61,7 @@ as a driver and using it for a while might give more insight to the more random
bugs. bugs.
When Hyprland crashes, use `coredumpctl` and then `coredumpctl info PID` to see When Hyprland crashes, use `coredumpctl` and then `coredumpctl info PID` to see
the dump. the dump. See the instructions below this paragraph for more info about `coredumpctl`.
I also recommend the amazing command I also recommend the amazing command
@ -71,6 +71,19 @@ watch -n 0.1 "cat /tmp/hypr/$(echo HYPRLAND_INSTANCE_SIGNATURE)/hyprland.log | g
for live logs. (replace `hyprland` with `hyprlandd` for debug builds) for live logs. (replace `hyprland` with `hyprlandd` for debug builds)
### How do I get a coredump?
_These instructions are ONLY for systemd. If you use anything else, you should
know what you're doing._
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.
## Nesting Hyprland ## Nesting Hyprland
Hyprland can run nested in a window. For that, make sure you did the following: Hyprland can run nested in a window. For that, make sure you did the following:

View file

@ -53,7 +53,7 @@ You might try a USB-C to hdmi adapter though, maybe that could route the externa
### 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 will pop into your `~/Pictures/` (You can configure grim and slurp, see their
@ -72,10 +72,6 @@ Check [Screensharing](../Useful-Utilities/Screen-Sharing).
See [Wallpapers](../Useful-Utilities/Wallpapers). 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. Use `gamescope`, tends to fix any and all issues with wayland/Hyprland.
@ -85,42 +81,25 @@ Use `gamescope`, tends to fix any and all issues with wayland/Hyprland.
Not that much heavier than Xorg. If you want maximum performance, consider Not that much heavier than Xorg. If you want maximum performance, consider
turning off the blur and animations. 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 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 lower one. A good way to list all modes is to get `wlr-randr` and do a
`wlr-randr --dryrun` `wlr-randr --dryrun`
### How do I get a coredump?
_These instructions are ONLY for systemd. If you use anything else, you should
know what you're doing._
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.
### How do I update? ### How do I update?
Open a terminal where you cloned the repo. Open a terminal where you cloned the repo.
`git pull && sudo make clear && sudo make cleaninstall` ```bash
git pull
sudo make clear
sudo make cleaninstall
```
If you are using the AUR (hyprland-git) package, you If you are using the AUR (hyprland-git) package, you
will need to cleanbuild to update the package. Paru will need to cleanbuild to update the package. Paru
has been problematic with updating before, use Yay. has been problematic with updating before, use Yay.
### 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`. Use a wayland-compatible locking utility using WLR protocols, e.g. `swaylock`.
@ -132,6 +111,8 @@ 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 After that, add `exec-once=hyprctl setcursor [THEME] [SIZE]` to your config and
restart Hyprland. restart Hyprland.
If you want to change cursor size on QT, add `XCURSOR_SIZE=[SIZE]` to your wrapper.
Alternatively, change the config files manually according to the Alternatively, change the config files manually according to the
[XDG specification (Arch Wiki link)](https://wiki.archlinux.org/title/Cursor_themes#Configuration). [XDG specification (Arch Wiki link)](https://wiki.archlinux.org/title/Cursor_themes#Configuration).
@ -156,10 +137,6 @@ it with the `exec-once` keyword.
Check [Status bars](../Useful-Utilities/Status-Bars). Check [Status bars](../Useful-Utilities/Status-Bars).
### 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 Using the window rules to assign apps to workspace you can setup a session start
@ -188,7 +165,7 @@ exec-once=cleanup_after_start.sh
where `cleanup_after_start.sh` script contains: where `cleanup_after_start.sh` script contains:
```sh ```bash
sleep 10 sleep 10
hyprctl keyword windowrule "workspace unset,kitty" hyprctl keyword windowrule "workspace unset,kitty"
hyprctl keyword windowrule "workspace unset,Subl" hyprctl keyword windowrule "workspace unset,Subl"
@ -211,7 +188,7 @@ exec-once=handle_monitor_connect.sh
where `handle_monitor_connect.sh` is: (example) where `handle_monitor_connect.sh` is: (example)
```sh ```bash
#!/bin/sh #!/bin/sh
function handle { function handle {
@ -255,7 +232,7 @@ they might launch before that has happened.
In such cases, a script like this: In such cases, a script like this:
```sh ```bash
#!/bin/bash #!/bin/bash
sleep 4 sleep 4
killall xdg-desktop-portal-wlr killall xdg-desktop-portal-wlr
@ -267,17 +244,12 @@ sleep 4
launched with `exec-once` should fix all issues. Adjust the sleep durations to taste. launched with `exec-once` should fix all issues. Adjust the sleep durations to taste.
### My cursor in QT apps is too big
Oh no! Anyway, 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 As with any Display Server, Xorg included, you should probably make a script to
launch it, for example: launch it, for example:
```ini ```bash
export AMONG_US=1 export AMONG_US=1
exec Hyprland exec Hyprland
``` ```
@ -297,16 +269,16 @@ Try disabling VFR with `misc:no_vfr=1`.
I assume you already have `damage_tracking` on full. If you don't, change 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. 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` & `decoration:drop_shadow = false` to disable
fancy but battery hungry effects.
`decoration:blur = false` * `misc:no_vfr = false`, since it has been proven that it consumes less power.
`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`

View file

@ -33,6 +33,14 @@ If you want to use the workspaces module, it's called `wlr/workspaces`.
For more info regarding configuration, see For more info regarding configuration, see
[The Waybar Wiki](https://github.com/Alexays/Waybar/wiki). [The Waybar Wiki](https://github.com/Alexays/Waybar/wiki).
### Waybar popups render behind the windows
In `~/waybar/config`, make sure that you have the `layer` configuration set to `top` and not `bottom`.
### Active workspace doesn't show up
Replace `#workspaces button.focus` with `#wroskapces button.active` in `~/.config/style.css`.
## Eww ## Eww
In order to use [Eww](https://github.com/elkowar/eww), you first have to install In order to use [Eww](https://github.com/elkowar/eww), you first have to install