Scroll to navigation

BLUEMON(1) General Commands Manual BLUEMON(1)


bluemon — Activate or deactivate programs based on bluetooth link quality


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 ]


This manual page documents briefly the bluemon command.

bluemon monitors the quality of the link to a bluetooth device and emits dbus signals when it drops below a given threshold or disconnects. Used with the bluemon-client program, This can be used to perform actions like locking the terminal when you walk away from it.


These programs follow the usual GNU command line syntax, with long options starting with two dashes (`-'). A summary of options is included below.

The check interval, in ms.
The link quality threshold, out of 255
The bluetooth ID to monitor (e.g. aa:bb:cc:dd:ee:ff). This parameter may be specified multiple times to monitor multiple devices.
Log to stdout rather than syslog
Do not become a daemon
Enable this if your bluetooth device disconnects regularly while still in range, adds a small delay into noticing device abscence upon disconnect.
Enable verbose output
Check for link quality to device. Default only checks for presence of connection.
Show summary of options.
print version.


hcitool (1), bluemon-client(1), bluemon-query(1), bluemon-dbus(7).


This manual page was written by Matthew Johnson <> 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.