Troubleshooting FAQ

Q: I'm using Flatpak with NVIDIA and the window just shows an empty border on launch

Try run flatpak update.

Q: I tried installing/updating the Flatpak but it gives error "Aborted due to failure..."

Try run: sudo flatpak repair && flatpak repair --user && flatpak update

Q: I'm using an AUR installation and it broke after a big system update

In the event of a major python update, all python AUR packages need to be rebuilt. You can see which packages need to be rebuild by, as guide, using a command like this pacman -Qoq /usr/lib/python3.9 (replace 3.9 with the last version that was upgraded from).

Q: I added new items to my home music folder, but they didn't then immediately show up in Tauon, why?

Tauon doesn't have background scanning. You need to either manually import items, or use the "Rescan Folders" function from a playlist tab context menu.

Q: Some of my albums don't have album art!

It should be detected if you have them. If you don't have thee it's up to you to manage your library and provide them. For convenience, while playing a particular album you can right click the album art viewport in the right side panel and select "Quick fetch cover art".

Q: Some of the thumbnails in the gallery aren't showing the right cover image, how to I change it?

Right click the thumbnail, choose "Image...", then choose "Next".

Q: Always-on-top for mini-mode doesn't work on Wayland

This is a current upstream limitation. To workaround you can tell Tauon to use xwayland, to do this, open Tauon's user data dir ("MENU" > "Settings..." > "Function" > "Open data folder") and create an empty file named x11. (You can to this by opening a terminal at that location and running touch x11)

Q: I get a crash with the outupt error being something like tauonmb: ../cairo/src/cairo-surface.c:938: cairo_surface_reference: Assertion CAIRO_REFERENCE_COUNT_HAS_REFERENCE (&surface->ref_count)' failed.

If you have the tray enabled try disable it.