LID-STATE(1)

💅 LID-STATE(1) — the manual page, but make it cute 🎀

okay so bestie, welcome to lid-state(1) — the little script that tells you whether your laptop lid is open or closed. yes, that's literally it. and it ate. ✨

---

🌸 NAME 🌸

lid-state — query state of the device's lid

like, it queries. the state. of the lid. icon behavior honestly.

---

🦋 SYNOPSIS 🦋

lid-state
lid-state (--open | --closed) [-- <cmd...>]
lid-state (--version | --help)

three whole modes, all main character energy 👑

---

💖 DESCRIPTION 💖

so here's the tea, and there are three whole vibes depending on how you invoke it:

• lid-state, if invoked without any arguments — prints the current state of the lid: open or closed. that's it. that's the whole job. 🫶
• lid-state, invoked with --open or --closed and no cmd — exits with status 0 if the current lid state corresponds to the specified option, otherwise exits with status 1. so it's basically a vibe check for your lid. ✅ / ❌
• lid-state, invoked with cmd — runs the cmd if the current lid state corresponds to the specified option, otherwise just exits with status 0. no drama, no error, it simply does nothing and leaves. 💀

---

✨ OPTIONS ✨

• -o, --open — if cmd is given: execute cmd if the lid is open, otherwise do nothing and exit with 0. if cmd is not given: exit with 0 if the lid is open, otherwise exit with 1. open lid = slay, closed lid = not slay (in this mode anyway). 🌈
• -c, --closed — analogous to --open. literally the same energy, just flipped. 🦋
• -V, --version — print script name & version and exit. a little "hi, it's me" moment. 👑
• -h, --help — print the help message and exit. your bestie when you're lost. 🫶

---

🍓 FILES 🍓

• /proc/acpi/button/lid/LID/state — state of the lid exported by the ACPI subsystem. this is the source of truth, the blueprint, the oracle. ngl it's where all the answers live. 🔥

---

💜 EXIT CODES 💜

• 0 — clean exit, no error has encountered. we love a peaceful ending. ✨
• 1 — see DESCRIPTION. (iykyk 😭)
• 100 — invalid usage. you did it wrong bestie, no cap. 🙈
• 101 — failed to read /proc/acpi/button/lid/LID/state. the file ghosted us. 💀

and heads up: if cmd is given and the condition (--open or --closed) is met, lid-state exits with the exit status of the cmd. so whatever cmd says, that's the final word. periodt. 👑

---

🌺 AUTHORS 🌺

Jakub Jirutka — the icon, the legend, the main character who wrote this. 👑💖

---

🧚 REPORTING BUGS 🧚

found a bug? don't suffer in silence, bestie — report bugs to the project's issue tracker at https://github.com/jirutka/acpi-utils/issues. that's the group chat for problems. 🫶

---

and that's the whole page, babe 💅✨ — this is lid-state(1), dated 2021-10-19, from the acpi-utils source, and it's giving iconic. now go check that lid. 🎀🦋