Releases: ChromuSx/BluetoothDeviceConnector
Release list
Bluetooth Device Connector 1.1.0 Beta 2
Experimental Windows + macOS beta for hardware testing.
Beta 2 fix
Beta 1 omitted the ws runtime dependency, so the plugin process could not start
and the Property Inspector remained on “Detecting devices…” on both Windows and
macOS. Beta 2 includes and verifies the dependency inside the installable bundle.
What to test
- Paired-device list in the Property Inspector
- Initial connected/disconnected key state
- Connect and disconnect on Windows
- Connect and disconnect on macOS with AirPods, another headset, or a speaker
Compatibility
- Windows 10 or later
- macOS 13 or later, Intel and Apple Silicon
- Stream Deck 6.9 or later
The macOS helper is ad-hoc signed but not notarized. Gatekeeper may require the
tester to approve the plugin or remove its quarantine attribute.
SHA-256: B9CC36C0830942FFCA5FFE5AFEDE9CB3D7CB0C29A38CA189B8721905AA978D97
DO NOT USE — Bluetooth Device Connector 1.1.0 Beta 1
This build is superseded and cannot start because the ws runtime dependency is missing. Download v1.1.0-beta.2 instead: https://github.com/ChromuSx/BluetoothDeviceConnector/releases/tag/v1.1.0-beta.2
v1.0.5.0 — Device Picker, Speaker Support & Live State
What's New
Fixed
- Speaker-only devices now connect (e.g. Amazon Echo Dot, Bluetooth speakers). Connecting no longer aborts when a device lacks the Handsfree (HFP) profile; each audio profile is toggled independently and the action succeeds if at least one connects.
- Device names with special characters no longer break the command — the helper executable is now invoked with an argument array instead of a shell string.
- Button no longer gets stuck on "Connecting" when the helper returns unexpected output.
- Standalone script: added a retry cap that previously allowed an infinite loop on unsupported devices.
Added
- Device picker in the Property Inspector — choose a paired device from a dropdown instead of typing its exact name.
- Live connection state — the key reflects the device's real connection status when it appears (survives Stream Deck restarts).
Changed
- Disabled Node debug mode in the published manifest.
- Slimmed the packaged plugin to the runtime dependency only.
Installation
- Download
com.chromusx.bluetooth-connector.streamDeckPluginbelow - Double-click it — Stream Deck installs the plugin automatically
- Add "Connect Bluetooth Device" to any button and pick your device from the dropdown
v1.0.1 - Compiled Executable
🚀 Bluetooth Device Connector v1.0.1
Performance improvement release with compiled executable.
⚡ What's Changed
Performance
- Compiled AutoHotkey Script - Plugin now uses standalone
BluetoothConnector.exeinstead of runtime + script - Faster Startup - No script parsing overhead, immediate execution
- Cleaner Package - Single executable file instead of two separate files
Technical Details
- Removed:
AutoHotkey64.exeruntime (no longer needed) - Removed:
bluetooth_connector.ahkscript file (compiled into .exe) - Added:
BluetoothConnector.exestandalone executable (~1.3 MB)
📥 Installation
- Download
com.chromusx.bluetooth-connector.streamDeckPlugin - Double-click to install
- Existing users: Plugin will automatically update
🔄 Upgrade from v1.0.0
No action required! The plugin works exactly the same, just faster. If you have v1.0.0 installed:
- Simply install the new version
- Your settings and configuration are preserved
📋 Requirements
- Platform: Windows 10 or later
- Stream Deck Software: Version 6.9 or later
Full Changelog: v1.0.0...v1.0.1
v1.0.0 - Initial Stream Deck Plugin Release
🎮 Bluetooth Device Connector v1.0.0
First official release of the Bluetooth Device Connector Stream Deck plugin!
✨ Features
Core Functionality
- One-Click Connect/Disconnect - Toggle Bluetooth device connection with a single button press
- Multi-Device Support - Add multiple plugin instances for different devices
- Smart State Tracking - Plugin remembers connection state between presses
Visual Feedback
- State Indicators with colored overlays:
- 🔵 Disconnected (default)
- 🟠 Connecting (orange dot)
- 🟢 Connected (green dot)
- 🔴 Error (red dot)
- Text Notifications - Temporary status text on button ("Connected!", "Disconnected!", "Error!")
Audio Feedback
- Windows System Sounds - Success and error audio notifications
- Non-intrusive - Respects Windows sound settings
📥 Installation
- Download
com.chromusx.bluetooth-connector.streamDeckPlugin - Double-click the file to install
- Find "Bluetooth Device Connector" in Stream Deck actions
- Drag to a button and configure your device name
📋 Requirements
- Platform: Windows 10 or later
- Stream Deck Software: Version 6.9 or later
📖 Documentation
🙏 Support
If you find this plugin useful, consider:
- ⭐ Starring the repository
- 🐛 Reporting issues on GitHub Issues
- ☕ Buying me a coffee
Full Changelog: https://github.com/ChromuSx/BluetoothDeviceConnector/blob/main/CHANGELOG.md
v1.0.0
Version 1.0.0
This is the initial release of Bluetooth Device Connector, an AutoHotkey script designed to simplify and automate the process of connecting Bluetooth devices to your Windows computer.
Key Features:
- Automatic Connection: The program automatically searches for and connects to the specified Bluetooth device.
- Compatibility with Apple AirPods: Developed to streamline the process of connecting AirPods headphones to Windows, eliminating the need for manual intervention.
- Easy to Use: Simply modify a variable in the code to specify the desired Bluetooth device name and run the script to initiate the connection process.
For more details on usage and limitations, please refer to the project's README.
Full Changelog: https://github.com/ChromuSx/BluetoothDeviceConnector/commits/Release