Skip to content

Latest commit

 

History

History
36 lines (34 loc) · 2.15 KB

troubleshooting.md

File metadata and controls

36 lines (34 loc) · 2.15 KB
Raw

Troubleshooting

  • The window content is way too big and goes off screen.
    • Linux: Try setting the WINIT_X11_SCALE_FACTOR environment variable to 1. Flatpak installs will have this set automatically.
  • The file/folder picker doesn't work.
    • Linux: Make sure that you have Zenity or kdialog installed and available on the PATH. The DISPLAY environment variable must also be set.
    • Steam Deck: Use desktop mode instead of game mode.
    • Flatpak: The DISPLAY environment variable may not be getting passed through to the container. This has been observed on GNOME systems. Try running flatpak run --nosocket=fallback-x11 --socket=x11 com.github.mtkennerly.ludusavi.
  • On Windows 11, when I open the GUI, a console window also stays open.
    • This is a limitation of the new Windows Terminal app (microsoft/terminal#14416). It should be fixed once Windows Terminal v1.17 is released. In the meantime, you can work around it by opening Windows Terminal from the Start Menu, opening its settings, and changing the "default terminal application" to "Windows Console Host".
  • The GUI won't launch.
    • There may be an issue with your graphics drivers/support. Try using the software renderer instead by setting the ICED_BACKEND environment variable to tiny-skia.
    • You can try prioritizing different hardware renderers by setting the WGPU_BACKEND environment variable to dx12, vulkan, or metal.
    • Flatpak: You can try forcing X11 instead of Wayland: flatpak run --nosocket=wayland --socket=x11 com.github.mtkennerly.ludusavi

Environment variables on Windows

Some of the instructions above mention setting environment variables. If you're using Windows and not familiar with how to do this, you can follow these instructions:

  • Open the Start Menu, search for edit the system environment variables, and select the matching result.
  • In the new window, click the environment variables... button.
  • In the upper user variables section, click the new... button, then enter the variable name and value. If the variable already exists, select it and click edit....