bluetoothctl(1) Linux System Administration bluetoothctl(1) (NAME) bluetoothctl - (SYNOPSIS) bluetoothctl [-a capability] [-e] [-m] [-t seconds] [-v] [-h] (DESCRIPTION) bluetoothctl(1). (BR/EDR) (LE) . . . D-Bus BlueZ org.bluez.Adapter(5) org.bluez.Device(5) . D-Bus / . (OPTIONS) -a capability, --agent capability (agent handler): -e, --endpoints (Media endpoints) -m, --monitor (monitor output) -t seconds, --timeout seconds -v, --version -h, --help (COMMANDS) list . (Usage) > list : > list show . (Usage) > show [ctrl] (Uses) org.bluez.Adapter(5) [ctrl] : > show : 00:11:22:33:44:55 > show 00:11:22:33:44:55 select . (Usage) > select : 00:11:22:33:44:55 > select 00:11:22:33:44:55 devices (). (Usage) > devices [Paired/Bonded/Trusted/Connected] [Paired/Bonded/Trusted/Connected] () : > devices : (Paired) > devices Paired : (Bonded) > devices Bonded : (Trusted) > devices Trusted : (Connected) > devices Connected system-alias . (Usage) > system-alias (Uses) Alias org.bluez.Adapter(5) () ( ) (Example Set controller alias with spaces (note quotes)) > system-alias "My Desktop Bluetooth" (Example Set controller alias without spaces) > system-alias MyLaptop (Example Set controller alias with hyphens) > system-alias "Home-Office-PC" reset-alias . (Usage) > reset-alias (Uses) Alias org.bluez.Adapter(5) ( ) (Example Reset controller alias to default (usually the hostname)) > reset-alias power . USB . (Usage) > power (Uses) Powered org.bluez.Adapter(5) - "on" "off" () (Example Turn on the Bluetooth controller) > power on (Example Turn off the Bluetooth controller) > power off advertise / . LE () ( ) . . (Usage) > advertise (Uses) RegisterAdvertisement org.bluez.LEAdvertisingManager(5) - "on" "off" "peripheral" "broadcast" () LE (Example Enable basic LE advertising) > advertise on LE (Example Disable LE advertising) > advertise off (Example Advertise as peripheral device) > advertise peripheral (Example Advertise as broadcast source) > advertise broadcast set-alias . (Usage) > set-alias (Uses) Alias org.bluez.Device(5) () ( ) (Example Set device alias with spaces (note quotes)) > set-alias "My Headphones" (Example Set device alias without spaces) > set-alias MyMouse (Example Set device alias with hyphens) > set-alias "Kitchen-Speaker" scan . LE . ( ) . . (Usage) > scan (Uses) StartDiscovery StopDiscovery org.bluez.Adapter(5) - "on" "off" "bredr" "le" () (LE + Classic) (Example Start scanning for all device types (LE + Classic)) > scan on (Example Stop scanning) > scan off (Example Scan for Low Energy devices only) > scan le BR/EDR () (Example Scan for BR/EDR (Classic) devices only) > scan bredr pair . . . . . pair . . (Usage) > pair [dev] (Uses) Pair org.bluez.Device(5) [dev] MAC (XX:XX:XX:XX:XX:XX) ( ) MAC (Example Pair with device using MAC address) > pair 00:11:22:33:44:55 (Example Pair with another device) > pair AA:BB:CC:DD:EE:FF (Example Pair using device object path) > pair /org/bluez/hci0/dev_00_11_22_33_44_55 pairable . / . . (Usage) > pairable (Uses) Pairable org.bluez.Adapter(5) - "on" "off" () ( ) (Example Enable pairing (accept pairing requests)) > pairable on ( ) (Example Disable pairing (reject pairing requests)) > pairable off discoverable . / . . LE . . . "discoverable on" discoverable-timeout . (Usage) > discoverable (Uses) Discoverable org.bluez.Adapter(5) - "on" "off" () (Example Make controller discoverable to other devices) > discoverable on (Example Make controller non-discoverable) > discoverable off discoverable-timeout . "discoverable on" . (Usage) > discoverable-timeout [value] (Uses) DiscoverableTimeout org.bluez.Adapter(5) [value] ( ) (Example Show current discoverable timeout value) > discoverable-timeout (Example Set discoverable timeout to 30 seconds) > discoverable-timeout 30 (Example Set discoverable timeout to 2 minutes) > discoverable-timeout 120 (Example Set discoverable timeout to 5 minutes) > discoverable-timeout 300 (Example Set unlimited discoverable timeout) > discoverable-timeout 0 agent / . . / (IO) . : DisplayOnly DisplayYesNo KeyboardDisplay KeyboardOnly NoInputNoOutput. (Usage) > agent (Uses) RegisterAgent org.bluez.AgentManager(5) - "on" "off" "auto" (DisplayOnly DisplayYesNo KeyboardDisplay KeyboardOnly NoInputNoOutput) () (Example Enable agent with default capability) > agent on (Example Disable agent) > agent off (Example Enable agent that can only display pairing codes) > agent DisplayOnly / (Example Enable agent that can display codes and accept/reject) > agent DisplayYesNo (Example Enable agent that can display and input pairing codes) > agent KeyboardDisplay (Example Enable agent that can only input pairing codes) > agent KeyboardOnly / (JustWorks) (Example Enable agent with no input/output (JustWorks)) > agent NoInputNoOutput default-agent . . (Usage) > default-agent (Uses) RequestDefaultAgent org.bluez.AgentManager(5) (Example Set the current agent as default) > default-agent trust . (Usage) > trust [dev] (Uses) Trusted org.bluez.Device(5) [dev] MAC (XX:XX:XX:XX:XX:XX) ( ) MAC (Example Trust device using MAC address) > trust 00:11:22:33:44:55 (Example Trust another device) > trust AA:BB:CC:DD:EE:FF (Example Trust device using object path) > trust /org/bluez/hci0/dev_00_11_22_33_44_55 untrust . (Usage) > untrust [dev] (Uses) Trusted org.bluez.Device(5) [dev] MAC (XX:XX:XX:XX:XX:XX) ( ) MAC (Example Remove trust from device using MAC address) > untrust 00:11:22:33:44:55 (Example Remove trust from another device) > untrust AA:BB:CC:DD:EE:FF (Example Remove trust using object path) > untrust /org/bluez/hci0/dev_00_11_22_33_44_55 block . (Usage) > block [dev] (Uses) Blocked org.bluez.Device(5) [dev] MAC (XX:XX:XX:XX:XX:XX) ( ) MAC (Example Block device using MAC address) > block 00:11:22:33:44:55 (Example Block another device) > block AA:BB:CC:DD:EE:FF (Example Block device using object path) > block /org/bluez/hci0/dev_00_11_22_33_44_55 unblock . (Usage) > unblock [dev] (Uses) Blocked org.bluez.Device(5) [dev] MAC (XX:XX:XX:XX:XX:XX) ( ) MAC (Example Unblock device using MAC address) > unblock 00:11:22:33:44:55 (Example Unblock another device) > unblock AA:BB:CC:DD:EE:FF (Example Unblock device using object path) > unblock /org/bluez/hci0/dev_00_11_22_33_44_55 remove . (Usage) > remove (Uses) RemoveDevice org.bluez.Adapter(5) MAC (XX:XX:XX:XX:XX:XX) () MAC (Example Remove device using MAC address) > remove 00:11:22:33:44:55 (Example Remove another device) > remove AA:BB:CC:DD:EE:FF (Example Remove device using object path) > remove /org/bluez/hci0/dev_00_11_22_33_44_55 connect . . . UUID . UUID (UUID ) (UUID ) . "a2dp-sink" "a2dp-source" "hfp-hf" "hfp-ag" "ftp" "spp" . LE () . (advertising report) le-connection-abort-by-local . . (Usage) > connect [uuid] (Uses) Connect ConnectProfile org.bluez.Device(5) MAC (XX:XX:XX:XX:XX:XX) () [uuid] (UUID) (UUID "a2dp-sink" "hfp-hf" ) () ( ) (Example Connect to device (all supported profiles)) > connect 1C:48:F9:9D:81:5C HSP (Example Connect to HSP Headset profile) > connect 1C:48:F9:9D:81:5C hsp-hs A2DP (Example Connect to A2DP Sink profile) > connect 1C:48:F9:9D:81:5C a2dp-sink A2DP (Example Connect to A2DP Source profile) > connect 1C:48:F9:9D:81:5C a2dp-source HFP (Example Connect to HFP Hands-Free profile) > connect 1C:48:F9:9D:81:5C hfp-hf HFP (Example Connect to HFP Audio Gateway profile) > connect 1C:48:F9:9D:81:5C hfp-ag (Example Connect to File Transfer Profile) > connect 1C:48:F9:9D:81:5C ftp (Example Connect to Serial Port Profile) > connect 1C:48:F9:9D:81:5C spp UUID (HSP) (Example Connect using full 128-bit UUID (HSP)) > connect 1C:48:F9:9D:81:5C 00001108-0000-1000-8000-00805f9b34fb UUID (HSP) (Example Connect using short 16-bit UUID (HSP)) > connect 1C:48:F9:9D:81:5C 0x1108 A2DP UUID (Example Connect to A2DP profile using short UUID) > connect 1C:48:F9:9D:81:5C 0x110E disconnect . . UUID . LE . (Usage) > disconnect [dev] [uuid] (Uses) Disconnect DisconnectProfile org.bluez.Device(5) [dev] MAC (XX:XX:XX:XX:XX:XX) ( ) [uuid] (UUID) (UUID ) () (Example Disconnect all profiles and terminate connection) > disconnect 1C:48:F9:9D:81:5C A2DP Sink (Example Disconnect only A2DP Sink profile) > disconnect 1C:48:F9:9D:81:5C a2dp-sink HFP (Example Disconnect only HFP Hands-Free profile) > disconnect 1C:48:F9:9D:81:5C hfp-hf (Example Disconnect only Serial Port Profile) > disconnect 1C:48:F9:9D:81:5C spp A2DP UUID (Example Disconnect A2DP profile using short UUID) > disconnect 1C:48:F9:9D:81:5C 0x110E HSP UUID (Example Disconnect HSP profile using full UUID) > disconnect 1C:48:F9:9D:81:5C 00001108-0000-1000-8000-00805f9b34fb info . (Usage) > info [dev/set] (Uses) org.bluez.Device(5) [dev/set] MAC (XX:XX:XX:XX:XX:XX) DeviceSet ( ) (Example Show detailed information for device) > info 1C:48:F9:9D:81:5C (Example Show information for another device) > info 00:11:22:33:44:55 (Example Show device info using object path) > info /org/bluez/hci0/dev_1C_48_F9_9D_81_5C bearer / . (Usage) > bearer [last-seen/bredr/le] (Uses) PreferredBearer org.bluez.Device(5) MAC (XX:XX:XX:XX:XX:XX) () [last-seen/bredr/le] - "last-seen" "bredr" (Classic) "le" (Low Energy) () (Example get preferred bearer) > bearer PreferredBearer: last-seen LE (Example set preferred bearer to LE) > bearer le [CHG] Device PreferredBearer: le Changing le succeeded BREDR (Example set preferred bearer to BREDR) > bearer bredr [CHG] Device PreferredBearer: bredr Changing bredr succeeded (Advertise Submenu) bluetoothctl-advertise(1) . (Monitor Submenu) bluetoothctl-monitor(1) . (Scan Submenu) bluetoothctl-scan(1) . (Gatt Submenu) bluetoothctl-gatt(1) . (Admin Submenu) bluetoothctl-admin(1) . (Player Submenu) bluetoothctl-player(1) . (Endpoint Submenu) bluetoothctl-endpoint(1) . (Transport Submenu) bluetoothctl-transport(1) . (Management Submenu) bluetoothctl-mgmt(1) . (Assistant Submenu) bluetoothctl-assistant(1) . (LE Submenu) bluetoothctl-le(1) . (BREDR Submenu) bluetoothctl-bredr(1) . (AUTOMATION) (Here Docs) expect . : bluetoothctl < (RESOURCES) (REPORTING BUGS) (Copyright) (LGPL) . BlueZ March 2024 bluetoothctl(1)