# Bluetooth Setup Tool

Easy Bluetooth device management for Gentoo using `bluetoothctl`.

## Features

- 🔍 Scan for nearby Bluetooth devices
- 🔗 Pair and connect to devices
- 📋 List paired devices with connection status
- ❌ Remove/forget devices
- 🔌 Enable/disable Bluetooth
- ✨ Color-coded output for better readability
- ⚡ ZSH autocompletion support

## Installation

```bash
# From the scripts folder
cd scripts/bluetooth-setup

# Install the main script
sudo cp bluetooth-setup /usr/local/bin/bluetooth-setup
sudo chmod +x /usr/local/bin/bluetooth-setup

# Install ZSH autocompletion
sudo mkdir -p /usr/local/share/zsh/site-functions
sudo cp _bluetooth-setup /usr/local/share/zsh/site-functions/_bluetooth-setup

# Reload ZSH completions (or restart your shell)
autoload -U compinit && compinit
```

## Requirements

- `bluetoothctl` (from bluez package)
- Bluetooth service running (`rc-service bluetooth start`)
- Bluetooth hardware not blocked (`rfkill list bluetooth`)

## Usage

### List paired devices
```bash
bluetooth-setup
# or
bluetooth-setup list-paired
```

### Scan for nearby devices
```bash
bluetooth-setup scan
```

### Pair with a device
```bash
bluetooth-setup pair AA:BB:CC:DD:EE:FF
```
The script will automatically trust the device after pairing and ask if you want to connect.

### Connect to a paired device
```bash
bluetooth-setup connect AA:BB:CC:DD:EE:FF
```

### Disconnect from device(s)
```bash
# Disconnect all devices
bluetooth-setup disconnect

# Disconnect specific device
bluetooth-setup disconnect AA:BB:CC:DD:EE:FF
```

### Remove/forget a device
```bash
bluetooth-setup remove AA:BB:CC:DD:EE:FF
```

### Show Bluetooth status
```bash
bluetooth-setup status
```

### Enable/disable Bluetooth
```bash
bluetooth-setup power on
bluetooth-setup power off
```

### Get help
```bash
bluetooth-setup help
```

## ZSH Autocompletion

Once installed, ZSH will provide intelligent completions:

- Command completion: `bluetooth-setup <TAB>`
- Device completion: `bluetooth-setup connect <TAB>` shows paired devices
- Power state completion: `bluetooth-setup power <TAB>` shows on/off

## Troubleshooting

### Bluetooth service not running
```bash
sudo rc-service bluetooth start
sudo rc-update add bluetooth default
```

### Bluetooth is blocked
```bash
# Check status
rfkill list bluetooth

# Unblock
sudo rfkill unblock bluetooth
```

### Device won't pair
1. Make sure the device is in pairing mode
2. Ensure Bluetooth is powered on: `bluetooth-setup power on`
3. Remove the device if previously paired: `bluetooth-setup remove MAC`
4. Try pairing again

### Can't find bluetoothctl
```bash
# Install bluez
sudo emerge -av net-wireless/bluez
```

## Examples

### Connect to Bluetooth headphones
```bash
# Enable Bluetooth
bluetooth-setup power on

# Scan for devices
bluetooth-setup scan

# Pair and connect (use MAC address from scan)
bluetooth-setup pair AA:BB:CC:DD:EE:FF

# Later, reconnect quickly
bluetooth-setup connect AA:BB:CC:DD:EE:FF
```

### Quick disconnect
```bash
# Disconnect all Bluetooth devices
bluetooth-setup disconnect
```

## Integration with Waybar

The Bluetooth status can be displayed in waybar. See the main project documentation for waybar configuration.

## Related

- WiFi Setup: See `scripts/wifi-setup/` for WiFi management