BLUEMON-DBUS(7)

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

💖 BLUEMON-DBUS(7) 💖

okay bestie, this is the DBUS interface to bluemon(1) page from Miscellaneous Information Manual, and it's lowkey one of the shortest glow-ups in the whole manual set, so let's get into it ✨

🌸 NAME 🌸

bluemon — the DBUS interface to bluemon(1) 🦋

🎀 DESCRIPTION 🎀

So this page is here to give you the tea on the DBUS interface to bluemon(1). That's it, that's the brief. Short and iconic, we love her 💅

✨ INTERFACE ✨

Bluemon is out here exposing 2 signals and 1 method, and honestly? Slay. Here's the whole vibe check:

  • The bluemon process is registered on the system bus as cx.ath.matthew.bluemon.server 👑
  • The exposed object is /cx/ath/matthew/bluemon/Bluemon 💖
  • The exposed interface is cx.ath.matthew.bluemon.Bluemon ✨

🦋 The Signals 🦋

The signal interface is cx.ath.matthew.bluemon.ProximitySignal, and it ships with two names:

  • Connect — 1 parameter: the string representation of the bluetooth device ID which has been connected 🫶
  • Disconnect — 1 parameter: the string representation of the bluetooth device ID which has been disconnected 😭

🌈 The Method 🌈

The method has the signature:

Status(IN STRING address, OUT STRING address, OUT BOOLEAN status, OUT UINT32 level)

The in parameter may be blank — in which case the first connected device will be returned. Main character energy honestly 🌟

If status is true (device is connected) then the address and level will correspond to the device address and the reported link quality. Otherwise they will be set to the address asked for and -1 respectively. Not me getting a -1 like that 💀

Pro tip, fr fr: this information is also available as an XML protocol description in /usr/share/doc/bluemon/bluemon-dbus.xml — go read it, iykyk 📖

💜 SEE ALSO 💜

🎀 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 or any later version published by the Free Software Foundation. Periodt. 🫶

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

k bye bestie, that's the whole page!! 💖✨🎀🦋🌸💅 — love, BLUEMON ...NTERFACES(7), from the Miscellaneous Information Manual, footer and all. Mwah 😘

📦 where this page comes from