A HomeBridge plugin to control remote ADB enabled Android device. The idea is to make random Android based TV box can be controlled with Home App. It make any Android device appear as TV accesory. Where you can control on/off status, volume and dpad control via Control Center remote, and launch certain predefined app defined in the configuration.
This plugins register it self as external accesorries. Make sure after adding Homebridge bridge in Home App, manually "add accesories" to add the android device in the Home App.
Prerequisite
Install Homebridge, Homebridge Config UI X (this plugin support web configuration over there), and this plugins
Install ADB tools inside Homebridge server. Open Homebridge Config UI X in your browser then navigate to terminal or ssh to your homebridge server, and then run this command:
If the homebridge server run inside Ubuntu, use this command:
IMPORTANT: Some Android device doesn't support "Remote ADB" by default. If your device is one of them, connect your device with USB cable to any computer with ADB installed. Open terminal and run this command:
adb tcpip 5555
if no error produced, disconnect unplug the USB cable from the computer.
OPTIONAL Run this command to make sure you can connect to device:
adb connect your-device-ip
If all goes well, there will be a popup window in your android device asking for debug permission. After you accept the request, you might want to do kill the adb server to make a fresh connection
adb kill-server
After that reconnect your device again with previous adb connect. Test your adb connection by running this command:
MANDATORY If you're using a container based on Alpine Linux (like oznu/docker-homebridge:latest), run this command in terminal to install adb
# Install adb, required by the homebridge-adb pluginecho'http://dl-cdn.alpinelinux.org/alpine/v3.14/main/'>> /etc/apk/repositories
echo'http://dl-cdn.alpinelinux.org/alpine/v3.14/community/'>> /etc/apk/repositories
apk add android-tools
You can use other version of repo, but I only tested the v3.14 repo, and it seems it's the only adb tools that work with oznu/docker-homebridge .
MANDATORY If you're using a container based on Debian (like the oznu/docker-homebridge:ubuntu & oznu/docker-homebridge:debian docker image), run this command in terminal to install adb
# Update apt package index
apt-get update
# Install adb, required by the homebridge-adb plugin
apt-get install -y android-tools-adb android-tools-fastboot
OPTIONAL Append the followings line to your config/startup.sh to install or update this plugin on every container restart:
# Install the homebridge-adb plugin
npm install homebridge-adb
OPTIONAL If you run into issues when connecting your android device (sometimes adb can't create the $HOME/.android/adbkey), add this line to your config/startup.sh:
# Fix connection issues for the homebridge-adb plugin
adb connect YOUR_ANDROID_DEVICE_IP
Configuration
Here an example of configuration that you can use.
accessories (mandatory): JSON object of your devices.
name (mandatory): the name of the accessory.
ip (mandatory): the IP address of the accessory.
mac (optional): the MAC address of the accessory. When provided and your accessory support Wake On LAN, this plugin will try to use Wake On LAN to Turn On your accessory. Useful if your accessory disconnect ADB connection after it turned off.
path (optional): if you prefer using direct path to access ADB instead of setting up in your global path, you can type the path here including the executable filename.
interval (optional): if not set, the plugin will check accessory statuses every 1000 miliseconds. The minimum interval value is 500. Lower then that, the plugin will flood your network.
timeout (optional): if not set, the plugin will limit ADB execution timeout to 3000 miliseconds. The minimum timeout value is 1000. Smaller value can make plugins more responsive but will prone to time out especially when your network is slow.
inputs (optional): by default the plugins will create Home for launcher shortcut and Other for previous app shortcut as input. If set, the plugins will add more input based on the config. To know your app id, please see your Homebridge log. When you leave this blank, and set hidehhome and hideother to true, the plugins will hide inputs in Home App.
name (mandatory): the name of the input.
id (mandatory): the application id. The id will be use for input switcher in Home app. If you put random id, the input will move to "other".
adb (optional): you can run your own ADB shell command here, such as: monkey -p com.app.id 1. This is an ADB shell command, so you doesn't need to type "adb -s ipaddress shell ...".
playbacksensor (optional): if set to true, plugin will create a motion sensor based on playback activity (either video or music).
category (optional): you can choose from this categories: APPLE_TV, TELEVISION, TV_STREAMING_STICK, TV_SET_TOP_BOX, AUDIO_RECEIVER, or SPEAKER. Home app will display different icon based on the category you choose.
volumeup, volumedown, upbutton, leftbutton, rightbutton, leftbutton, infobutton, playpauseobutton, backbutton, poweron, poweroff (optional): assign custom ADB keycode for Remote control action in iOS Control Center.
You can put a ADB shell script to run a shell script inside your device, eg: leftbutton: "monkey -p com.termux 1". Or,
You can also put a shell script. Put shell identifier to let the plugins know it's a shell script, eg: volumeup: "shell sh ./myscript.sh".
hidenumber (optional): if set to true, plugin will hide number inputs in Home App.
hidehome (optional): if set to true, plugin will hide "Home" input in Home App.
hideother (optional): if set to true, plugin will hide "Other" input in Home App.
debug (optional): if set to true, plugin will output more debug info in homebridge log.
skipSpeaker (optional): if set to true, an accompanying speaker will not be initialized for the device and will disable volume control in Control Center Remote.
If you're using Homebridge Config UI X, you can configure your device there, but there's a small hiccup with Inputs. It only display one input, but if you press add, it will display the rest of the inputs.
Questions and Support
If your have any question, refer to FAQ.md first before sending GitHub issues.
There is currently an Android TV homebridge plugins that work with "Android TV remote control protocol version 2", it should have simpler setup. You can check the plugin here and see if it's work with your device. However, it will only work with Android TV devices, not every Android devices. Note: I'm not the contributor of the that plugin.
请发表评论