Skip to content
Grzegorz edited this page Feb 3, 2024 · 4 revisions

Welcome to the homebridge-xbox-tv wiki!

Note

  • For v1.4.0 and above the required version of Homebridge >= 1.3.x.
  • For v2.0.0 and above the required version of Node.js >= 14.x.x.
  • If upgrade from 1.x.x to 2.x.x the xboxLiveId need to be set again.

Know Issues

  • Console connected to WLAN network some times lose its connection to the network after Power OFF and the Power ON command may not work.

Troubleshooting

  • If for some reason the device is not displayed in HomeKit app try this procedure:
    • Using Config UI:
      • Go to Homebridge Settings >> Reset Options >> Disconnect Bridge/Camera/TV/External Accessories.
      • Remove the AVR child bridge and the accessory, restart homebridge and try to add it again.
    • Alternative method:
      • Go to ./homebridge/persist macOS or /var/lib/homebridge/persist for RPI.
      • Remove AccessoryInfo.xxx file which contain Your device data: {"displayName":"Xbox"}.
      • Next remove IdentifierCashe.xxx file with same name as AccessoryInfo.xxx.
      • Restart Homebridge and try add it to the HomeKit app again.

Adding to HomeKit

  • Each accessory needs to be manually paired.
    • Open the Home app on your device.
    • Tap the Home tab, then tap .
    • Tap Add Accessory, and select I Don't Have a Code, Cannot Scan or More options.
    • Select Your accessory and press add anyway.
    • Enter the PIN or scan the QR code, this can be found in Homebridge UI or Homebridge logs.
    • Complete the accessory setup.

Limitations

  • That maximum Services for 1 accessory is 100. If Services > 100, accessory stop responding.
  • To solve this problem the plugin counts the number of Services and not allow add more as 100.
  • If You have configured more as 100 Services some inputs or buttons will not be available in the HomeKit app.
  • The Services in this accessory are:
    • Information, 1 service.
    • Speaker, 1 service.
    • Lightbulb, 1 service.
    • Fan, 1 service.
    • Television, 1 service.
    • Sensors, each sensor is 1 service.
    • Inputs, each input is 1 service.
    • Buttons, each button is 1 service.

Development

  • Pull request and help in development highly appreciated.
Clone this wiki locally