AndroidTV Bluetooth Controller

A lightweight utility for Android TV and Android phones that gives you a 1-click UI to connect/disconnect Bluetooth devices, or complete ADB automation support.

Features

• 1-Click Connect: Simple UI to instantly toggle connections from your TV.
• ADB Automation: Trigger connections/disconnections via terminal or automation scripts (Tasker, Home Assistant).
• Recent Sorting: Automatically sorts paired devices by most recently used.
• Universal Compatibility: Works on Android TV and Android phones (Android 8.0+).
• Low Overhead: Minimal impact on system resources and stays ready across restarts.

Usage

UI Method

Simply launch the AndroidTV Bluetooth Controller app. All your paired devices will appear in a list. Click any device to connect or disconnect. Your most recently used devices will automatically stay at the top.

ADB Method (Automation)

Connect or disconnect your Bluetooth devices by sending broadcast intents. This is perfect for mapping to remote buttons (via Button Mapper) or integrating into "Movie Mode" scenes.

Connect a Device

By Name (Recommended):

adb shell am broadcast -a com.saihgupr.btcontrol.ACTION_CONNECT \
  -n com.saihgupr.btcontrol/.BluetoothControlReceiver \
  -e name "Your Device Name"

Note: Name matching is case-insensitive (e.g., "LE_WH-1000XM4").

By MAC Address:

adb shell am broadcast -a com.saihgupr.btcontrol.ACTION_CONNECT \
  -n com.saihgupr.btcontrol/.BluetoothControlReceiver \
  -e address "CC:98:8B:F4:97:BA"

Disconnect a Device

adb shell am broadcast -a com.saihgupr.btcontrol.ACTION_DISCONNECT \
  -n com.saihgupr.btcontrol/.BluetoothControlReceiver \
  -e name "Your Device Name"

Installation

1. Download & Install APK

Download the latest APK from the Releases page.

Option A: Via ADB (Fastest)

adb install -r path/to/AndroidTVBluetooth.apk

Option B: Manual (No PC needed)

1. Transfer the APK to your TV (using a USB drive or a "Send Files to TV" app).
2. Open your TV's File Explorer and select the APK to install.
3. If prompted, allow "Install from Unknown Sources".

2. Grant Permissions

Option A: Via ADB

adb shell pm grant com.saihgupr.btcontrol android.permission.BLUETOOTH_CONNECT

Option B: Manual (On TV)

1. Go to your TV's Settings > Apps > See all apps.
2. Find AndroidTV Bluetooth Controller.
3. Select Permissions and ensure Nearby Devices (Bluetooth) is allowed.

3. Initialize

Launch the AndroidTVBluetooth app manually on your TV one time to move it out of the system's "stopped" state. You can close it immediately after.

---

Alternative: Build from Source

If you prefer to build it yourself:

./gradlew assembleDebug
adb install -r app/build/outputs/apk/debug/AndroidTVBluetooth.apk

Troubleshooting

If connection fails, check logcat to see which devices the TV detects:

adb logcat -d | grep "BtManagerHelper"

This will print a list of paired devices if your specified name was not found.

---

Support the Project

This project is open-source and free. If you find it useful, consider giving it a star ⭐ or making a donation to support development.