Skip to content

Commit eaf5f00

Browse files
committed
feat: add Arch Linux Bluetooth connectivity guide
1 parent fc215fa commit eaf5f00

1 file changed

Lines changed: 58 additions & 0 deletions

File tree

  • src/content/blog/Linux/distribution/Archlinux/bluetooth-connect
Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
1+
---
2+
title: "Arch Linux Bluetooth Connectivity Guide"
3+
description: "Quick-reference cheatsheet for installing, configuring, and troubleshooting Bluetooth on Arch Linux."
4+
date: 2026-06-01T16:00:00+0800
5+
tag: "Arch Linux, Bluetooth, Linux"
6+
lang: en-US
7+
---
8+
9+
## Installation
10+
11+
```bash
12+
sudo pacman -S bluez bluez-utils
13+
```
14+
15+
## Systemd Service Management
16+
17+
```bash
18+
sudo systemctl start bluetooth.service
19+
sudo systemctl enable bluetooth.service
20+
sudo systemctl stop bluetooth.service
21+
sudo systemctl restart bluetooth.service
22+
sudo systemctl status bluetooth.service
23+
```
24+
25+
## Bluetoothctl CLI Commands
26+
27+
Type `bluetoothctl` in your terminal to enter the interactive shell, then use these commands:
28+
29+
| Command | Description |
30+
|---|---|
31+
| `power on` / `off` | Turn the Bluetooth radio on or off |
32+
| `scan on` / `off` | Start or stop searching for nearby devices |
33+
| `devices` | List all discovered and known devices |
34+
| `paired-devices` | List all successfully paired devices |
35+
| `pair <MAC>` | Pair with a specific device |
36+
| `trust <MAC>` | Trust the device (allows automatic reconnects) |
37+
| `connect <MAC>` | Establish a connection to the device |
38+
| `disconnect <MAC>` | Disconnect from the device |
39+
| `remove <MAC>` | Unpair and delete the device from system memory |
40+
| `exit` | Quit the bluetoothctl shell |
41+
42+
## Real Example: Connect a Bluetooth Headset
43+
44+
Walk through pairing and connecting a headset from scratch:
45+
46+
```bash
47+
sudo systemctl start bluetooth.service
48+
49+
bluetoothctl
50+
51+
power on
52+
scan on
53+
scan off
54+
pair AA:BB:CC:DD:EE:FF
55+
trust AA:BB:CC:DD:EE:FF
56+
connect AA:BB:CC:DD:EE:FF
57+
exit
58+
```

0 commit comments

Comments
 (0)