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.
| Key | Type | Default | Meaning |
|---|---|---|---|
wallpaper | s | '/usr/share/backgrounds/aurora/aurora-starfall-dawn.png' | Background image path |
wallpaper-dynamic | b | true | Dynamic background Use the Aurora landscape that follows the sun: dawn, day, dusk and night, from the series in wallpaper-dynamic-series. |
wallpaper-dynamic-series | s | 'starfall' | Which series of pictures the dynamic background follows the sun with One of starfall, veil, horizon. |
lock-background | s | 'desktop' | Lock screen background: the desktop's picture, the same blurred, or lock-picture One of desktop, blurred, picture. |
lock-picture | s | '' | The lock screen's own picture (lock-background "picture") |
lock-show-account | b | true | Show the account's name and picture on the lock screen |
wallpaper-slideshow | b | false | Rotate background pictures |
wallpaper-slideshow-minutes | i | 60 | Minutes between background pictures From 5 to 1440. |
wallpaper-slideshow-folder | s | '' | Folder of pictures for the slideshow Empty: the included wallpapers. |
wallpaper-slideshow-shuffle | b | false | Show the slideshow's pictures in random order |
update-active-hours-start | i | 8 | Start of active hours (no automatic restarts) From 0 to 23. |
update-active-hours-end | i | 23 | End of active hours From 0 to 23. |
update-auto-restart | b | false | Restart outside active hours when an update needs it |
update-restart-at | x | 0 | When a restart to finish updating is scheduled (Unix time; 0: none) |
screen-time | b | true | Count how long each app is used (kept on this computer) |
screen-time-limits | s | '{}' | Daily limits in minutes per app id, as JSON |
show-desktop-button | b | true | A Show Desktop button at the far end of the top bar |
hotspot-name | s | '' | Mobile hotspot network name (empty: the computer's name) |
hotspot-password | s | '' | Mobile hotspot password (made up the first time) |
screen-keyboard | b | false | Show the on-screen keyboard when the session starts |
screen-keyboard-theme | s | 'classic' | Look of the on-screen keyboard One of classic, light, accent, glass, comic, typewriter, neon, pixel, mechanical, candy. |
lock-keys-osd | b | true | Show Caps Lock and Num Lock on screen when they change |
record-sound | b | false | Screen recordings include the sound the computer plays |
dnd-schedule | b | false | Do Not Disturb on a schedule |
dnd-from | i | 22 | Scheduled Do Not Disturb starts at this hour From 0 to 23. |
dnd-to | i | 7 | Scheduled Do Not Disturb ends at this hour From 0 to 23. |
dnd-fullscreen | b | true | Do Not Disturb while an app is fullscreen (games, videos, presentations) |
dnd-sharing | b | true | Do Not Disturb while the screen is shared or recorded |
battery-saver-threshold | i | 20 | Turn on Battery Saver below this charge (percent; 0: never) From 0 to 50. |
downloads-cleanup-days | i | 0 | Move files left untouched in Downloads for this many days to the Trash 0: never. From 0 to 365. |
wallpaper-daily | s | '' | 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-recent | as | [] | Background pictures chosen lately, newest first |
color-scheme-auto | b | false | Switch between light and dark style at sunrise and sunset |
dock-favorites | as | ['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-format | s | '24h' | Clock format One of 24h, 12h. |
clock-show-seconds | b | false | Show seconds in the panel clock |
desktop-widgets | b | true | Show widgets on the desktop |
desktop-widget-list | s | '[{"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-monitor | b | false | Show processor and memory use in the top bar |
do-not-disturb | b | false | Hide notification popups |
night-light | b | false | Warm screen colors |
night-light-schedule | s | 'always' | When Night Light is on: sunset to sunrise, manual hours, or all the time One of sunset, manual, always. |
night-light-from | s | '20:00' | Night Light start time (manual schedule) |
night-light-to | s | '07:00' | Night Light end time (manual schedule) |
night-light-temperature | i | 4000 | Night light color temperature in Kelvin From 2500 to 6000. |
layout | s | 'aurora' | Desktop layout preset One of aurora, classic, studio, minimal, custom. |
panel-position | s | 'top' | Where the top bar sits One of top, bottom. |
panel-opacity | d | 0.78 | Top bar opacity From 0.3 to 1.0. |
clock-position | s | 'right' | Where the clock is shown in the top bar One of center, right. |
desktop-icons | b | true | Show the files in the Desktop folder on the background |
desktop-icons-position | s | 'left' | Which side of the screen desktop icons start from One of left, right. |
dock-position | s | 'bottom' | Dock position One of bottom, left, right, hidden. |
dock-style | s | 'floating' | Floating dock, or a full-width taskbar One of floating, panel. |
dock-icon-size | i | 48 | Dock icon size in pixels From 24 to 80. |
dock-magnification | b | true | Magnify dock icons under the pointer |
dock-autohide | b | false | Hide the dock until the pointer reaches the screen edge |
dock-show-trash | b | true | Show the Trash at the end of the dock |
window-buttons | s | 'left' | Side of the title bar with the window buttons One of left, right. |
window-button-style | s | 'traffic' | Colored round buttons, or monochrome icons One of traffic, symbolic. |
window-corner-radius | i | 12 | Window corner radius From 0 to 18. |
window-gaps | i | 6 | Gap between snapped windows and screen edges From 0 to 24. |
launcher-style | s | 'spotlight' | What the Super key opens: a search bar or the full app grid One of spotlight, grid. |
hot-corner-top-left | s | 'none' | Hot corner action (top left) One of none, overview, launchpad, desktop, quick-settings, notifications, lock, screen-off. |
hot-corner-top-right | s | 'none' | Hot corner action (top right) One of none, overview, launchpad, desktop, quick-settings, notifications, lock, screen-off. |
hot-corner-bottom-left | s | 'overview' | Hot corner action (bottom left) One of none, overview, launchpad, desktop, quick-settings, notifications, lock, screen-off. |
hot-corner-bottom-right | s | 'desktop' | Hot corner action (bottom right) One of none, overview, launchpad, desktop, quick-settings, notifications, lock, screen-off. |
weather-widget | b | true | Show the weather next to the calendar (Open-Meteo, approximate location) |
session-sounds | b | true | Play the Aurora sounds when you log in and when you shut down, restart or log out |
clipboard-history | b | true | Remember copied text for Spotlight (Super+V) |
ai-enabled | b | false | Aurora AI (nothing is downloaded until this is on) |
ai-provider | s | 'local' | Where answers come from: this computer, Anthropic Claude, or an OpenAI-compatible API One of local, anthropic, openai. |
ai-model | s | 'qwen3-1.7b' | Local chat model (an id from the AI catalog) |
ai-anthropic-model | s | 'claude-sonnet-5' | Claude model used with the Anthropic provider |
ai-openai-url | s | 'https://api.openai.com/v1' | Base URL of the OpenAI-compatible API |
ai-openai-model | s | '' | Model name for the OpenAI-compatible API |
ai-panel-button | b | true | Show the Aurora Assistant button in the top bar |
ai-language | s | '' | Language of the answers: empty = the language you write in; or a code like "it" |
ai-dictation-language | s | '' | Dictation language: empty = detect automatically; or a code like "it" |
ai-voice | s | '' | Read-aloud voice (a locale from the AI catalog, like "it_IT"); empty = the system language |
ai-spotlight | b | true | Ask the assistant from Spotlight with a question mark |
ai-terminal | b | true | The ask and why commands in the terminal |
ai-dictation | b | false | Dictation with Super+H (speech recognition on this computer) |
ai-whisper-model | s | 'small' | Speech recognition model One of base, small. |
ai-read-aloud | b | false | Read the selected text aloud with Super+Shift+R |
ai-semantic-search | b | false | Find documents by meaning in Spotlight |
ai-index-folders | as | ['~/Documents', '~/Desktop', '~/Downloads'] | Folders indexed for search by meaning |
screen-sharing | b | false | Share this screen over VNC (wayvnc, password protected) |
gestures | b | true | Touchpad gestures (three and four fingers) |
ai-writing-tools | b | true | Writing tools for the selected text (Super+Shift+W) |
ai-files | b | true | Summarize and ask about files from the Files app |
ai-screenshots | b | true | "Ask Aurora" on screenshots |
ai-notifications | b | true | Summarize notifications in the notification center |
idle-dim-minutes | i | 5 | Minutes of inactivity before the screen turns off (0 = never) From 0 to 120. |
idle-lock | b | true | Lock the screen when it turns off |
suspend-battery-minutes | i | 20 | Minutes of inactivity on battery before the computer suspends (0 = never) From 0 to 240. |
suspend-ac-minutes | i | 0 | Minutes of inactivity when plugged in before the computer suspends (0 = never) From 0 to 240. |
show-battery-percentage | b | true | Show the battery percentage in the top bar |
notifications-muted-apps | as | [] | Apps whose notifications are not shown |
notifications-seen-apps | as | [] | Apps that have sent notifications, listed in Settings |
removable-media-action | s | 'notify' | What to do when a drive is connected One of notify, open, nothing. |
window-animations | b | true | Animate windows as they open and items as folders fill |
volume-overamplify | b | false | Allow raising the volume above 100% |
search-disabled | as | [] | 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.