Skip to content

Latest commit

 

History

History
397 lines (231 loc) · 6.69 KB

TROUBLESHOOTING.md

File metadata and controls

397 lines (231 loc) · 6.69 KB

Troubleshooting Guide

This document provides solutions to common issues you might encounter while using this Hyprland configuration.

Table of Contents

Hyprland Won't Start

If Hyprland fails to start, try the following:

  1. Check Hyprland logs: 
    cat ~/.local/share/hyprland/hyprland.log

Look for any error messages that might indicate the problem.

  1. Ensure all dependencies are installed:
yay -S hyprland waybar rofi dunst kitty python3 brightnessctl playerctl
  1. Verify your configuration files:
hyprctl reload

If there are any syntax errors, they will be displayed.

  1. Try starting Hyprland with a minimal configuration:
mv ~/.config/hypr/hyprland.conf ~/.config/hypr/hyprland.conf.bak
echo "monitor=,preferred,auto,1" > ~/.config/hypr/hyprland.conf

If Hyprland starts, gradually add back your configuration, testing after each addition.

Screen Tearing

If you experience screen tearing:

  1. Enable VRR (Variable Refresh Rate) in your Hyprland configuration:
echo "general {
    vrr = 1
}" >> ~/.config/hypr/hyprland.conf
  1. If using NVIDIA, ensure you have the proper drivers and configuration:
yay -S nvidia-dkms

Add the following to your Hyprland configuration:

echo "env = LIBVA_DRIVER_NAME,nvidia
env = XDG_SESSION_TYPE,wayland
env = GBM_BACKEND,nvidia-drm
env = __GLX_VENDOR_LIBRARY_NAME,nvidia
env = WLR_NO_HARDWARE_CURSORS,1" >> ~/.config/hypr/hyprland.conf

Audio Issues

If you're experiencing audio problems:

  1. Ensure PulseAudio is running:
pulseaudio --check

If it's not running, start it with:

pulseaudio --start
  1. Check if your audio device is recognized:
pactl list short sinks
  1. If using Bluetooth audio, make sure the Bluetooth service is running:
sudo systemctl status bluetooth

If it's not running, start it with:

sudo systemctl start bluetooth
  1. Try restarting PulseAudio:
pulseaudio -k && pulseaudio --start

Bluetooth Problems

If you're having issues with Bluetooth:

  1. Ensure the Bluetooth service is running:
sudo systemctl status bluetooth

If it's not running, start it with:

sudo systemctl start bluetooth
  1. Check if your Bluetooth adapter is recognized:
bluetoothctl list
  1. If the adapter is not found, try reloading the Bluetooth module:
sudo modprobe btusb
  1. For persistent Bluetooth issues, try resetting the Bluetooth system:
sudo systemctl stop bluetooth
sudo rm /var/lib/bluetooth/*
sudo systemctl start bluetooth

Wi-Fi Connectivity

If you're having Wi-Fi issues:

  1. Check if your Wi-Fi adapter is recognized:
ip link
  1. Ensure the necessary services are running:
sudo systemctl status iwd
sudo systemctl status dhcpcd

If they're not running, start them:

sudo systemctl start iwd
sudo systemctl start dhcpcd
  1. Connect to a network using iwctl:
iwctl
[iwd]# device list
[iwd]# station <device> scan
[iwd]# station <device> get-networks
[iwd]# station <device> connect <SSID>
  1. If you're still having issues, try restarting the network services:
sudo systemctl restart iwd
sudo systemctl restart dhcpcd

Keybindings Not Working

If your keybindings aren't functioning as expected:

  1. Check your keybindings configuration:
cat ~/.config/hypr/keybinds.conf
  1. Ensure there are no conflicts between different keybindings.
  2. Try reloading your Hyprland configuration:
hyprctl reload
  1. If a specific keybinding isn't working, try binding it to a different key to isolate the issue.

Application-Specific Issues

Firefox

If Firefox is not rendering correctly:

  1. Enable Wayland support in Firefox:

  2. Open about:config in Firefox

  3. Set gfx.webrender.all to true

  4. Set widget.use-xdg-desktop-portal to true

  5. Restart Firefox and check if the issue is resolved.

Discord

If Discord is not functioning properly:

  1. Try using the Wayland version of Discord:
yay -S discord_arch_electron
  1. If screen sharing doesn't work, install xdg-desktop-portal-hyprland:
yay -S xdg-desktop-portal-hyprland

Performance Problems

If you're experiencing performance issues:

  1. Check your system resources:
htop
  1. Disable animations if they're causing slowdowns:
echo "animations {
    enabled = false
}" >> ~/.config/hypr/animations.conf
  1. Reduce blur and shadows:
echo "decoration {
    blur {
        enabled = false
    }
    drop_shadow = false
}" >> ~/.config/hypr/hyprland.conf
  1. If using NVIDIA, ensure you're using the proper drivers and settings as mentioned in the Screen Tearing section.

Waybar Issues

If Waybar isn't appearing or is malfunctioning:

  1. Check Waybar's configuration:
cat ~/.config/waybar/config
  1. Ensure Waybar is running:
pgrep waybar || waybar &
  1. Check Waybar's logs for any error messages:
waybar -l debug
  1. If Waybar is frozen, try restarting it:
killall waybar && waybar &

Theming and Appearance

If you're having issues with themes or appearance:

  1. Ensure all theme-related packages are installed:
yay -S nwg-look kvantum qt5ct
  1. Check your GTK theme settings:
cat ~/.config/gtk-3.0/settings.ini
  1. Verify Qt theme settings:
cat ~/.config/qt5ct/qt5ct.conf
  1. If icons are missing, update your icon cache:
gtk-update-icon-cache
  1. For font issues, ensure all necessary fonts are installed and update the font cache:
fc-cache -fv

If you continue to experience issues after trying these solutions, please open an issue on the GitHub repository with a detailed description of your problem and any relevant log outputs.