List paired Bluetooth devices with bluetoothctl

See which headsets, keyboards and phones are paired, and clean up dead entries.

LinuxnetworkbluetoothcliLow risk
Run bluetoothctl devices Paired to list paired devices, and bluetoothctl info MAC to see one device's connection and battery details.

01Command

Command
$ bluetoothctl devices Paired && bluetoothctl info

02What it does

bluetoothctl is BlueZ's command-line controller, and 'devices Paired' prints every remembered device without opening the GUI settings. bluetoothctl info MAC shows whether the device is currently connected, plus battery percentage when the headset reports it. Stale entries from old phones are removed with bluetoothctl remove MAC, which often fixes pairing failures.

03Risk

RiskLow risk
Requirementsbluez installed (preinstalled on desktop distros); bluetooth service running: sudo systemctl start bluetooth
!Warning: remove MAC deletes the pairing on this computer — the other device must be re-paired before it connects again; interactive mode is exited with quit.

04Undo

✓No undo needed — this command does not change persistent state.

05Sources

  • bluetoothctl(1) — manual page
    Arch Linux · community · 2026-09-17
    Evidence: bluetoothctl provides commands to list paired devices, show device info such as battery percentage, and pair or remove devices.
  • bluetoothctl(1) — Ubuntu manual page
    Ubuntu · community · 2026-09-17
    Evidence: bluetoothctl is the interactive controller for BlueZ; subcommands include devices (list known devices), info (details of a device) and remove.

Last verified: 2026-09-18 · Category: Network

06Related solutions