Git-Mirrors/Qubes-Community-Content
1
0
Fork 0
mirror of https://github.com/Qubes-Community/Contents.git synced 2024-10-01 01:05:51 -04:00
Code Issues Packages Projects Releases Wiki Activity
a28127f2b1
Qubes-Community-Content/docs/customization/dpi-scaling.md
taradiddles a28127f2b1 improved doc
2018-04-16 16:01:45 +03:00

3.2 KiB
Raw Blame History

DPI scaling

Qubes OS passes on dom0's screen resolution to VMs (this can be seen in the output of xrandr) but doesn't pass on dom0's dpi value. Recent distributions have automatic scaling depending on the screen's resolution (eg. in fedora if the vertical resolution is greater than 1200px) but for a variety of reasons one may have to set a custom dpi scaling value.

Dom0

The simplest way to set dpi scaling in dom0 is to use the desktop environment's custom dpi feature:

  • Xfce: Qubes Menu → System Tools → Appearance → Fonts tab: Custom DPI setting: xxx
  • KDE: Qubes Menu → System Settings → Font → Force font dpi: xxx

Replace xxx with a number that fits your setup and is a multiple of 6, as numbers that aren't sometimes result in annoying rounding errors that cause adjacent bitmap font sizes to not increment and decrement linearly.

VMs

The procedure for setting DPI scaling depends on the presence of the /usr/libexec/gsd-xsettings daemon from the gnome-settings-daemon package:

  • without /usr/libexec/gsd-xsettings running, applications honor the Xft.dpi` X resource
  • with /usr/libexec/gsd-xsettings running, applications are prevented from using the Xft.dpi Xresource so gnome specific commands have to used.

Notes:

  • the official fedora-xx template has gnome-settings-daemon installed by default but fedora-xx-minimal doesn't.
  • when testing DPI scaling with xterm (or more generally any glib apps) you must use a xft font:
    • for xterm, ctrl-right click in the terminal's windows and select TrueType fonts (make sure you have such fonts installed !)
    • or, set the faceName Xresource (eg. XTerm*faceName: DejaVu Sans Mono:size=14:antialias=true) either with xrdb -merge or in a Xresources file (see below).

VMs without gnome-settings-daemon (eg. 'fedora-xx-minimal' template)

Get the current value of Xft.dpi:

xrdb -query | grep Xft.dpi

Test with a different dpi value: in a terminal issue the following command and then start an application to check that the menus/fonts' size is increased/decreased; replace '144' with the value set in dom0 (it's possible to set a different value in VMs though):

echo Xft.dpi: 144 | xrdb -merge

Once you found a value that fits your setup you'll likely want to permanently set the dpi Xresource. You can do so on a per-template or per-VM basis:

  • add (or modify) Xft.dpi: xxx in the TemplateVM's Xresource file (/etc/X11/Xresources or /etc/X11/Xresources/x11-common for whonix-ws-template).
  • or, add Xft.dpi: xxx to $HOME/.Xresources in each AppVM.

VMs with gnome-settings-daemon installed (eg. 'fedora-xx' template)

Use the gsettings command (replace 2 and 0.75 to suit your needs ; the first value must be an integer though):

gsettings set org.gnome.desktop.interface scaling-factor 2
gsettings set org.gnome.desktop.interface text-scaling-factor 0.75

Resources

Contributors: @taradiddles