Automatically connect or disconnect a Bluetooth speaker when a specific display is connected on macOS.
Monnect runs in the background and watches for a configured external display. When the display is detected, it connects your chosen Bluetooth speaker. When the display is disconnected, it disconnects the speaker.
If you use:
- An external monitor at your desk
- A Bluetooth speaker
- A MacBook that you dock and undock
You’ve probably manually switched audio devices more times than you’d like.
Monnect automates that.
pipx install monnect
brew tap aki21j/monnect
brew install monnect
- macOS
- blueutil
Install blueutil with:
brew install blueutil
Run:
monnect setup
This will guide you through selecting:
- A display
- A Bluetooth device
Then start the service:
monnect start
monnect start - Start background service
monnect stop - Stop background service
monnect status - Show current status
monnect doctor - Validate environment
monnect --version - Show version
- Uses system_profiler to detect display state
- Uses blueutil to manage Bluetooth connections
- Runs as a macOS LaunchAgent
- Polling-based with debounce logic
If installed via pipx:
pipx uninstall monnect
If installed via Homebrew:
brew uninstall monnect
brew untap aki21j/monnect
MIT