PHOSH.GSETTINGS(5)

📦
version 0.58.0 · 4 versions
, in arch rolling, nixpkgs unstable, ubuntu stonking

💖 NAME 💖

phosh.gsettings — the GSettings that phosh uses, no cap. this is the phosh.gsettings(5) page bestie, pull up a chair 🫶

🌸 DESCRIPTION 🌸

okay so real talk: phosh keeps pretty much all of its configuration in gsettings. you can change any of it with the gsettings(1) command, and that's also how you get the details on an option. wanna know what something actually means? hit it with gsettings describe, like this:

gsettings describe mobi.phosh.shell.cell-broadcast enabled

and these are the gsettings schemas and keys it's using right now 👇

🎀 GSettings 🎀

these gsettings are the ones phosh uses:

  • mobi.phosh.shell.brightness
    • auto-brightness-offset — the offset that gets added on top of the auto brightness value that was calculated for you ✨
  • mobi.phosh.shell.cell-broadcast
    • enabled — whether receiving cell broadcasts is enabled
  • sm.puri.phosh
    • app-filter-mode — application filtering in the overview. and showing all the applications is this:
gsettings set sm.puri.phosh app-filter-mode '[]'
  • automatic-high-contrast-threshold — the brightness threshold that triggers automatic high contrast
  • automatic-high-contrast — whether automatic high contrast is enabled
  • enable-suspend — whether suspend is enabled in the system menu
  • favorites — list of favorite applications
  • force-adaptive — list of app-id's that phosh considers adaptive (so they're always shown):
gsettings set sm.puri.phosh force-adaptive "['chromium.desktop', 'firefox-esr.desktop']"
  • osk-unfold-delay — how long you have to press the bottom bar pill for the OSK to unfold
  • quick-silent — silence the device by pressing Vol- on incoming calls
  • shell-layout — how to lay out the shell UI elements around cutouts and notches. device: automatic, based on device settings; none: no automatic layout.
  • wwan-backend — the WWan backend to use
  • sm.puri.phosh.emergency-calls
    • enabled — whether emergency calls are enabled. this one is experimental! please check whether it actually works for your provider / in your country / for your sim card before you start relying on it, bestie 😭
  • sm.puri.phosh.lockscreen
    • require-unlock — whether unlocking via password/pin is required
    • shuffle-keypad — shuffle the keys on the keypad
  • sm.puri.phosh.plugins
    • lockscreen — the enabled lock screen plugins
    • quick-settings — the enabled custom quick settings
  • sm.puri.phosh.notifications
    • wakeup-screen-categories — the notification categories that trigger a screen wakeup
    • wakeup-screen-triggers — which properties of a notification trigger a screen wake-up
    • wakeup-screen-urgency — the lowest urgency that triggers a screen wake-up (when it's coming in via wakeup-screen-triggers)
  • sm.puri.phosh.plugins.launcher-box
    • folder — the folder holding the desktop files to show in the launcher box
  • sm.puri.phosh.plugins.ticket-box
    • folder — the folder holding the tickets to be presented on the lock screen.
  • sm.puri.phosh.plugins.upcoming-events
    • days — number of days to show in the upcoming events list
  • org.gnome.desktop.app-folders.folder — folder support
  • org.gnome.desktop.background — background wallpaper
    • picture-uri
    • picture-uri-dark
    • primary-color — e.g. to get the "classic" black overview back, use:
gsettings set org.gnome.desktop.background picture-options none
gsettings set org.gnome.desktop.background primary-color '#000000'
  • org.gnome.desktop.interface1
    • show-battery-percentage
  • org.gnome.desktop.media-handling
    • automount
  • org.gnome.desktop.notifications
    • show-banners — whether to show notification banners
    • show-in-lockscreen — whether notifications should be shown on the lock screen
  • org.gnome.desktop.peripherals.touchscreen — touch screen to output mappings. example for the NexDock 360:
gsettings set org.gnome.desktop.peripherals.touchscreen:/org/gnome/desktop/peripherals/touchscreens/27c0:0819/ output "\['Unknown', 'NexDock', '8R33926O00Q'\]"
  • org.gnome.desktop.screensaver
    • lock-delay
    • lock-enabled
    • picture-uri — lockscreen background image / wallpaper
    • picture-options — none disables the lockscreen image
  • org.gnome.shell.keybindings
    • toggle-message-tray
    • toggle-overview

👀 See also 👀

phosh(1) phoc.gsettings(5) gsettings(1) — go read those too, they're iconic 💅

and that's the whole vibe check, bestie 🦋 this page signs off as phosh.gsettings() at the very bottom, so you know it's the real one. now go <rainbow>gsettings set</rainbow> something responsibly ✨💖

📦 where this page comes from