homebridge-androidboxtv

Source code and issues: fabiofcmota/homebridge-plugin-androidboxtv

Installation

1. Install Homebridge by following the instructions.
2. Install this plugin using Homebridge Config UI X, or by running npm install -g homebridge-androidboxtv.
3. Connect to http://localhost:8182 and pair detected devices with shown secret code
4. On HomeKit app tap on 'Add accessory'
5. Enjoy ;-)

Configuration

You can configure channels, keys and applications (don't hesitate to create an HomeKit Scene to launch them by voice)

Minimal platform configuration:

{
  "platform": "HomebridgeAndroidBoxTV",
  "port": 8182
}

For channels, we always consider TV App as the first on the list channel shown after a 'Home' tap on regular remote

Example for French TV :

{
   "channels": [
      {"name": "TF1", "number": 1}, 
      {"name": "France 2", "number": 2}, 
      {"name": "France 3", "number": 3}, 
      {"name": "France 5", "number": 5}, 
      {"name": "M6", "number": 6}, 
      {"name": "Arte", "number": 7}, 
      {"name": "LCP", "number": 13}, 
      {"name": "BMF TV", "number": 15},
      {"name": "CNEWS", "number": 16}, 
      {"name": "LCI", "number": 26}, 
      {"name": "France Info", "number": 27}
   ]
}

Example for keys :

{
   "keys": [
      {"name": "Power", "key": "KEYCODE_POWER"},
      {"name": "VolUp", "key": "KEYCODE_VOLUME_UP"},
      {"name": "VolDown", "key": "KEYCODE_VOLUME_DOWN"},
      {"name": "Home", "key": "KEYCODE_HOME"},
      {"name": "Mute", "key": "KEYCODE_MUTE"}
   ]
}

Key code are listed here:

• android.com/reference/android/view/KeyEvent
• androidtv-remote/src/remote/remotemessage.proto#L88

Example for populars applications :

{
   "applications": [
      {"name": "Netflix", "link": "https://www.netflix.com/title.*", "package": "com.netflix.ninja"},
      {"name": "OQEE", "link": "https://oq.ee/home/", "package": "net.oqee.androidtv"},
      {"name": "Disney+", "link": "https://www.disneyplus.com", "package": "com.disney.disneyplus"},
      {"name": "Amazon Prime", "link": "https://app.primevideo.com", "package": "com.amazon.amazonvideo.livingroom"}
   ]
}

package is optional for launching an application, but is required to mirror an application opened directly on the Android box back to HomeKit. The value must match the Current application value written to the Homebridge log.

The Android TV remote protocol reports the foreground application, not the live TV channel playing inside that application. Channel changes made through this plugin are reflected optimistically; detecting channel changes made elsewhere requires an API supplied by the TV application/provider.

Additional configurations can be documented in the project Wiki.