BLUEMON-CLIENT(1)

📦 version 1.4, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💙 BLUEMON-CLIENT — the manual page, bestie edition 💙

okay so you're reading the bluemon-client page from the General Commands Manual, section 1 (that's "user commands" territory, iykyk). pull up a chair, grab a strawberry 🍓, and let's get into it.

🌸 NAME 🌸

bluemon-client — activate or deactivate programs based on bluetooth link quality

like. it watches your bluetooth link and runs stuff when things go up or down. main character energy fr. ✨

🎀 SYNOPSIS 🎀

bluemon-client [-u command]  [--upcmd command]  [-d command]  [--downcmd
command]  [-b aa:bb:cc:dd:ee:ff]  [--btid aa:bb:cc:dd:ee:ff]  [-v ]
[--verbose ]  [-p ]  [--protect ]  [-h ]  [--help ]  [-V ]  [--version ]

no cap, that's the whole vibe right there. 💅

🦋 DESCRIPTION 🦋

This manual page documents briefly the bluemon-client command. (yes bestie, we're documenting the doc. very meta of us. 🙈)

so here's the tea: bluemon-client listens for events from the bluemon daemon, and it can start or stop programs when the given device is connected or disconnected. that's it. that's the whole thing. 🫶

and the way that's actually useful?? you can use it to perform actions like locking the terminal when you walk away from it. literally the "protect my screen when i go get a snack" feature. iconic. 🔥

✨ OPTIONS ✨

These programs follow the usual GNU command line syntax, with long options starting with two dashes (-). A summary of options is included below. (yes, "these programs", plural — the manpage said it, not me, don't @ me 😭)

  • -u, --upcmd — The command to be run when the device is connected. 🎉 device shows up? run this.
  • -d, --downcmd — The command to be run when the device is disconnected. 💀 device dips? run this instead.
  • -b, --btid — The bluetooth ID to monitor (e.g. aa:bb:cc:dd:ee:ff). that's the little hex-y address thing, keep the colons, they matter.
  • -p, --protect — Try and protect against spoofing on the DBUS. Requires signals to come from a process owned by the root user. 🛡️ so like, security mode. and note the Requires — it needs those signals to come from a root-owned process, no exceptions bestie.
  • -v, --verbose — Enable verbose output. 📢 tell me everything, i want the lore.
  • -h, --help — Show summary of options. the classic "help i forgot the flags" move. 💖
  • -V, --version — Print version. capital V specifically, lowercase -v is a whole different thing (that's verbose), do not mix them up, i'm begging 🙏
⚠️ watch the case on -v vs -V!! one is verbose, one is version. they are NOT the same and the terminal will not be gentle about it.

🌈 SEE ALSO 🌈

go read these too, they're the friend group:

  • bluemon (1)
  • bluemon-query(1)
  • bluemon-dbus(7)

💜 AUTHOR 💜

This manual page was written by Matthew Johnson <debian@matthew.ath.cx> for the Debian system (but may be used by others). Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 any later version published by the Free Software Foundation.

On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL. 📄

okay that's the whole page!! you now know bluemon-client better than it knows itself. go lock your terminal and walk away like the icon you are 👑💖

signing off from the General Commands Manual, section 1 — it's BLUEMON-CLIENT(1), and that's periodt. 🦋

📦 where this page comes from