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.
| 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 |
shell-blur | b | false | Blur 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-density | s | '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-transparency | b | false | Make 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-tint | b | false | Tint 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-wallpaper | b | false | Take 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-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 | '[]' | Desktop widgets and their positions (JSON; x, y as fractions of the screen). None at first: you add them with Edit Widgets… |
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. |
panel-style | s | 'bar' | Top bar: floating islands of frosted glass, or one bar edge to edge One of floating, bar. |
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' | 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-size | i | 48 | Dock icon size in pixels From 24 to 80. |
dock-magnification | b | true | Magnify dock icons under the pointer |
dock-hide | s | '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-apps | b | true | Show 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-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 | 14 | Window corner radius From 0 to 18. |
screen-corner-radius | i | 14 | Rounded 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-animation | s | '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-layout | s | '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-folders | s | '[]' | 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-style | s | '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-previews | b | true | Show 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-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.