From 770ff2c79b0c84bb3d26bc4c93604c22f1f06c15 Mon Sep 17 00:00:00 2001 From: Antonino Scordino Date: Wed, 19 Oct 2022 16:44:04 +0200 Subject: [PATCH] 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' --- pages/Contributing and Debugging/_index.md | 15 ++++- pages/FAQ/_index.md | 70 +++++++--------------- pages/Useful Utilities/Status-Bars.md | 8 +++ 3 files changed, 43 insertions(+), 50 deletions(-) diff --git a/pages/Contributing and Debugging/_index.md b/pages/Contributing and Debugging/_index.md index 00bb57a..c36c7b9 100644 --- a/pages/Contributing and Debugging/_index.md +++ b/pages/Contributing and Debugging/_index.md @@ -61,7 +61,7 @@ as a driver and using it for a while might give more insight to the more random bugs. 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 @@ -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) + +### 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 END 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 (Ctrl+C) type +`coredumpctl info PID` where `PID` is the remembered PID. Send the entire thing +as a file. + ## Nesting Hyprland Hyprland can run nested in a window. For that, make sure you did the following: diff --git a/pages/FAQ/_index.md b/pages/FAQ/_index.md index 9793f22..dd17452 100644 --- a/pages/FAQ/_index.md +++ b/pages/FAQ/_index.md @@ -53,13 +53,13 @@ You might try a USB-C to hdmi adapter though, maybe that could route the externa ### 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 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 [Grimblast](https://github.com/hyprwm/contrib). For recording videos, wf-recorder could be used. @@ -72,10 +72,6 @@ Check [Screensharing](../Useful-Utilities/Screen-Sharing). 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 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 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 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? - -_These instructions are ONLY for systemd. If you use anything else, you should -know what you're doing._ - -Launch `coredumpctl` in a terminal. Press END 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 (Ctrl+C) type -`coredumpctl info PID` where `PID` is the remembered PID. Send the entire thing -as a file. - ### How do I update? 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 will need to cleanbuild to update the package. Paru 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? 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 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 [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). -### Waybar doesn't show the active workspace - -Use the style for `#workspaces button.active` - ### How do I autostart my favorite apps? 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: -```sh +```bash sleep 10 hyprctl keyword windowrule "workspace unset,kitty" hyprctl keyword windowrule "workspace unset,Subl" @@ -211,7 +188,7 @@ exec-once=handle_monitor_connect.sh where `handle_monitor_connect.sh` is: (example) -```sh +```bash #!/bin/sh function handle { @@ -255,7 +232,7 @@ 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 @@ -267,17 +244,12 @@ sleep 4 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? 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 ``` @@ -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 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` diff --git a/pages/Useful Utilities/Status-Bars.md b/pages/Useful Utilities/Status-Bars.md index bb4d87c..99ef39c 100644 --- a/pages/Useful Utilities/Status-Bars.md +++ b/pages/Useful Utilities/Status-Bars.md @@ -33,6 +33,14 @@ If you want to use the workspaces module, it's called `wlr/workspaces`. For more info regarding configuration, see [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 In order to use [Eww](https://github.com/elkowar/eww), you first have to install