blueutil

blueutil [options] Without options outputs current state
Power: 1
Discoverable: 0 

-p
--power
output power state as 1 or 0
-p
--power STATE
set power state
-d
--discoverable
output discoverable state as 1 or 0
-d
--discoverable STATE
set discoverable state
--favourites list favourite devices
--inquiry [T] inquiry devices in range, 10 seconds duration by default excluding time for name updates
--paired list paired devices
--recent [N] list recently used devices, 10 by default, 0 to list all

address: f8-e9-4e-df-3a-92, not connected, not favourite, not paired, name: "Dennis’s iPhone", recent access date: 2020-07-08 01:43:39 +0000
address: 76-14-08-9b-5b-43, not connected, not favourite, not paired, name: "iPhone", recent access date: 2020-06-21 16:39:11 +0000
address: 5f-08-31-aa-23-eb, not connected, not favourite, not paired, name: "iPhone", recent access date: 2020-05-13 18:47:42 +0000
address: d3-51-78-72-ec-0f, not connected, not favourite, not paired, name: "Ruuvi EC0F", recent access date: 2020-05-09 19:31:57 +0000
address: 7e-61-34-56-8e-13, not connected, not favourite, not paired, name: "iPhone", recent access date: 2020-02-21 18:03:33 +0000
address: b8-27-eb-e3-a4-6c, not connected, not favourite, not paired, name: "pi93graf", recent access date: 2019-04-04 17:31:26 +0000
address: 60-30-d4-9d-dd-59, not connected, not favourite, not paired, name: "Dennis’s iPhone", recent access date: 2019-03-10 17:35:48 +0000
address: cc-9e-a2-05-41-bf, not connected, not favourite, not paired, name: "-", recent access date: 2019-03-10 11:27:20 +0000
address: 00-00-00-00-34-bc, not connected, not favourite, not paired, name: "Otium X6", recent access date: 2019-03-10 11:26:04 +0000
address: 00-02-07-00-82-1c, not connected, not favourite, not paired, name: "Olive-821c", recent access date: 2019-02-10 01:07:22 +0000
address: 60-fb-42-83-72-48, not connected, not favourite, not paired, name: "smackerpro", recent access date: 2018-12-06 22:17:14 +0000
address: d4-8b-9c-6c-23-0e, not connected, not favourite, not paired, name: "Ruuvi230e", recent access date: 2018-11-03 16:50:25 +0000
address: c7-10-3c-68-24-c2, not connected, not favourite, not paired, name: "Ruuvi24c2", recent access date: 2018-11-03 16:37:29 +0000
address: e4-0d-35-84-01-c4, not connected, not favourite, not paired, name: "Puck.js 01c4", recent access date: 2018-10-15 15:22:19 +0000
address: 34-81-f4-33-60-19, not connected, not favourite, not paired, name: "RP757C-10145691", recent access date: 2018-10-14 22:24:11 +0000
address: 00-56-cd-08-4f-a5, not connected, not favourite, not paired, name: "Dennis's iPhone", recent access date: 2018-10-13 19:05:46 +0000
address: 18-20-32-9f-54-76, not connected, not favourite, not paired, name: "Dennis's iPad", recent access date: 2018-09-29 15:21:18 +0000
address: f4-4e-fd-44-46-f3, not connected, not favourite, not paired, name: "BH-145", recent access date: 2018-09-17 20:31:03 +0000
address: 49-04-16-67-42-a6, not connected, not favourite, not paired, name: "-", recent access date: 2018-03-17 21:46:47 +0000
address: f0-24-75-b2-02-21, not connected, not favourite, not paired, name: "-", recent access date: 2018-02-24 18:02:38 +0000
address: b8-27-eb-02-38-0e, not connected, not favourite, not paired, name: "-", recent access date: 2018-02-16 16:00:32 +0000
address: b4-7c-9c-77-5d-9b, not connected, not favourite, not paired, name: "-", recent access date: 2018-01-13 13:14:58 +0000
address: 61-17-ec-e8-69-f6, not connected, not favourite, not paired, name: "-", recent access date: 2018-01-05 23:29:23 +0000
address: 00-02-5b-00-a0-fd, not connected, not favourite, not paired, name: "Olive-00fd", recent access date: 2017-12-28 00:18:58 +0000
address: 5c-f6-dc-58-35-33, not connected, not favourite, not paired, name: "DTVBluetooth", recent access date: 2017-11-16 21:24:10 +0000
address: b8-27-eb-96-64-43, not connected, not favourite, not paired, name: "piw", recent access date: 2017-11-13 00:02:12 +0000
address: e9-38-3f-dd-20-bc, not connected, not favourite, not paired, name: "RuuviTag", recent access date: 2017-11-03 00:00:14 +0000
address: 4c-8d-79-d6-29-9b, not connected, not favourite, not paired, name: "Andrew’s MacBook Pro", recent access date: 2017-10-30 22:36:43 +0000
address: f0-85-49-cd-59-eb, not connected, not favourite, not paired, name: "One", recent access date: 2017-06-30 22:19:36 +0000
address: 5c-57-54-d6-0c-61, not connected, not favourite, not paired, name: "-", recent access date: 2017-06-30 22:16:45 +0000
address: 6b-04-ae-f8-53-cc, not connected, not favourite, not paired, name: "-", recent access date: 2017-06-30 22:16:42 +0000

address: 1c-36-bb-08-4d-77, connected (slave, -89 dBm), not favourite, paired, name: "Sullivan, Trevor's Trackpad", recent access date: 2019-07-30 15:31:33 +0000
address: 04-52-c7-31-73-9f, not connected, not favourite, paired, name: "Vector", recent access date: 2019-07-28 21:49:55 +0000
address: 70-f1-93-1b-d4-3f, connected (slave, -84 dBm), not favourite, paired, name: "Sullivan, Trevor's Keyboard", recent access date: 2019-07-30 21:30:39 +0000
address: 00-26-81-35-de-27, not connected, not favourite, paired, name: "PXC 550", recent access date: 2019-07-30 19:32:49 +0000
--info ID show information about device
--is-connected ID connected state of device as 1 or 0
--connect ID create a connection to device
--disconnect ID close the connection to device
--pair ID [PIN] pair with device,
PIN up to 16 characters will be used instead of interactive input
--add-favourite ID add to favourites
--remove-favourite ID remove from favourites
--format FORMAT change output format of info and all listing commands
--wait-connect ID [TIMEOUT] EXPERIMENTAL wait for device to connect
--wait-disconnect ID [TIMEOUT] EXPERIMENTAL wait for device to disconnect
--wait-rssi ID OP VALUE [PERIOD [TIMEOUT]] EXPERIMENTAL wait for device RSSI value which is 0 for golden range, -129 if it cannot be read (e.g. device is disconnected)
-h
--help
this help
-v
--version
show version

STATE 1, on, 0, off, toggle
ID address in form xxxxxxxxxxxx, xx-xx-xx-xx-xx-xx or xx:xx:xx:xx:xx:xx, or name of device to search in used devices
OP >, >=, <, <=, =, !=, gt, ge, lt, le, eq, ne
PERIOD seconds, defaults to 1
TIMEOUT seconds, default value 0 doesn't add timeout
FORMAT

Exit codes

0 Success
1 General failure
64 Wrong usage like missing or unexpected arguments, wrong parameters
69 Bluetooth not available
70 Internal error
71 System error like shortage of memory
75 Timeout error