Video failed to load

bluetoothctl: CLI Tool for Managing Bluetooth Devices

458 words
2 minutes
bluetoothctl: CLI Tool for Managing Bluetooth Devices

bluetoothctl adalah utility yang digunakan untuk mengontrol perangkat wireless berbasis bluetooth via terminal1. Oleh karena tool ini berbasis CLI (Command Line Interface) alias tidak memerlukan GUI (Graphical User Interface) untuk dijalankan, maka bluetoothctl memberikan kemudahan kepada kita (Linux user) dalam me-manage perangkat bluetooth.

NOTE

Catatan:
Mengapa saya (dan mungkin teman-teman pengguna Linux serta para professional Linux) lebih menyukai aplikasi berbasis terminal? Tentu saja alasannya sederhana: Karena aplikasi berbasis CLI adalah aplikasi yang tidak bergantung pada GUI, maka itu berarti bahwa tool tersebut dapat dijalankan pada interface yang paling sederhana, misalnya ketika mode TTY seperti yang lumrah kita dapatkan, apalagi jika bekerja di server Linux.

Saya pernah menulis sedikit mengenai TTY, btw, berikut tautan artikelnya:

Log in to Your System with (Stunning) TTY
TTY in which is the acronym of TeleTYpe is a cool thing you need to know as linux user as it also will give you myriad of advantages.
2024-07-17tty#tty#linux#login#display manager

Prerequisites:#

Beberapa hal yang perlu dipersiapkan sebelum mengoperasikan bluetoothctl2:

1. Meng-install paket yang diperlukan (bluez)#

Pertama-tama, tentu saja kita perlu meng-install paket bluez karena bluetoothctl ada di dalamnya:

DistroCommand
Debian/Ubuntusudo apt install bluez
Arch Linuxsudo pacman -Sy bluez
Opensusesudo zypper install bluez
Fedorasudo dnf install bluez

Selesai.

2. Pastikan bluetoothd sudah running#

bluetoothd adalah daemon bluetooth, semacam server yang meng-handle per-bluetooth-an:

Terminal window
# Menjalankan bluetooth hanya untuk session saat ini:
sudo systemctl start bluetooth
# Menjalankan bluetooth setiap kali login:
sudo systemctl enable bluetooth

Untuk melihat statusnya:

Terminal window
sudo systemctl status bluetooth

Jika bluetoothd sudah running, berikut statusnya:

starting bluetoothd
starting bluetoothd

bluetoothctl Tutorial:#

Berikut adalah langkah-langkah penggunaan bluetoothctl:

1. Masuk ke shell bluetoothctl#

Terminal window
bluetoothctl

entering bluetoothctl shell
entering bluetoothctl shell

Ketika masuk ke bluetoothctl, kita dapat melihat controller-nya juga.

2. Scanning perangkat#

Terminal window
scan on

scanning active devices
scanning active devices

Tampak beberapa perangkat bluetooth ter-scan. Namun, perangkat yang akan saya hubungkan adalah TWS atau headset bluetooth dengan MAC 27:AB:34:8B:CD.

3. Connecting perangkat#

Terminal window
connect 27:AB:34:8B:CD:B1

connecting the device
connecting the device

Jika perangkat sudah terhubung dengan baik, maka seperti terlihat pada tangkapan layar, bluetoothctl akan memberikan notifikasi “Connection Succesful”. Selain itu, terlihat prompt-nya juga berubah menyesuaikan dengan nama perangkat yang berhasil terhubung (di saya berubah menjadi TWS).

4. Disconnecting perangkat#

Terminal window
disconnect

disconnecting
disconnecting

Jika sudah selesai menggunakannya, kita dapat men-disconnect perangkat tersebut dengan mengetikkan perintah disconnect, dan bila berhasil, bluetoothctl akan menampilkan status Succesful disconnected. Selain itu, prompt-nya juga akan kembali seperti semula.

5. Remove perangkat#

Terminal window
remove 27:AB:34:8B:CD:B1

Perintah di atas digunakan untuk menghapus perangkat yang sudah pernah kita pair sebelumnya. Ini dapat dilakukan terutama untuk troubleshooting masalah yang mungkin saja bisa terjadi pada koneksi antara perangkat dengan bluetooth laptop/komputer kita. Jadi, untuk mengatasi masalah (misalnya, perangkat headset sudah terhubung ke bluetooth komputer, tapi suara tidak masuk), kita bisa terlebih dahulu menhapus perangkat terkait, kemudian menghubungkannya kembali.

Additional Notes:#

Beberapa catatan tambahan:

1. Pairing perangkat#

Perlu dicatat, tutorial ini saya tulis ketika saya sudah biasa menggunakan perangkat TWS sehingga baik-baik saja jika saya tidak memasukkan proses pairing (alias setelah scan langsung connect). Mungkin, beberapa perangkat perlu dilakukan pairing terlebih dahulu sebelum connect, berikut perintahnya:

Terminal window
pair 27:AB:34:8B:CD:B1

2. Listing perangkat#

Kita juga dapat melihat perangkat apa saja yang pernah terhubung, atau jika perintah ini dilakukan setelah scanning, maka akan terlihat perangkat-perangkat yang berhasil ter-scan:

Terminal window
devices

devices listing
devices listing

3. Device info#

Kita juga dapat melihat info rinci mengenai device yang terhubung:

Terminal window
info

device info
device info


Btw, saya membuat artikel ini di Wayfire-nya Archlinux.

wayfire1
wayfire1
wayfire2
wayfire2
wayfire3
wayfire3

Footnotes#

  1. https://wiki.archlinux.org/title/Bluetooth

  2. https://bandithijo.dev/blog/mudah-menggunakan-bluetoothctl

Support & Share

If this article helped you, please share or support!

Sponsor
bluetoothctl: CLI Tool for Managing Bluetooth Devices
https://shangdi.github.io/posts/tech/bluetoothctl/
Author
Wildan
Published at
2025-02-23

Comments

Profile Image of the Author
Wildan
Welcome! Wildan-desu.
Announcemenet
Welcome to my blog! Enjoy exploring ~
Categories
Tags
Latest Moments
Site Statistics
Posts
111
Categories
90
Tags
316
Total Words
576,048
Running Days
0 days
Last Activity
0 days ago
Site Info
Build Platform
GitHub Actions
Blog Version
Firefly v6.15.10
License
CC BY-NC-SA 4.0