Frequently Asked Questions

General

Why 'fooyin'?

The name is based on 'foo' from foobar and the chinese 音 (yīn), meaning 'sound'. It's also a play on 福音 (fúyīn), meaning 'good news'.

Why doesn't fooyin use my system theme?

As fooyin is built using Qt6, it will follow the system Qt style. If you're using a non-Qt DE such as GNOME or Cinnamon, you will need to install something like qt6ct.

Why can't fooyin read a directory or why does it fail to find a previously added directory on restart?

The Flatpak sandbox restricts filesystem access, so fooyin cannot freely read directories outside of its allowed scope. Common music locations are already permitted. If a directory is missing from the directory picker, cannot be read, or a library becomes unavailable after restarting fooyin, grant access to that directory using a tool such as Flatseal, or run the following command after replacing the example path:

flatpak override --user --filesystem="/path/to/music" org.fooyin.fooyin

Restart fooyin after changing its permissions.

Why are the notification timeout and album art options disabled in the Flatpak?

The Flatpak uses the desktop notification portal by default, which does not support custom timeouts or album art. To enable these options, use Flatseal to add org.freedesktop.Notifications to fooyin's Session Bus “talk” permissions, or run:

flatpak override --user --talk-name=org.freedesktop.Notifications org.fooyin.fooyin

Restart fooyin after changing its permissions. See issue #995 for more details.

Why can't Run Services launch applications from the Flatpak?

The Flatpak sandbox cannot directly run applications installed on the host. To allow fooyin to launch host applications, use Flatseal to add org.freedesktop.Flatpak to fooyin's Session Bus "talk" permissions, or run:

flatpak override --user --talk-name=org.freedesktop.Flatpak org.fooyin.fooyin

Then prefix each service command with flatpak-spawn --host. For example:

flatpak-spawn --host /usr/bin/spek \"%filepath%\"

This permission allows fooyin to execute arbitrary commands outside the sandbox. Only enable it if you trust your configured services.