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 (116 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
shell-blurbfalseBlur the picture behind the top bar, the dock and Spotlight
Real frosted glass, drawn by the compositor (Wayfire's blur plugin). Needs a graphics card and the Aurora session: it does nothing in the compatibility session, and on software rendering — a virtual machine — it is either slow or has no effect at all, which is why it starts off.
interface-densitys'comfortable'How much room the desktop's own furniture takes
compact: a shorter top bar and tighter menus, Control Center, notifications and dock, for small screens or for fitting more on one.
One of comfortable, compact.
reduce-transparencybfalseMake the desktop's glass solid
The top bar, the dock, Spotlight, Launchpad, the Control Center, notifications and the desktop widgets stop letting the wallpaper through, for legibility (Settings → Accessibility → Seeing).
chrome-tintbfalseTint the top bar and the dock with the accent color
Their dark glass takes the accent instead of being neutral; with the accent itself taken from the background, the chrome follows the picture behind it.
accent-from-wallpaperbfalseTake the accent color from the background picture
The most vivid color of the picture on screen becomes the accent, instead of one of the nine fixed ones; it follows the background through the day.
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'[]'Desktop widgets and their positions (JSON; x, y as fractions of the screen). None at first: you add them with Edit Widgets…
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.
panel-styles'bar'Top bar: floating islands of frosted glass, or one bar edge to edge
One of floating, bar.
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'One floating shelf, islands of frosted glass, or a full-width taskbar
Islands split the dock the way the top bar's floating style splits it: Launchpad, the apps and the Trash each get their own pill of glass.
One of floating, islands, panel.
dock-icon-sizei48Dock icon size in pixels
From 24 to 80.
dock-magnificationbtrueMagnify dock icons under the pointer
dock-hides'windows'When the dock gets out of the way
never: it always keeps its strip of screen, and windows stop above it. windows: it slides away while a window is using the whole screen, and comes back when the pointer reaches the edge — so a maximized window has the whole screen and no band of empty desktop is left around the dock. always: it stays hidden until the pointer reaches the edge.
One of never, windows, always.
dock-running-appsbtrueShow apps that are open but not pinned to the dock
Off: the dock holds only what you pinned, and the top bar's window buttons are the only list of what is open.
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-radiusi14Window corner radius
From 0 to 18.
screen-corner-radiusi14Rounded corners of the screen itself, in pixels (0: square)
Four small surfaces paint the corners of every monitor black outside a quarter circle, the way a modern screen is shaped. They take no pointer input.
From 0 to 24.
wallpaper-animations'auto'What moves in the background picture
Auto chooses moving light to suit each included scene: aurora, stars, water reflections, clouds, nebula glow, sun rays or ring glints. Unknown pictures stay still in Auto. Individual effects can also be selected. Zoom is a ninety-second drift into the picture and back. Animation pauses while a maximized or fullscreen window covers the desktop or the computer is saving power. Off leaves the picture still.
One of off, auto, zoom, aurora, stars, clouds, shimmer.
launchpad-layouts'pages'How Launchpad lays out the apps
Pages: every app on pages you move through sideways, with folders you make by dropping one app on another. Sections: one list, grouped by what the apps are for, which was how Launchpad always looked.
One of pages, sections.
launchpad-folderss'[]'Launchpad's folders
The folders made in Launchpad, as JSON: a name and the desktop ids inside it. An app that is uninstalled is remembered here, so reinstalling it puts it back in its folder.
icon-styles'galaxy'How Aurora's app icons are drawn
Galaxy: a deep sky with a lit core and fixed stars. Ribbon: an aurora sweeping the bottom of a dark plate. Glass: dark glass with the colour lit inside it. Clay: bright, solid and plainest to read. Bolt: an electric discharge crawling in from a corner. Each is a whole icon theme.
One of galaxy, ribbon, glass, clay, bolt.
window-previewsbtrueShow a picture of each window in the overview, the dock and Snap Assist
A picture of a window is a crop of the screen, taken while that window was in front; it needs the Aurora session, which can say where each window is. Off: the cards show the app's icon.
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.