BLUEMON(1)

💖 BLUEMON 💖

okay so bestie, welcome to bluemon — it lives in the General Commands Manual (that's section 1, the cool section) and it's exactly the kind of little gremlin that makes your laptop do stuff based on whether your bluetooth device is vibing nearby or not. Activate or deactivate programs based on bluetooth link quality. that's the whole job. iconic honestly.

✨ SYNOPSIS ✨

bluemon [-b aa:bb:cc:dd:ee:ff]  [--btid aa:bb:cc:dd:ee:ff]  [-t
threshold]  [--threshold threshold]  [-i interval]  [--interval
interval]  [-s ]  [--stdout ]  [--no-syslog ]  [-n ]  [--no-fork ]  [-v
]  [--verbose ]  [-d ]  [--disconnect-hack ]  [-q ]  [--link-quality ]
[-h ]  [--help ]  [-V ]  [--version ]

like. look at her. she has so many flags and every single one is your friend 🫶

🌸 DESCRIPTION 🌸

This manual page documents briefly the bluemon command. (briefly! she's mysterious! we love a woman of few words 💅)

So here's the tea, fr fr: bluemon watches the quality of the link to a bluetooth device, and it emits dbus signals when that quality drops below a threshold you set, or when the device just straight up disconnects. disconnects?? in THIS economy?? 😭

And here's the part that lowkey changes your life: used with the bluemon-client program, this can be used to perform actions like locking the terminal when you walk away from it. main character security behavior honestly 👑

✨ 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 bestie, all of them, we are NOT skipping any, that's the rule 💖)

• -i, --interval — the check interval, in ms. how often she peeks. 👀
• -t, --threshold — the link quality threshold, out of 255. so like. out of 255. remember that number, it matters.
• -b, --btid — the bluetooth ID to monitor (e.g. aa:bb:cc:dd:ee:ff). and listen — this parameter may be specified multiple times to monitor multiple devices. polyamory but for bluetooth devices. slay 🦋
• -s, --stdout, --no-syslog — Log to stdout rather than syslog. she's chatty and she's saying it to your face.
• -n, --no-fork — Do not become a daemon. stay right here. don't leave me. 🙈
• -d, --disconnect-hack — Enable this if your bluetooth device disconnects regularly while still in range. it adds a small delay into noticing device abscence upon disconnect. yes that's a hack, yes it's in the name, no we're not judging her.
• -v, --verbose — Enable verbose output. she will tell you EVERYTHING. and honestly? we're listening. 🎀
• -q, --link-quality — Check for link quality to device. Default only checks for presence of connection. so by default she's just like "are you there?" but with -q she's like "are you there AND are you doing okay?" 🥺 that's growth
• -h, --help — Show summary of options. the classic.
• -V, --version — print version. lowercase print because that's how the original said it and we respect the queen's grammar 💅

👀 SEE ALSO 👀

the whole friend group, go say hi:

• hcitool(1)
• bluemon-client(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 legal bit and it's genuinely important, don't skip it, licensing is not a vibe you fumble bestie 🫶

and that's the whole page!! you read all of it, every flag, every letter, no skimming, I'm so proud of you 😭💖 this little queen comes to you straight from the General Commands Manual, and there's no date stamped on her footer — she simply is, timeless, an icon, no cap. go lock that terminal and walk away dramatically. periodt. 💅✨👑