Skip to content
end-4/dots-hyprland

Troubleshooting

Hints

  • If there’s a problem with something, the first thing to do is to fire up a terminal (Super+T) and run it. Look for errors/warnings that could be problematic.
  • The bar, sidebars, cheatsheet, etc. are powered by AGS. Open a terminal and run pkill ags; ags

Use some common sense. If you can’t figure out, open a discussion for help.

Some problems

Music controls don’t show up

Reference: end-4/dots-hyprland#168

  • Make sure your player has Mpris support (a list: Arch Wiki link)
  • If it’s a browser, install the Plasma Integration extension: Firefox or Chromium and plasma-browser-integration (this is for Arch)

Then, when firefox is playing media, the following command

Terminal window
dbus-send --print-reply --dest=org.freedesktop.DBus /org/freedesktop/DBus org.freedesktop.DBus.ListNames|grep mpris

the output should include

string "org.mpris.MediaPlayer2.plasma-browser-integration"

Only “plasma-browser-integration” names will work. others won’t.

If for some reason, firefox still does not have dbus org.mpris.MediaPlayer2.plasma-browser-integration showing up, consider the following steps:

  1. Create a new profile using firefox --ProfileManager.
  2. Launch firefox with the newprofile and install the Plasma Integration extension again.
  3. Restart firefox with the new profile and try again.
  • Note: playerctl -F metadata may also be helpful for debugging.

Icons don’t show up. I get weird texts instead.

  • You must be missing the Material Symbols font. You can download the font manually then put it in ~/.local/share/fonts
  • Note that it’s Material Symbols, not Material Icons!
  • Remember to fc-cache -fv to refresh font cache. A reboot will also work.

AGS installation failed

PermissionError: [Errno 13] Permission denied: '/usr/local/lib/libgvc.so'

Run this to check whether this file belongs to any package (very likely not, because it’s inside /usr/local)

Terminal window
pacman -Qo /usr/local/lib/libgvc.so

If not, then it’s probably safe to just remove it. To do so, run this:

Terminal window
sudo mv /usr/local/lib/libgvc.so /tmp/

Other errors

Delete ./cache/ags and install it again.

Hyprland installation failed

Sometimes the AUR package doesn’t install all the dependencies for you. Hyprland is always evolving and this happens when something new is added

  • Check the logs and see if it tells you to install something, then attempt to build it again
  • Note: You might have to clear ~/.cache/yay

loginctl lock-session does nothing

Reference: end-4/dots-hyprland#278

According to this post on Arch Linux Forums:

Something needs to listen to systemd-logind’s dbus signals for this to work.

Hypridle is capable to be this “thing”, which means you should ensure that it is running, and then loginctl lock-session will send signal to hypridle, as a result hypridle will lock the screen by executing the $lock_cmd defined in its config ~/.config/hypr/hypridle.conf.

See Hyprland Wiki for more.

Terminal: Why can’t I interrupt with Ctrl+C?

  • In foot, Ctrl+C is configured to copy text. To interrupt, use Ctrl+Shift+C
  • Don’t want this?
    • To remove this binding: in ~/.config/foot/foot.ini, comment or remove the line that says clipboard-copy=Control+c
    • Maybe if you use terminal apps a lot, it’d be a good idea to use a more feature-rich terminal