Skip to content

FAQ

Jump to bottom
Donald Williams edited this page Dec 16, 2024 · 92 revisions

❓ Some FAQ on KooL Hyprland-Dots

Tip

Before changing any files or configuration, it is advisable to create a back-up. So you can easily revert back to original settings if things goes sideways.

  • i.e. cp fileName.conf fileName.bak

🙋 How to uninstall this

  • As stated on each readme on Distro-hyprland install scripts

Important

install a backup tool like snapper or timeshift. and Backup your system before installing hyprland using this script. This script does NOT include an uninstall of Hyprland packages

Note

Main reason why I have not included an uninstall script is simple. Some packages maybe already installed on your system by default. If I create an uninstall script with packages that I have set to install, you may end up a unrecoverable system.

⁉️ After installing on Gnome or Plasma, after reboot, it starts Gnome, or Plasma not Hyprland.

  • Disable auto-login and logout
  • Choose Hyprland (NOT Hyprland-systemd) with either GDM or SDDM as shown below. If you don't have Hyprland in the option, Hyprland may not be installed properly. Check the install logs in the Distro-Hyprland/install-logs directory. Rerun the install script ./install.sh from the Distro-Hyprland install script you used to install Kool's Dots e.g for Arch go to Arch-Hyprland/install-logs, or Debian-Hyprland/install-logs

🖥️ Will it work on a VM, VMware, Virtualbox or any virtualization?

  • It's Hit and Miss. However, if you decided to try, make sure you have 3D Acceleration enabled
  • NOTE!!! VMware and Virtualbox have poor 3D acceleration support.
  • If you want to try in a VM, recommend it to try using QEMU with Libvirt.
  • Here are the list of libvirt clients which manages QEMU virtualization Arch Wiki link

🖥️ If it goes back to log-in Manager after trying to Log in

  • Check logs. Probably Hyprland or any other packages was not installed properly. Or if you are using a VM, See above
  • You can also try to ran Hyprland manually. CTRL ALT F2 or F3, login as user. Once logged in, type Hyprland. If command not found, check installation log or you can re-run the install.sh script if some packages weren't installed. Check the Distro-Hyprland/install-logs directory to see what packages failed to install. E.g. For arch go to Arch-Hyprland/install-logs, or Debian-Hyprland/install-logs.

