System settings preview
From Zacess Profile v0.2.2. Edit this page on GitHub
zprf os --print prints the system accessibility settings a profile maps to. It is a preview
only: zprf never runs the lines it prints and has no option to. --print is required so that is
never in doubt. The commands are for a person to read and run, since a wrong system setting can
lock someone out of their own screen.
zprf os zacess-deep-contrast-dark.toml --print
zprf os zacess-deep-contrast-dark.toml --print --platform gnomeWithout --platform it prints for the system it runs on. --platform takes macos, gnome or
windows.
What each need maps to
| Need | macOS | GNOME | Windows |
|---|---|---|---|
reduce_motion |
Reduce motion | Reduce animation plus a steady text cursor | Window animation and the blinking text cursor off |
| a text floor of 7:1 or more | Increase contrast | High contrast | Contrast themes, chosen in Settings rather than set |
appearance |
Dark or light | The colour scheme | Apps and system mode |
| the selection colour | The highlight colour | no line | no line |
font.size_pt |
no system setting | Large text, as a scale of the 11 point interface font | Text size, as a scale of 9 point Segoe UI from 100 to 225 per cent |
font.family |
no system setting | The monospace font | no system setting |
focus_ring_width_px |
no system setting | no system setting | The width of the focus rectangle |
Each platform's output ends by naming the needs it has no setting for. Colours and the appearance
the profile leaves out are the ones zprf derive would choose.
macOS
The lines are defaults write and defaults delete commands. From the Zacess Deep Contrast Dark
starter profile:
# reduce_motion: Accessibility > Display > Reduce motion
defaults write com.apple.universalaccess reduceMotion -bool true
# a text floor of 7:1 or more: Accessibility > Display > Increase contrast
defaults write com.apple.universalaccess increaseContrast -bool true
# appearance = dark: Appearance > Dark
defaults write -g AppleInterfaceStyle -string DarkThe output notes that writing com.apple.universalaccess needs a terminal with Full Disk Access on
recent macOS.
GNOME
The lines are gsettings set commands:
# reduce_motion: Accessibility > Seeing > Reduce animation plus a steady text cursor
gsettings set org.gnome.desktop.interface enable-animations false
gsettings set org.gnome.desktop.interface cursor-blink false
# a text floor of 7:1 or more: Accessibility > Seeing > High contrast
gsettings set org.gnome.desktop.a11y.interface high-contrast trueWindows
The lines are reg add values with the Settings page each one matches:
# appearance = dark: Settings > Personalisation > Colours > Choose your mode
reg add "HKCU\Software\Microsoft\Windows\CurrentVersion\Themes\Personalize" /v AppsUseLightTheme /t REG_DWORD /d 0 /f
reg add "HKCU\Software\Microsoft\Windows\CurrentVersion\Themes\Personalize" /v SystemUsesLightTheme /t REG_DWORD /d 0 /fAnimation effects in Settings also stop animation inside apps, which has no single registry value, so the printed values stop window animation and the blinking text cursor only.
Read every line first
os --print maps each need to the closest system setting it knows. The text size scale is the
profile size over 11 points on GNOME and over 9 points on Windows. Increased contrast is suggested
whenever the text floor is 7:1 or more. Read every line before running any of them. The full
option list is in the os reference.