bluetoothctl is a command-line utility in Linux that is used to manage Bluetooth devices and settings. bluetoothctl is a part of the bluez package, which is a suite of tools and libraries for managing Bluetooth devices on Linux systems.
If you encounter the below error while running the bluetoothctl command:
bluetoothctl: command not found
you may try installing the below package as per your choice of distribution:
| Distribution | Command |
|---|---|
| Debian | apt-get install bluez |
| Ubuntu | apt-get install bluez |
| Alpine | apk add bluez |
| Arch Linux | pacman -S bluez-utils |
| Kali Linux | apt-get install bluez |
| CentOS | yum install bluez |
| Fedora | dnf install bluez |
| Raspbian | apt-get install bluez |
Once bluez is installed, you can start the bluetoothctl utility by running the bluetoothctl command. bluetoothctl will start in interactive mode, allowing you to enter commands and manage your Bluetooth devices and settings in real-time.
bluetoothctl Command Examples
1. Enter the `bluetoothctl` shell:
# bluetoothctl
2. List all known devices:
# bluetoothctl devices
3. Power the Bluetooth controller on or off:
# bluetoothctl power on|off
4. Pair with a device:
# bluetoothctl pair mac_address
5. Remove a device:
# bluetoothctl remove mac_address
6. Connect to a paired device:
# bluetoothctl connect mac_address
7. Disconnect from a paired device:
# bluetoothctl disconnect mac_address
8. Display help:
# bluetoothctl help