🎧 BluetoothDeviceConnector

🔗 BluetoothDeviceConnector is a script created in AutoHotkey that allows you to automatically connect a specific Bluetooth device, such as "AirPods Pro". This script uses the Windows Bluetooth Control Panel to find and connect the specified device.

Features ✨

• Automatically searches for the specified Bluetooth device.
• Connects the device to Handsfree services (for voice communication) and AudioSink services (for music streaming).
• Provides visual notifications for success or errors.
• 🎮 Stream Deck Integration: One-click Bluetooth connection directly from your Elgato Stream Deck!

🎮 Stream Deck Plugin

This project includes an official Stream Deck plugin that lets you connect your Bluetooth devices with a single button press!

Quick Start

1. Navigate to streamdeck-plugin/ directory
2. Follow the Stream Deck Plugin README for installation
3. Add the "Connect Bluetooth Device" action to your Stream Deck
4. Configure your device name and connect instantly!

Features

• ✅ One-click Bluetooth connection
• ⚙️ Configurable device names
• 🎯 Visual feedback (success/error indicators)
• 🚀 Fast and lightweight

→ Learn more about the Stream Deck plugin

Requirements 🛠️

• Operating System: Windows
• Libraries: The script uses the Bluetooth control library provided by Windows (Bthprops.cpl).
• System Icon: The script uses a system icon (requires the path C:\WINDOWS\system32\netshell.dll).
• AutoHotkey v2: Must be installed to run this script. Download AutoHotkey v2.

How to Use 🚀

1. Install AutoHotkey v2: Make sure AutoHotkey v2 is installed.
2. Copy the code: Copy the script code into BluetoothDeviceConnector.ahk.
3. Run the script: Double-click the .ahk file to run the script.

Configuration ⚙️

Modify the deviceName variable at the beginning of the script to match the name of the Bluetooth device you want to connect. By default, it is set to "AirPods Pro":

deviceName := "AirPods Pro"

Change this value to connect other devices.

How It Works 🧠

The script uses a system library (Bthprops.cpl) to search for the desired Bluetooth device. If the device is found, it will attempt to activate two services:

• Handsfree: Connection for voice communications (e.g., calls).
• AudioSink: Connection for audio streaming (e.g., music).

A confirmation message will be displayed if the device is successfully connected.

Notifications 🔔

The script will display notifications in case of:

• No Bluetooth device found.
• Device successfully connected.

Limitations ⚠️

• The script is designed to connect to a specific device. It does not support multiple connections or advanced Bluetooth device management.
• It works only on Windows, using the Bluetooth libraries provided by the operating system.

Customization 🛠️

You can customize the script to include more devices or add extra functionality. AutoHotkey is a versatile scripting language that allows you to automate many operations on Windows.

Contributions 🤝

Contributions and improvements are welcome! Feel free to submit a pull request or report any issues on GitHub.

Support the Project 💖

This project is completely free and open source. If you find it useful and would like to support its continued development and updates, consider making a donation. Your support helps keep the project alive and motivates me to add new features and improvements!

Every contribution, no matter how small, is greatly appreciated! ❤️

License 📜

This project is licensed under the MIT License. Feel free to use, modify, and distribute the script as you like.