# 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
- **Package manager page:** <https://formulae.brew.sh/formula/bluetoothconnector>
- **Version:** 2.1.0
- **Source summary:** Connect and disconnect Bluetooth devices
- **Homepage:** <https://github.com/lapfelix/BluetoothConnector>
- **Repository:** <https://github.com/lapfelix/BluetoothConnector>
- **Upstream docs:** <https://github.com/lapfelix/BluetoothConnector>
- **License:** MIT
- **Source archive:** <https://github.com/lapfelix/BluetoothConnector/archive/refs/tags/2.1.0.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- BluetoothConnector (cli)
- BluetoothConnector (alias)

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, sonoma, ventura

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 2.1.0
- Local data: ok
- Upstream repository: https://github.com/lapfelix/BluetoothConnector
- Upstream latest detected: 2.1.0 (current)
- info: No package-manager update timestamp was available.
## 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

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** bluetoothconnector
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Requirements:** macos, xcode
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Homebrew utility packages](https://www.automicvault.com/pkg/brew-utility-packages/) - Matched Homebrew package provider.
- [blueutil](https://www.automicvault.com/pkg/brew/blueutil/) - Shares av.db curated category or tags: bluetooth, cli, macos, system.
- [asitop](https://www.automicvault.com/pkg/brew/asitop/) - Shares av.db curated category or tags: cli, macos, system.
- [bluez](https://www.automicvault.com/pkg/brew/bluez/) - Shares av.db curated category or tags: bluetooth, cli, system.
- [brightness](https://www.automicvault.com/pkg/brew/brightness/) - Shares av.db curated category or tags: cli, macos, system.
- [cliclick](https://www.automicvault.com/pkg/brew/cliclick/) - Shares av.db curated category or tags: cli, macos, system.
- [dark-mode](https://www.automicvault.com/pkg/brew/dark-mode/) - Shares av.db curated category or tags: cli, macos, system.
- [ddcctl](https://www.automicvault.com/pkg/brew/ddcctl/) - Shares av.db curated category or tags: cli, macos, system.
- [defaultbrowser](https://www.automicvault.com/pkg/brew/defaultbrowser/) - Shares av.db curated category or tags: cli, macos, system.
- [lsusb](https://www.automicvault.com/pkg/brew/lsusb/) - Local package facts share a topical domain. Shared terms: cli, devices, macos, system.

## Combined YAML source

View the package source record on GitHub. [combined/bluetoothconnector.yml](https://github.com/automic-vault/db/blob/main/combined/bluetoothconnector.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
