LSDISPLAY(1)

📦 version 0.2.1, in ubuntu stonking

💖 LSDISPLAY(1) — the display list bestie 💖

okay so first things first: this is the manual page for lsdisplay, living in section 1 (User Commands) of the manual. yes she's in the big girl section. periodt. 👑

✨ NAME ✨

lsdisplay — list connected displays with details and layout diagram 🖥️🦋

🌸 SYNOPSIS 🌸

lsdisplay [OPTIONS]

that's it. that's the whole synopsis. no positional args, no drama, just vibes and options. 💅

💜 DESCRIPTION 💜

So basically, lsdisplay lists all your connected displays/monitors and tells you literally everything about them: manufacturer, model, serial number, resolution, position, rotation, and connector type. like a full-on glow-up reveal for your hardware, no cap. ✨

And THEN — because she's extra in the best way — she also renders an ASCII art diagram showing the physical layout of your displays. visual representation?? we love to see it. 🎀

Where does all this tea come from, you ask? Display identification is done by parsing EDID data straight out of /sys/class/drm/*/edid. Meanwhile, resolution and positioning info comes from xrandr(1), with a fallback to kscreen-doctor(1) or wlr-randr(1) when you're running a Wayland session. she's adaptable, she's flexible, she's everything. 🌈

Think of her as the display-world equivalent of lscpu(1), lsusb(8), and lspci(8) — same energy, same family, but for display devices specifically. iykyk. 👑

🔥 OPTIONS 🔥

  • --json — dump all the display info as JSON. perfect for piping into jq and being a menace with data. 💀
  • --short, -s — compact output, one single line per display. short and sweet, she ate. 🍓
  • --no-layout — skips the ASCII art layout diagram. (sad, honestly, but valid if you're in a hurry.)
  • --version, -V — shows the version number and peaces out. ✌️
  • --help, -h — shows the help message and exits. the classic "help me bestie" move. 🫶

🌟 OUTPUT 🌟

By default you get two sections, okay? two. that's the default vibe.

CONNECTED DISPLAYS

A whole table, bestie. Each display gets listed with: output name, resolution, position, diagonal size, manufacturer, model, connector type, serial number, rotation, and the primary flag. all the stats. all the lore. 📊✨

LAYOUT

An ASCII art diagram showing the relative positions and sizes of all your displays, with correct proportions. yes, correct proportions — she's not playing around, the geometry is real. 📐💖

🦋 EXAMPLES 🦋

lsdisplay
lsdisplay --json
lsdisplay -s
lsdisplay --json | jq '.[].manufacturer'

look at that last one. piping into jq to grab just the manufacturers? that's main character energy fr fr. 🔥

🎀 FILES 🎀

  • /sys/class/drm/card*/edid — the EDID binary data for each display output. this is where she reads the identity tea from. ☕
  • /sys/class/drm/card*-*/status — the connection status for each output port. plugged in or not, she'll know. 🔌

💜 SEE ALSO 💜

xrandr(1), kscreen-doctor(1), lsgpu(1), lspci(8), lsusb(8), lscpu(1), edid-decode(1)

the whole friend group honestly. go say hi. 👯‍♀️

💀 BUGS 💀

Found a bug?? 😭 Report it at https://github.com/AGuyMarc/lsdisplay/issues — please and thank you, she wants to be better. 🫶

👑 AUTHOR 👑

Guy-Marc APRIN <2026@gm.casa>

NB: the contact email rotates yearly — so it's 2027@gm.casa in 2027, etc. year-by-year glow up on the inbox, we respect it. 💌

🌸 LICENSE 🌸

GPL-2.0. See LICENSE for the full text. read it, love it, respect it bestie. 📜

lowkey iconic, highkey useful. she's giving lscpu but make it displays. 💅✨

this whole page is lsdisplay 0.2.1, brought to you May 2026 🎀 — mwah, go list some displays. 💖🦋🌸💜

📦 where this page comes from