Aurora OS Documentation latest

Documentation › Reference

GSettings keys

Every Aurora setting key, its type, default and meaning, generated from the schema

All in the schema org.aurora.desktop (103 keys). Read one with gsettings get org.aurora.desktop KEY, change it with gsettings set org.aurora.desktop KEY VALUE, and go back to the default with gsettings reset org.aurora.desktop KEY.

KeyTypeDefaultMeaning
wallpapers'/usr/share/backgrounds/aurora/aurora-starfall-dawn.png'Background image path
wallpaper-dynamicbtrueDynamic background
Use the Aurora landscape that follows the sun: dawn, day, dusk and night, from the series in wallpaper-dynamic-series.
wallpaper-dynamic-seriess'starfall'Which series of pictures the dynamic background follows the sun with
One of starfall, veil, horizon.
lock-backgrounds'desktop'Lock screen background: the desktop's picture, the same blurred, or lock-picture
One of desktop, blurred, picture.
lock-pictures''The lock screen's own picture (lock-background "picture")
lock-show-accountbtrueShow the account's name and picture on the lock screen
wallpaper-slideshowbfalseRotate background pictures
wallpaper-slideshow-minutesi60Minutes between background pictures
From 5 to 1440.
wallpaper-slideshow-folders''Folder of pictures for the slideshow
Empty: the included wallpapers.
wallpaper-slideshow-shufflebfalseShow the slideshow's pictures in random order
update-active-hours-starti8Start of active hours (no automatic restarts)
From 0 to 23.
update-active-hours-endi23End of active hours
From 0 to 23.
update-auto-restartbfalseRestart outside active hours when an update needs it
update-restart-atx0When a restart to finish updating is scheduled (Unix time; 0: none)
screen-timebtrueCount how long each app is used (kept on this computer)
screen-time-limitss'{}'Daily limits in minutes per app id, as JSON
show-desktop-buttonbtrueA Show Desktop button at the far end of the top bar
hotspot-names''Mobile hotspot network name (empty: the computer's name)
hotspot-passwords''Mobile hotspot password (made up the first time)
screen-keyboardbfalseShow the on-screen keyboard when the session starts
screen-keyboard-themes'classic'Look of the on-screen keyboard
One of classic, light, accent, glass, comic, typewriter, neon, pixel, mechanical, candy.
lock-keys-osdbtrueShow Caps Lock and Num Lock on screen when they change
record-soundbfalseScreen recordings include the sound the computer plays
dnd-schedulebfalseDo Not Disturb on a schedule
dnd-fromi22Scheduled Do Not Disturb starts at this hour
From 0 to 23.
dnd-toi7Scheduled Do Not Disturb ends at this hour
From 0 to 23.
dnd-fullscreenbtrueDo Not Disturb while an app is fullscreen (games, videos, presentations)
dnd-sharingbtrueDo Not Disturb while the screen is shared or recorded
battery-saver-thresholdi20Turn on Battery Saver below this charge (percent; 0: never)
From 0 to 50.
downloads-cleanup-daysi0Move files left untouched in Downloads for this many days to the Trash
0: never.
From 0 to 365.
wallpaper-dailys''Picture of the day source
A new background every day from Bing, NASA or Wikimedia Commons; empty: off.
One of (empty), bing, nasa, wikimedia.
wallpaper-recentas[]Background pictures chosen lately, newest first
color-scheme-autobfalseSwitch between light and dark style at sunrise and sunset
dock-favoritesas['firefox-esr.desktop', 'org.aurora.Files.desktop', 'org.gnome.Ptyxis.desktop', 'org.gnome.TextEditor.desktop', 'org.aurora.Assistant.desktop', 'org.aurora.Settings.desktop']Applications pinned to the dock
clock-formats'24h'Clock format
One of 24h, 12h.
clock-show-secondsbfalseShow seconds in the panel clock
desktop-widgetsbtrueShow widgets on the desktop
desktop-widget-lists'[{"kind": "clock", "x": 0.86, "y": 0.06}, {"kind": "calendar", "x": 0.86, "y": 0.3}, {"kind": "weather", "x": 0.86, "y": 0.54}]'Desktop widgets and their positions (JSON; x, y as fractions of the screen)
panel-system-monitorbfalseShow processor and memory use in the top bar
do-not-disturbbfalseHide notification popups
night-lightbfalseWarm screen colors
night-light-schedules'always'When Night Light is on: sunset to sunrise, manual hours, or all the time
One of sunset, manual, always.
night-light-froms'20:00'Night Light start time (manual schedule)
night-light-tos'07:00'Night Light end time (manual schedule)
night-light-temperaturei4000Night light color temperature in Kelvin
From 2500 to 6000.
layouts'aurora'Desktop layout preset
One of aurora, classic, studio, minimal, custom.
panel-positions'top'Where the top bar sits
One of top, bottom.
panel-opacityd0.78Top bar opacity
From 0.3 to 1.0.
clock-positions'right'Where the clock is shown in the top bar
One of center, right.
desktop-iconsbtrueShow the files in the Desktop folder on the background
desktop-icons-positions'left'Which side of the screen desktop icons start from
One of left, right.
dock-positions'bottom'Dock position
One of bottom, left, right, hidden.
dock-styles'floating'Floating dock, or a full-width taskbar
One of floating, panel.
dock-icon-sizei48Dock icon size in pixels
From 24 to 80.
dock-magnificationbtrueMagnify dock icons under the pointer
dock-autohidebfalseHide the dock until the pointer reaches the screen edge
dock-show-trashbtrueShow the Trash at the end of the dock
window-buttonss'left'Side of the title bar with the window buttons
One of left, right.
window-button-styles'traffic'Colored round buttons, or monochrome icons
One of traffic, symbolic.
window-corner-radiusi12Window corner radius
From 0 to 18.
window-gapsi6Gap between snapped windows and screen edges
From 0 to 24.
launcher-styles'spotlight'What the Super key opens: a search bar or the full app grid
One of spotlight, grid.
hot-corner-top-lefts'none'Hot corner action (top left)
One of none, overview, launchpad, desktop, quick-settings, notifications, lock, screen-off.
hot-corner-top-rights'none'Hot corner action (top right)
One of none, overview, launchpad, desktop, quick-settings, notifications, lock, screen-off.
hot-corner-bottom-lefts'overview'Hot corner action (bottom left)
One of none, overview, launchpad, desktop, quick-settings, notifications, lock, screen-off.
hot-corner-bottom-rights'desktop'Hot corner action (bottom right)
One of none, overview, launchpad, desktop, quick-settings, notifications, lock, screen-off.
weather-widgetbtrueShow the weather next to the calendar (Open-Meteo, approximate location)
session-soundsbtruePlay the Aurora sounds when you log in and when you shut down, restart or log out
clipboard-historybtrueRemember copied text for Spotlight (Super+V)
ai-enabledbfalseAurora AI (nothing is downloaded until this is on)
ai-providers'local'Where answers come from: this computer, Anthropic Claude, or an OpenAI-compatible API
One of local, anthropic, openai.
ai-models'qwen3-1.7b'Local chat model (an id from the AI catalog)
ai-anthropic-models'claude-sonnet-5'Claude model used with the Anthropic provider
ai-openai-urls'https://api.openai.com/v1'Base URL of the OpenAI-compatible API
ai-openai-models''Model name for the OpenAI-compatible API
ai-panel-buttonbtrueShow the Aurora Assistant button in the top bar
ai-languages''Language of the answers: empty = the language you write in; or a code like "it"
ai-dictation-languages''Dictation language: empty = detect automatically; or a code like "it"
ai-voices''Read-aloud voice (a locale from the AI catalog, like "it_IT"); empty = the system language
ai-spotlightbtrueAsk the assistant from Spotlight with a question mark
ai-terminalbtrueThe ask and why commands in the terminal
ai-dictationbfalseDictation with Super+H (speech recognition on this computer)
ai-whisper-models'small'Speech recognition model
One of base, small.
ai-read-aloudbfalseRead the selected text aloud with Super+Shift+R
ai-semantic-searchbfalseFind documents by meaning in Spotlight
ai-index-foldersas['~/Documents', '~/Desktop', '~/Downloads']Folders indexed for search by meaning
screen-sharingbfalseShare this screen over VNC (wayvnc, password protected)
gesturesbtrueTouchpad gestures (three and four fingers)
ai-writing-toolsbtrueWriting tools for the selected text (Super+Shift+W)
ai-filesbtrueSummarize and ask about files from the Files app
ai-screenshotsbtrue"Ask Aurora" on screenshots
ai-notificationsbtrueSummarize notifications in the notification center
idle-dim-minutesi5Minutes of inactivity before the screen turns off (0 = never)
From 0 to 120.
idle-lockbtrueLock the screen when it turns off
suspend-battery-minutesi20Minutes of inactivity on battery before the computer suspends (0 = never)
From 0 to 240.
suspend-ac-minutesi0Minutes of inactivity when plugged in before the computer suspends (0 = never)
From 0 to 240.
show-battery-percentagebtrueShow the battery percentage in the top bar
notifications-muted-appsas[]Apps whose notifications are not shown
notifications-seen-appsas[]Apps that have sent notifications, listed in Settings
removable-media-actions'notify'What to do when a drive is connected
One of notify, open, nothing.
window-animationsbtrueAnimate windows as they open and items as folders fill
volume-overamplifybfalseAllow raising the volume above 100%
search-disabledas[]Spotlight result categories that are turned off

Aurora also uses the standard GNOME keys, for example org.gnome.desktop.interface color-scheme and accent-color, org.gnome.desktop.privacy remove-old-trash-files and old-files-age.