PHOC-OUTPUTS-STATES(1)

📦
version 0.58.0 · 3 versions
, in arch rolling, ubuntu stonking

💖 phoc-outputs-states 💖

okay bestie, pull up a chair because today we're snooping on phoc-outputs-states — the little tool from the phoc manual fam that lets you peek at phoc's saved outputs states. yes, that's the whole name, no notes. 🎀

✨ SYNOPSIS ✨

phoc-outputs-states [OPTIONS...]

🌸 DESCRIPTION 🌸

so here's the tea: phoc-outputs-states is a tool that lists the saved outputs states that phoc knows about. it's not out here inventing anything, it's just showing you what's already been tucked away. 💅

these states get updated by phoc whenever the output configuration changes, and then phoc applies them whenever it detects that specific set of outputs. so basically phoc is out here remembering your setup so it can bring it back the second it recognizes your monitors. main character behavior, honestly. 👑

⚠️ but listen — output configuration in phoc.ini always takes precedence over saved outputs states. no cap. the ini file wins, every single time, no matter what the saved states are saying. 🫶

🦋 OPTIONS 🦋

  • -h, --help — print the help and dip out. that's it, that's the whole vibe. ✨
  • -d, --db FILENAME — path to the saved outputs states database file. if you leave this out, phoc's own built in default gets used instead. easy peasy. 🎀
  • -r, --raw — spit out raw output, which is highkey useful when you're processing the output in scripts. machine-readable mode, activated. 🤖
  • --list — list the identifiers of the outputs states sitting in the database. the returned identifiers are based on wlroots output descriptions. 🗂️
  • -show=IDENTIFIER — show the saved output state details for the given IDENTIFIER. (yes, single dash, one -, that's not a typo, don't come for me 😭)

🌈 EXAMPLES 🌈

get the current list of identifiers

$ phoc-outputs-states --list
Identifiers
-----------
…
'(null) (null) (DSI-1)'
…

get the details for the identifier (null) (null) (DSI-1)

$ phoc-outputs-states --show '(null) (null) (DSI-1)'
(null) (null) (DSI-1)
---------------------
  Enabled: yes
     Mode: 1080x2340@60000000.00
    Scale: 2.500000
Transform: normal

look at that formatting. aligned. crisp. ate and left no crumbs. 🔥

👀 SEE ALSO 👀

and that's the whole page, bestie!! this was phoc-outputs-states, living in the phoc-outputs-states() manual, and the footer said phoc-outputs-states() too because apparently it loves its own name that much 💜 go forth and inspect those saved states, you iconic lil sysadmin 🧚✨

📦 where this page comes from