Settings

The unified Settings application provides one place to inspect desktop capabilities and see which features are available, restricted, or planned.

Open Control Center with Super+F1, then select Settings from the main menu. You can also run:

dwm-settings open

The Displays section discovers connected outputs and their advertised modes, lets you edit resolution, refresh rate, position, rotation, primary state, and output enablement, and manages named layouts. Choose Apply changes to test the complete layout for 15 seconds, then Keep changes to accept it or Revert to restore the captured layout. Timeout or closing Settings also restores the prior layout. Saved layouts can be reused later; Use at next login installs the selected layout for future X11 sessions after a separate confirmation and administrator authorization. The machine-oriented dwm-settings-display helper exposes discover and watch, complete-layout save and preview, named preview-profile, timed keep, revert, and preview-status, plus authorized install-profile and rollback-system actions. Named layouts live under the lyona XDG config directory. Legacy incomplete layouts remain available to dwm-display-profile, but Settings requires them to be resaved as complete layouts before preview or persistent installation.

The Displays section also sets display scaling. Enter an Xft DPI between 72 and 384, or use the 100%, 125%, 150%, 175%, and 200% presets. Applying writes Xft.dpi to dpi.Xresources in the lyona XDG config directory and merges it into the running X resource database; autostart reapplies it at every login. The pane reports whether the active scale is saved, session-only, or the X server default, and shows the primary output’s measured DPI as a suggestion. Reset removes the saved value and clears Xft.dpi from the running database without disturbing other X resources. Scaling is not a timed preview: only applications started after the change pick up the new value, so restart dwm and the shell to rescale them too. The helper actions are dpi-set, dpi-reset, and the startup-only dpi-apply-saved.

The Input section shows each XInput device by a stable hardware identity and offers only properties its driver exposes. Pointer acceleration, natural scrolling, tap-to-click, keyboard layout, and modifier options are supported when available. Changes use a timed preview with Keep and Revert. Reset is a separate direct action that restores and persists the driver’s default. Kept values are reapplied idempotently at session startup when the device exposes a stable udev or physical sysfs identity. Devices without one remain session-configurable and report that persistence is unavailable. Unsupported per-device properties remain visible with an explanation.

Type to search section names and descriptions. Use Up and Down to move through the filtered sections, Enter to select one, or Escape to close Settings. The Refresh button runs a new bounded capability snapshot; Settings does not add an idle polling timer.

Command-line IPC actions are also available:

dwm-settings open
dwm-settings refresh
dwm-settings status
dwm-settings close

Existing window-rules.toml files are preserved during upgrades. If your file predates Settings, add this entry inside its rules array:

{ title="dwm settings", isfloating=1, alwaysontop=1 },

Saving the file applies the rule through dwm’s normal hot reload. A customized rule with the same title can be retained instead.

The Use at next login display action writes only the managed 90-lyona-display.conf fragment after a separate confirmation and polkit authorization. The installed helper accepts validated display records only, backs up the previous managed next-login fragment, and offers Restore login backup. It does not capture the live XRandR layout. Later phases add connectivity, audio, power, defaults, personalization, and system-management operations.