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 rssi| --threshold rssi]
[-i interval|--interval interval ] [-s |--stdout | ] [--no-fork ] [-v |--verbose ] [-d ] [--disconnect-hack ] [-q |--link-quality rssi] [-h |--help ] [-V |--version ]

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 bluemon-client to perform actions like locking the terminal when you walk away.

-i ms
--interval
check interval
-a
--authenticate
-t rssi
--threshold
link quality threshold, out of 255
-b MAC -
-btid
ID (e.g. AA:BB:CC:DD:EE:FF). may be specified multiple times
-s
--stdout
--no-syslog
Log to stdout rather than syslog
-n
--no-fork
Do not become a daemon
-d
--disconnect-hack
adds a delay into noticing device abscence upon disconnect.
-v
--verbose
Enable verbose output
-q
--link-quality
Check for link quality to device. Default only checks for presence of connection.
-h
-V
--version

bluemon-query

Query the state of and send commands to bluemon

bluemon-query [ address]

sends queries to the bluemon

With no arguments queres for the first connected device. Giving the parameter of a blue- tooth ID will query for that ID.
Outputs the ID and signal strength if connected.

errors

Error querying status: The name cx.ath.matthew.bluemon.server was not provided by any .service files 

bluemon-client

Activate or deactivate programs based on bluetooth link quality

bluemon-client [-b AA:BB:CC:DD:EE:FF] [--btid AA:BB:CC:DD:EE:FF]
               [-u command | --upcmd command | -d command | --downcmd command]
               [-v | --verbose ] [-p | --protect ] [-h | v--help ] [-V | --version ]

Listens for events from the bluemon daemon and can start or stop programs when the given device is comes up or goes down.

-b
--btid mm:mm:
bluetooth ID to monitor (e.g. AA:BB:CC:DD:EE:FF)
-u
--upcmd cmd
command run when the device is connected.
-d
--downcmd cmd
command run when the device is disconnected.
-p
--protect
Try and protect against spoofing on the DBUS. Requires signals to come from a process owned by the root user.
-v
--verbose
Enable verbose output
-h
--help
Show summary of options.
-V
--version
Print version
hcitool (1), bluemon-client(1), bluemon-query(1), bluemon-dbus(7).