Troubleshooting
The latest version of the ML4W Dotfiles for Hyprland include a completely new wallpaper script. This can result in a black screen with only mouse pointer when you upgrade from a relative old version.
Please Press SUPER + SHIFT + W to set the wallpaper manually. This will solve the issue.
When you're using the ML4W Dotfiles 2.9.6.5 or lower and you update to Hyprland 0.45.0 you will see the following error messages on top of your screen:
You can hide the error message temporarily by typing
hyprctl seterror disablein your terminal.
- To solve the issue, please update to ML4W Dotfiles 2.9.6.6. Don't forget to run
ml4w-hyprland-setupafter updating your packages. - If you want to stay keep your ML4W Dotfiles version, you can also replace your existing drop shadow configuration in .config/hypr/conf/decorations/default.conf with https://github.com/mylinuxforwork/dotfiles/blob/main/share/dotfiles/.config/hypr/conf/decorations/default.conf
Hyprland 0.45.0 release information: https://github.com/hyprwm/Hyprland/releases/tag/v0.45.0
If you notice an error with the new Sequoia theme, you can uninstall the theme with
sudo rm -rf /usr/share/sddm/themes/sequoia
paru -S downgrade
sudo downgrade tzdata
select 2024a-2
Downgrade tzdata to 2024a-2 and reboot will fix the issue.
Using downgrade tool important to click yes to no update otherwise it reverts back to UTC after reboot.
You can find a related issue here https://github.com/mylinuxforwork/dotfiles/issues/230
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.
At the end of the update from earlier versions to 2.9.5 or higher I see an error message in the terminal
This is not a problem. Just reboot as suggested after the update and the error message is gone.
From 2.9.5 onwards the ML4W Dotfiles will be installed in a new file structure and the starship.toml has been moved to another location.
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. It also can happen when you start Hyprland from tty the second time.
If waybar is not loading, the first thing that you should try is to reboot your system and try again.
You can open a terminal with SUPER+Return and enter wlogout.
If it's still not working please try to uninstall xdg-desktop-portal-gtk
sudo pacman -R xdg-desktop-portal-gtk
Reboot your system again.
Waybar should working now but you will loose the dark mode in Libadwaita apps e.g., nautilus. The ML4W Apps will still work in dark mode.
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.
If there is still this issue, please uninstall xdg-desktop-portal-gtk. If dark mode is required install dolphin, qt6ct and enable breeze and darker colors to get a filemanager in dark mode.
The package xdg-desktop-portal-gtk is not installed.
Can be installed with the Post Installation Script from the ML4W Welcome App - 3 dots menu.
Or with
sudo pacman -S xdg-desktop-portal-gtk
And then reboot your system.
On Arch Linux, Chinese, Japanese, and Korean (CJK) characters display as unreadable squares or pixelated text in some applications.
Install the noto-fonts-cjk package with:
sudo pacman -S noto-fonts-cjk
This package provides proper rendering for CJK characters across the system.
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
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
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.
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
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