Kestrel Innovations Logo Kestrel Innovations

Leading the Way in Technological Solutions

Wayland UI Scaling Issue with Peregrine Desktop App

If you are running the Peregrine desktop app on a Debian 13 distro that uses the Wayland display server, you may experience a UI scaling issue. Specifically the fonts may all look to small or large.
This is usually due to a conflict between the applications framework and the Scale setting in the distro's Display Settings.

The issue can be remedied by setting the KIVY_METRICS_DENSITY variable before running the application. The value range is between 1.0 and 2.0. You may need to experiment with the values.

Example 1 (inline):
KIVY_METRICS_DENSITY=1.5  ./peregrine.bin

Example 2 (export):
export KIVY_METRICS_DENSITY=1.5
./peregrine.bin