Troubleshooting

[TOC]

Check that all key packages and commands are available

The ML4W Welcome App includes a system diagnosis feature available in the menu with the three dots.

Or open the script in a terminal with

ml4w-diagnosis

Please run the diagnosis to see if all essential packages and related commands are available on your system.

If not, you need to install the missing packages manually.

Waybar is not loading

The effect that waybar isn't loading usually happens after a fresh installation of the ML4W Dotfiles. The reason is the start of the xdg-desktop-portal-gtk process.

If waybar is not available, the first thing that you should try is to reboot your system.

You can open a terminal with SUPER+Return.

If it's still not working please try to uninstall xdg-desktop-portal-gtk

sudo pacman -Rns xdg-desktop-portal-gtk

Reboot your system again.

Waybar should working now.

Then try to install it again with

sudo pacman -S xdg-desktop-portal-gtk

Please also make sure that xdg-desktop-portal-gnome is not installed in parallel to xdg-desktop-portal-gtk. Please try to remove the package then.

rofi (application launcher) is not working

If the installation of rofi-wayland fails in the installation/update procedure please try to install it manually:

yay -S rofi-wayland

If rofi-wayland isn't available please try rofi:

yay -S rofi

hypridle and hyprlock is not starting after an update of the dotfiles

Please make sure that hypridle and hyprlock has been installed successfully with

yay -S hypridle hyprlock

If there is an file conflict the remove the files manually with:

sudo rm /usr/lib/debug/usr/bin/hypridle.debug
sudo rm /usr/lib/debug/usr/bin/hyprlock.debug

and start the installation again with

yay -S hypridle hyprlock

GTK apps not using dark theme

Waybar is not loading

Please try to install xdg-desktop-portal-gtk

sudo pacman -S xdg-desktop-portal-gtk

You can also try to remove xdg-desktop-portal-gtk and reinstall it again.

Missing icons in waybar

In case of missing icons on waybar, it's due to a conflict between several installed fonts (can happen especially on Arco Linux). Please make sure that ttf-ms-fonts is uninstalled and ttf-font-awesome and otf-font-awesome are installed with

yay -R ttf-ms-fonts
yay -S ttf-font-awesome otf-font-awesome

SDDM not showing (only black screen with cursor)

Switch to another tty with CTRL + ALT + F3 Now you can login with your user.

Start Hyprland with Hyprland.

You can try to reinstall all sddm related packages.

yay -S sddm-git sddm-sugar-candy-git

Or you can install another display manager.

To stop, disable and remove sddm service.

sudo systemctl stop sddm.service
sudo systemctl disable sddm.service
sudo rm /etc/systemd/system/display-manager.service