♨️ How to change wallpaper

  • Just add your wallpaper in ~/Pictures/wallpapers and choose it with SUPER W.
  • NOTE: wallpaper file name should not contain any space. you could use - or _ as spacers` This is Fixed on Hyprland-Dots v2.3.2
  • However, do note that automatic wallpaper change still in effect by default. See below for disabling the automatic wallpaper change
  • Dark & Light wallpapers are placed in ~/Pictures/wallpapers/Dynamic-Wallpapers/
  • If you want to change and make it permanent, edit ~.config/hypr/UserConfigs/Startup_Apps.conf

💻 Changing hyprlock default background

  • By default, hyprlock background will NOT follow current wallpaper.

  • To change hyprlock background, set a preferred wallpaper using SUPER W.

  • Once wallpaper changed, do SUPER SHIFT W.

    • Choose desired wallpaper effects.
    • Select "No effect" to set the hyprlock background to match the current wallpaper.

  • To set another wallpaper, edit ~/.config/hypr/hyprlock.conf . Look for path under background. Edit as desired. LINK for Configuring Hyprlock

  • if you want to change the hyprlock background to follow current wallpaper, edit ~/.config/hypr/hyprlock.conf change the line path = $HOME/.config/hypr/wallpaper_effects/.wallpaper_modified to path = $HOME/.config/hypr/wallpaper_effects/.wallpaper_current (this line will be added to v2.3.3)

♨️ Automatic wallpaper change

  • Disabled by default from v2.2.13-1. You can re-enable it by editing it as shown below.
  • By default, it is changing wallpaper every 30 mins. If you don't want that, you can edit ~.config/hypr/UserConfigs/Startup_Apps.conf with your favorite text editor or SUPER E , choose view Execs.conf . comment by adding # on exec-once = $SwwwRandom $WallpaperPath # random wallpaper switcher every 30 minutes. Reboot to take effect as logout does not work since the initial part of script (timer) is already loaded in system's memory
  • From Hyprland-Dots v2.2, the Automatic wallpaper script will not refresh waybar anymore. Means the wallust colors on waybars wont take effect. To quickly apply the wallust colors on waybar, you can press SUPER ALT R to refresh it.

♨️ Waybar modules are missing on some waybar layouts.

  • Every waybar layouts are unique. You need to add manually or reorganize the waybar modules according to your preference.
  • Make sure that once you do the changes, to rename the configs and styles. So you can easily copy over whenever there is an update.

♨️ Don't like Rainbow borders?

  • KooL's Dots v2.3.4, rainbow colors will only be on active or focused window. If you wanted rainbow colors in all window as before, edit ~/.config/hypr/UserScripts/RainbowBorders.sh
  • KooL's Dots v2.3.1, will be offered as optional during copy / installation.
  • Simplest way is to delete ~/.config/hypr/UserScripts/RainbowBorders.sh
  • if not, edit ~/.config/hypr/UserConfigs/Startup_Apps.conf (Comment by adding # exec-once = $ScriptsDir/RainbowBorders.sh) & edit as well ~/.config/hypr/scripts/Refresh.sh as well as ~/.config/hypr/scripts/RefreshNoWaybar.sh
  • You can also edit ~/.config/hypr/UserConfigs/UserSettings.conf and delete animation = borderangle...

♨️ colorful borders and just one simple border colors?

  • KooL's Dots v2.3.1, will be offered as one color only
  • edit ~/.config/hypr/UserConfigs/UserSettings.conf . on line col.active_border = $color0 $color2 $color9 $color12 $color15 90deg Put any color you want .
  • Note that by default is sourcing colors from wallust. If you dont want the wallust color, around line 8 delete or put # on source = $HOME/.config/hypr/wallust/wallust-hyprland.conf .
  • all the one with $color0-15 are from wallust-colors. Set colors how ever you want. Hyprland WIKI

♨️ Don't like pokemon-colorscripts?

  • you can uninstall it. For arch - sudo pacman -Rns pokemon-colorscripts-git & edit ~/.zshrc
  • other distro. Navigate to your downloaded -Hyprland folder. look for pokemon-colorscripts. cd into it. chmod +x uninstall.sh , then ./uninstall.sh
  • or if you just want to disable it, edit your ~/.zshrc . Comment out (#) the pokemon part.

♨️ Don't like nano or kitty for Quick Editor or Super E? (quick editor)

  • Set your default EDITOR
  • edit ~/.config/hypr/UserConfigs/ENVariables.conf add env = EDITOR, vim (will be introduced in KooL's Dots v2.3.4 but disabled by default)
  • or add in your .bashrc or .zshrc export EDITOR=vim
  • above sample is making vim as default editor
  • Alternatively, - edit ~/.config/hypr/UserScripts/QuickEdit.sh

♨️ Themes are broken when changing dark light or NO THEMES after installing even opted to install GTK Themes

  • Check contents of ~.themes and ~.icons . If no contents, you can download from here GTK Themes & Icons Link
  • Press the dark light button on waybar "󰔎" to switch between dark or light and gtk theme to take effect. Or use nwg-look utility to adjust GTK settings.
  • If you opt for GTK themes, Bibata cursor was also downloaded in your system.
  • You can also install your own dark and light themes and icons. Just ensure to rename the themes icons with -Dark or -Light as this is the reference keyword that script is looking for if you want to utilize the dark / light transition script.

♨️ Adjusting fonts sizes and font scaling including waybar fonts and kitty (terminal)

  • nwg-look is a very good app. Use it to adjust your own preference.
  • for qt-apps, use qt5ct and/or qt6ct and kvantum
  • HiDPI users, I suggest you do the following to have a better appearance.

  • adjust scaling according to your taste by editing ~/.config/hypr/UserConfigs/Monitors.conf

  • adjust font size using nwg-look (GTK Settings)

  • You can tweak the fonts scaling in Font tab in nwg-look

  • Lastly, if desired, adjust waybar fonts sizes in ~/.config/waybar/styles/ . NOT the styles.css since that is only a symlink to the styles in waybar styles folder

  • to adjust Kitty fonts, edit ~/.config/kitty/kitty.conf.

♨️ Keyboard shortcuts or customized Keybinds are broken!

  • copy over your previous Keybinds.conf from the hypr-backups in ~/.config/hypr/Userconfigs

⌨ Keyboard switching issue for multiple keyboard layouts

  • This POST maybe a fix

♨️ Wallust color changed on tty or kitty

  • starting Hyprland-Dots v2.2.11, the tty and kitty wallust color change are disabled by default.
  • by running wallust run /path/wallpaper, it will change the tty immediately. To make it permanent, edit ~/.config/kitty/kitty.conf & remove # on line #include kitty-colors.conf
  • to change tty colors after wallpaper change, edit the ~/.config/hypr/scripts/WallustSwww.sh remove the -s in wallust run "$wallpaper_path" -s & (located at the end)

❔ Some packages are opening on a specific workspaces

  • By default, some apps like discord, start and open on workspace 7. etc. You can change this behaviour by editing ~/.config/hypr/UserConfigs/WindowRules.conf You will find a lines with # windowrule v2 move to workspace and # windowrule v2 move to workspace (silent) . Edit as per your preference
  • or SUPER E choose window rules

🔔 swaync no backlight

  • you might not have intel_backlight installed. Check HERE

💻 Laptops, when lids closed, after a settings or automatic wallpaper change, the laptop display wake's up or is re-enabled.

  • Currently in v2.1.18 it's optional.
  • See notes on Laptops.conf and LaptopDisplay.conf in ~/.config/hypr/UserConfigs/ )
    • The reason being optional is that there is a CON for doing this.
    • See NOTES in Laptops.conf for more information.
  • One solution if you have an external monitor, mirror your laptop display to the external terminal :)

📽️ Screen Recording like OBS

  • Install pipewire and OBS
  • If OBS screenshare still does not work, you could try forcing to start the xdg-desktop-portal-hyprland.
    • Edit (xdg-desktop-portal-hyprland) in ~/.config/hypr/UserConfigs/Startup_Apps.conf
    • Remove # before exec-once=$scriptsDir/PortalHyprland.sh . Logout and relogin

⌨️ Added keybinds but does not work

  • Make sure that it does not conflict with other pre-defined keybinds in ~/.config/hypr/configs/Keybinds.conf.
  • If you think that I should change the pre-defined Keybinds due to conflict with i.e Global Shortcuts, let me know through github or on my Discord Server. Make sure to present a valid argument
  • Starting v2.2.2 add your own keybinds in ~/.config/hypr/UserConfigs/UserKeybinds.conf

🎼 Cava and Waybar Cava does not work

  • Unmute the mic
  • For Arch Linux and Arch Linux based distros, try switching over to cava-git

⌛ Automatic Screenlock

  • By default, it is configured that screen will lock in 10 mins.
    • To change this settings, edit ~/.config/hypr/hypridle.conf
  • If you don't want automatic screenlocking,
    • Edit ~/.config/hypr/UserConfigs/Startup_Apps.conf
    • Comment out or delete line 38 exec-once = hypridle -q
    • Alternatively, activate the idle_inbitor on your waybar. Thats the

⌨️ Keyboard layout unset error

  • This happens because when asked about your keyboard layout during copy / installation, you just answered y even detected layout is (unset)
    • edit kb_layout in ~/.config/hypr/UserConfigs/UserSettings.conf line 96.
    • Type in your proper kb_layout. i.e. us . Use command localectl list-keymaps.
    • More info from here Arch Linux Wiki Keyboard Configuration

⌨️ Keyboard layout switch.

  • pls see this PR Pull Request #292
  • a note from author ["If the layout in the waybar does not match the current keyboard layout, run: echo "us" > ~./.cache/kb_layout instead of "us", put the identifier of the current keyboard layout, for example "ru" or "en" or "ua", etc."]

🐢 delayed launching of hyprlock (screen lock)

  • the weather module on hyprlock gives about 3-5 seconds of delay. fixed on Hyprland-Dots v2.2.11
  • configuration of hyprlock is in ~/.config/hypr/hyprlock.conf hyprlock link

🆕 Rofi not getting auto focus, or some weird things going on with rofi

  • Make sure you installed the ROFI-WAYLAND. Rofi will work but you will have issues
  • ROFI-wayland LINK
  • Note that rofi-wayland is compatible with x11 so you dont need to worry
  • instruction how to remove and install of rofi-wayland are stated on the Readme's on Distro-Hyprland install scripts. Look at the known issues sections

🫓 Flatpak apps not showing in rofi

  • Try logging out and back in.
  • THIS might help

🔑 installed zsh but no autostart of Hyprland after login

  • This was disabled a few days ago. (19 May 2024). This was because some users, after they used the Distro-Hyprland scripts with other DE (gnome-wayland or plasma-wayland), if they choose to login into gnome-wayland for example, Hyprland is starting.
  • to avoid this, I disabled it. You can re-enable again by editing ~/.zprofile . Remove all the # on the first lines

☀️ Cant control brightness of monitor on laptop

🔣 waybar-cava broken

  • This is because LANG on locale was not set. You can set your system locale by

edit /etc/locale.conf and add

LANG=en_US.UTF-8

alternatively, run:

sudo localectl set-locale LANG=en_US.UTF-8
  • set the LANG=en_US.UTF-8 according to your locale. See this Arch Wiki . Note this wiki is applicable for any systemd distros

🫢 waybar idle-inhibitor

  • this one is mostly ask. LINK

©️ Force starting of xdg-desktop-portal-hyprland

  • By default, it should be automatically started when needed.
  • You can force start when starting your system
  • SUPER E choose edit startup_apps
  • uncomment the last part of that file (remove #) exec-once = $scriptsDir/PortalHyprland.sh

😵‍💫 Don't like opacity?

  • start from Hyprland-Dots v2.3.2
  • You can disable the opacity via editing opacity on window rules ~/.config/hypr/UserConfigs/WindowRules.conf or(SUPER E - edit Window-Rules)
  • Or you can disable TEMPORARY the opacity of the active window with SUPER ALT O. Note that it is just temporary. Once your exit Hyprland with reboot or logout, window rule will take over over.

💥 AGS Overview too wide or too small

🗒️ Neovim error when opening via thunar

  • edit neovim.desktop either in ~/.local/share/applications or /usr/share/applications 
Exec=kitty nvim %F
Terminal=false

♨ Waybar CPU Showing Wrong Temperature

  • to change from deg C to deg F , edit the ~/.config/waybar/modules look for "temperature". Change the format to "format": "{temperatureF}°F {icon}",

  • to fix the temperature if not showing correctly, edit the hwmon-path accordingly and/or thermal_zone in ~/.config/waybar/Modules

  • To list all the zone types, run

 for i in /sys/class/thermal/thermal_zone*; do echo "$i: $(<$i/type)"; done
  • If you don't have a thermal zone, another option is to use sensors to find preferred temperature source, then run
for i in /sys/class/hwmon/hwmon*/temp*_input; do echo "$(<$(dirname $i)/name): $(cat ${i%_*}_label 2>/dev/null || echo $(basename ${i%_*})) $(readlink -f $i)"; done
  • look for K10temp for AMD CPU and coretemp for Intel CPU's hen include it in hwmon-path variable.

💢 zsh shell customization

  • if you opt for zsh, you have access to customize your zsh
  • keybind super shift O will pop up a menu for a premade zsh themes
  • preview of these themes is on this LINK

💌 Kwallet related

  • If you install alongside Plasma, you might get an issue with packages that uses kwallet
  • From a BLOG POST by geoffcorey is a nice how to fix that issue

Home

Installation

FAQ & TIPS

Keybinds

Known Issues & Notes to remember

Changelogs & Release Notes

Other Distros

Gallery & Youtube Videos

HOW TO's (Costumization on KooL's Dots)

Clone this wiki locally