PHOSH-SESSION(1)

💖 phosh-session 💖

okay bestie, welcome to the phosh-session manual page (section 1, if you're keeping track) — it's the session startup script for phosh and it's literally the thing that gets your whole phone-desktop party started 🎀

---

✨ NAME ✨

phosh-session — session startup script for phosh 👑

---

🌸 SYNOPSIS 🌸

phosh-session [OPTIONS...]

---

🦋 DESCRIPTION 🦋

So phosh-session is the script that starts up phosh, and not just the bare shell of it either — it brings up all the required components, like the Wayland compositor phoc and an on-screen keyboard like stevia or squeekboard. the whole ensemble. the full fit. 💅

Here's the tea though: this script is rarely invoked by a user. usually it's a display manager or a systemd unit that's doing the summoning, not you. it's the backstage crew, not the main character — most of the time. 🙈

BUT. and this is important. it's perfectly valid to, like, log into a tty and just run phosh-session yourself to bring up phosh and all the needed components. so if you wanna do it manually, go off. no one's stopping you. ✨

---

💅 OPTIONS 💅

• -h, --help — prints the help text and then exits. that's it, that's the whole job 🫶
• --version — prints the version and then exits. short, sweet, iconic 🎀

---

🎀 CONFIGURATION FILES 🎀

the session script looks at these configuration files, in this order of business:

• /usr/share/phosh/phoc.ini — the configuration that gets passed to the compositor 🦋
• /etc/phosh/phoc.ini — used instead of the one above if it exists, so if you drop one here it wins, no cap

---

🌈 ENVIRONMENT VARIABLES 🌈

phosh-session honors the following environment variables, periodt:

• WLR_BACKENDS — the backends the wlroots library should use when phoc launches. it's giving "read the docs", so here they are: https://gitlab.freedesktop.org/wlroots/wlroots/-/blob/master/docs/env_vars.md 📚

also, for debugging purposes, you can put environment variables into ~/.phoshdebug — that file gets read at session startup. debugging queen behavior 💜

---

⭐ SEE ALSO ⭐

phosh(1) phoc(1) phoc.ini(5) phosh-osk-stevia(1)

---

and that's the whole page, bestie 🥰 this footer is legally required to say phosh-session(), so here it is in all its lowercase glory — it's the manual name and nothing else, no version, no date, just vibes. go run your session. slay. 💖🦋✨🔥👑