PHOSH(1)

✨ NAME ✨

okay so bestie, meet phosh — a whole phone shell, and yes it's the one that's literally the manual page PHOSH(1) 💅

---

🌸 SYNOPSIS 🌸

phosh [OPTIONS...]

---

🦋 DESCRIPTION 🦋

phosh is a Wayland shell for mobile devices that runs on GNOME technologies. That's the whole vibe. It's a phone shell. On Wayland. GNOME flavored. Obsessed. 💖

---

🎀 OPTIONS 🎀

• -h, --help — prints the help and then dips out. print help, exit, slay.
• -U, --unlocked — do not start with the screen locked. we're going in unlocked, no cap 🔓
• -L, --locked — start with the screen locked no matter what. she said LOCKED and she meant it 🔒
• --version — shows the version info. like, which phosh are we even running, bestie ⭐

---

💜 CONFIGURATION 💜

phosh gets configured through GSettings — go look at phosh-config(5) for that whole situation.

🧚 Plugins

Plugins are configured via the mobi.phosh.plugins and sm.puri.phosh.plugins gsettings schema. The lock-screen key turns the plugins on for the lock screen, like this:

gsettings set  sm.puri.phosh.plugins lock-screen "['ticket-box', 'upcoming-events']"

(yes, two spaces after set, that's just how it's written, copy it exactly, don't come for me 🙈)

---

🌈 DBUS INTERFACE 🌈

phosh will let you flip certain debug flags on and off at runtime over DBus. to see the full list of available flags, run:

busctl --user introspect mobi.phosh.Shell.DebugControl /mobi/phosh/Shell/DebugControl mobi.phosh.Shell.DebugControl

and to toggle individual values:

busctl --user set-property mobi.phosh.Shell.DebugControl /mobi/phosh/Shell/DebugControl mobi.phosh.Shell.DebugControl LogDomains as 2 phosh-shell phosh-brightness-manager

⚠️ heads up bestie — these flags are not considered stable API, so they can change between releases. don't build your whole personality on them. 💀

---

🍓 ENVIRONMENT VARIABLES 🍓

phosh honors the following environment variables, purely for debugging purposes:

• PHOSH_DEBUG — a comma separated list of flags:
  • always-splash — always use the splash screen when starting apps, even when you're in docked mode.
  • app-activation — use a longer timeout before force-closing the app splash. turn this flag on to help debug activation issues.
  • backlight-non-linear — assume that backlight brightness changes non-linearly. set this if the kernel should be reporting the backlight as non-linear but isn't doing that.
  • fake-builtin — fake a builtin screen when you're using a virtual output, like in a nested Wayland session.
  • thumbnail-overlay — use an animated transition between the overlay and the running app. this one will default to on in future releases. 👀
• PHOSH_FAKE_CLOCK — allowed values are ISO8601 formatted strings or now. setting this variable sets the shell's clocs to the given fixed value. for the clock format, see g_date_time_new_from_iso8601().
• G_MESSAGES_DEBUG, G_DEBUG and other environment variables supported by glib. <https://docs.gtk.org/glib/running.html>
• GTK_DEBUG and other environment variables supported by GTK, see <https://docs.gtk.org/gtk3/running.html>

---

👑 SEE ALSO 👑

gsettings(1) phosh-session(1) phosh.gsettings(5)

---

and that's the whole page, bestie 🫶 go read those other manpages too, they're giving main character energy. no version stamp on this one, no date either — the footer is just a lil lonely phosh() sitting there all by itself, cute, iconic, periodt. 🎀✨