Settings

lensOS Settings, and lensos-config for the same settings from a terminal.

lensOS Settings (Super + I, or the gear on the dock) is one window for the whole desktop. Changes apply as you make them; there’s no Apply button except for screens, where a wrong resolution could leave you unable to see. Type in the search box (Ctrl + F) to find a setting’s page. Opening Settings again brings back the window that’s already open.

What’s in it

page	what you can change
Appearance	themes, three accent colours of your own, colours picked from your wallpaper, the wallpaper
Bar	style (pills, one floating bar, full width, or no background at all), top or bottom, size, how see-through, whether windows stay clear of it, which screens; widgets you add, move, join into one pill and remove (among them Windows, a taskbar of your open windows: click one to bring it back or minimize it, middle-click to close it); the clock
Dock	show or hide it, glass background or none, icon size, hiding, position, zoom
Desktop & windows	icons on the desktop, click or hover focus, title bar buttons left or right, number of desktops, space at the screen edges
Effects	blur, shadows, motion, fades, rounded corners, dimming the windows you’re not using, VSync, the drawing method
Wi-Fi & network	Wi-Fi on or off, nearby networks to join (with a password field), disconnect and forget; wired connections; the full network editor
Bluetooth	on or off, your devices with battery level, connect, disconnect and remove; look for new devices and pair them
Phone	pair your iPhone or Android phone for the Phone app (its notifications, calls, texts, contacts and music), step by step, and choose what it shares (more)
Displays & graphics	resolution, refresh rate, rotation and arrangement of each screen; brightness (a laptop’s screen and keyboard light); text and app size; night light; your graphics card and its driver. On a sharp high-resolution screen (a Retina MacBook, a 4K laptop) the scale is set for you at the first login (with a button to install NVIDIA’s driver when it would help)
Sound	output and microphone, their volume, whether the volume keys may go past 100%, the key step, the volume popup
Power & lid	power mode, what closing the lid does (on battery, plugged in, with a monitor), locking, screen off and sleep when idle, low-battery warnings, the power button
Keyboard & mouse	layouts and how to switch them, Caps Lock, key repeat, tap Super for the apps, pointer speed and acceleration, natural scrolling, touchpad tapping; every shortcut
Date & time	time zone, setting the time automatically or by hand, 24- or 12-hour clock, seconds and the date on the bar
Terminal	text size, see-through, padding, cursor, the cursor trail, the system summary (fastfetch or hyfetch with a pride flag), the prompt, `*` while typing passwords
Notifications	do not disturb, where they appear, how long they stay, update notifications. Past ones are in the notification sidebar (`Super` + `N`, or the bell on the bar)
Screenshots	copy to the clipboard, save (and where), include the pointer, the notification
Apps & tools	default apps for links, files, pictures, video, music and mail; the terminal; bundles to add (VS Code, developer tools, gaming, Discord, OBS, creative apps, office)
Extras	clipboard history, the pointer in screen shares
Updates	check and update, notifications, channel, snapshots to roll back to
About	this computer and lensOS, with a button to copy the details for a bug report

On a computer still running the retired KDE edition, Settings has Appearance, Apps & tools, Updates and About; Plasma’s own System Settings covers the rest.

lensos-config

Settings on the Openbox edition are stored in ~/.config/lensos/settings.conf, which holds only what you changed. lensos-config reads and changes the same settings from a terminal, so they fit in scripts and dotfiles:

lensos-config list                              # every setting, its value and default
lensos-config set bar.style=island bar.size=large
lensos-config toggle notifications.dnd
lensos-config reset bar.right                   # back to the lensOS default

Your own config files stay yours: ~/.config/polybar/config.ini, ~/.config/kitty/kitty.conf, ~/.config/picom/picom.conf and the rest only pull in what Settings writes, so lines you add there still work.

Keyboard shortcuts

keys	what
`Super`	apps
`Super` + `Return`	terminal
`Super` + `E` / `W`	files / web browser
`Super` + `I` / `T`	Settings / themes
`Super` + `V`	clipboard history
`Super` + `.`	emoji
`Super` + `Shift` + `S`	screenshot of an area
`Print` / `Alt` + `Print`	screenshot of the screen / the window
`Super` + `←` `→`	snap to a half
`Super` + `Alt` + arrows	snap to a quarter
`Super` + `C`	centre the window
`Super` + `L` / `X`	lock / power menu