# Install bluetoothconnector with Homebrew

Connect and disconnect Bluetooth devices. Version 2.1.0 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:bluetoothconnector
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install bluetoothconnector
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:bluetoothconnector
- **Package manager:** Homebrew
- **Version:** 2.1.0
- **Source summary:** Connect and disconnect Bluetooth devices
- **Homepage:** <https://github.com/lapfelix/BluetoothConnector>
- **Repository:** <https://github.com/lapfelix/BluetoothConnector>
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- BluetoothConnector (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 2.1.0
## Project history and usage

BluetoothConnector is a small macOS Swift command-line tool for connecting, disconnecting, or toggling a Bluetooth device by MAC address.

### Project history

Felix Lapalme wrote BluetoothConnector to make switching BeatsX earbuds from an iPhone to a Mac easier. The README frames it as a simple personal macOS CLI, with releases, Homebrew installation, Mint installation, and manual Swift Package Manager build instructions.

The tag history starts at 1.0 in 2017 and reaches the 2.x line by 2023, with the project continuing as a compact utility rather than a broad Bluetooth management suite.

### Adoption history

Its adoption is centered on macOS users who want a scriptable Bluetooth action for headphones or other paired devices. Homebrew made it installable as bluetoothconnector, while Mint support fit Swift CLI users.

### How it is used

Users pass a Bluetooth MAC address and choose connect, disconnect, or default toggle behavior. The tool can also request macOS Notification Center feedback and the README shows an Automator service workflow for binding the command to a keyboard shortcut.

No persistent configuration or credentials file is documented; the device address is supplied on the command line or embedded by the user in an Automator workflow.

### Why package nerds care

BluetoothConnector is a neat example of a tiny Mac-only utility becoming package-manager material: one executable, one hardware annoyance, Homebrew distribution, and enough SwiftPM structure for repeatable builds.

### Timeline

- 2017: 1.0 tag published.
- 2019: README screenshots and workflow instructions documented Notification Center and Automator usage.
- 2023: 2.1.0 tag published.
- 2025: Repository activity shows continued maintenance work.

### Related projects

- Homebrew and Mint are documented installation paths.
- macOS Automator is documented as the suggested keyboard-shortcut integration.
- Apple's IOBluetooth/macOS Bluetooth stack is the underlying platform target.

### Sources

- <https://github.com/lapfelix/BluetoothConnector#readme>
- <https://github.com/lapfelix/BluetoothConnector/releases>
- source_facts.package-manager


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals


## Combined YAML source

View the package source record on GitHub. [combined/bluetoothconnector.yml](https://github.com/mxcl/pkgdb/blob/main/combined/bluetoothconnector.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- cross-ecosystem install command graph