homebridge-zidoo-androidtv
v4.0.0
Published
Homebridge Plugin to control your Zidoo player.
Downloads
38
Maintainers
Readme
homebridge-zidoo-androidtv
HomeKit integration for Zidoo
What is this?
homebrige-zidoo-androidtv
is a plugin for Homebridge to Control your Zidoo Z9X from your Home app. It should work with most Zidoo boxes.
Features
- HomeKit "TV Remote"
- HomeKit automations
- Turn TV on/off
- Play, Pause, and Stop switches
Optional Features
- Volume control (buttons or through iOS remote app)
- Media control
- Movie Progress control
- Navegation Control (Stateless switches)
- Input control
- The rests of the Remote buttons (Stateless switches)
Preparation
- Connect the Zidoo device to the internet and get the IP address
- To be able to turn on the devices it needds to be connected to the local network with an ethernet cable and get the LAN IP address and the LAN MAC address
Installation
install using the following command in terminal:
npm i homebridge-zidoo-androidtv
Configuration
Add the zidooPlugin
platform in config.json
in your home directory inside .homebridge
.
Example configuration:
{
"platforms": [
{
"name": "Zidoo Z9X",
"ip": "Youre IP Address",
"mac": "LAN MAC address",
"pollingInterval": 1000,
"modelName": "Z9X",
"manufacturer": "Zidoo Inc",
"serialN": "B210U71647033894",
"autoIPMac": false,
"mediaButtons": false,
"inputButtons":false,
"movieControl": false,
"<NameOfTheButton>": false,
"newPlatformUUID":false,
"platform": "zidooPlugin"
}
]
}
Adding the Zidoo to the Home app
Since HomeKit expects only one Zidoo per bridge they will be declared as external accessories and acts as a bridge.
This means that a device will not appear in your Home app until you add it!
To add the Zidoo to HomeKit follow this steps:
- Open the Home app on your device.
- Tap the Home tab, then tap .
- Tap Add Accessory, and select I Don't Have a Code or Cannot Scan or More Options... whichever is available.
- Select the accessory you want to pair.
- Enter the Homebridge PIN, this can be found under the QR code in Homebridge UI or your Homebridge logs, alternatively you can select Use Camera and scan the QR code again.
For more info check the homebridge wiki Connecting Homebridge To HomeKit.
Configuration
Platform Configuration fields
platform
[required] Should always be "zidooPlugin".
TV Configuration fields
name
[required] Name of your Zidoo.ip
[required] ip address of your TV.pollingInterval
[optional] The TV state background polling interval in seconds. Default: 10000modelName
[optional] Model name of your devicemanufacturer
[optional] The manufcturer of your device.serialN
[optional] Serial Number of your device. Set the IP address manually. Use this option if the device cannot be found automatically. Default: falsemediaButtons
[optional] Allows control the playback state of your device. Default: falseNameOfTheButton
[optional] Adds the button you want to add and can add as many as you want (refer to the button list bellow). Default: false
Button Name List is :
- cursorUpB
- cursorDownB
- cursorLeftB
- cursorRightB
- cursorEnterB
- homeMenuB
- backButtonB
- infoB
- popUpMenuB
- redB
- yellowB
- blueB
- greenB
- audioB
- subtitleB
- repeatB
- pipB
- resolutionB
- muteB
- recordB
- movieB
- musicB
- photoB
- fileB
- lightB
- screenshotB
- appSwitchB
Note: You can add buttons in the "Navagation Buttons" and "other Buttons" in Settings using Homebridge UI
newPlatformUUID
[optional] Enable this if you do not see the accessory when you try to add it to the Home App after deleting it. It will also create a different accesssory every time you chage the Name of the device in Settings. If an old accessory already exists in the Home App you will have to remove it manually. Default: false
Troubleshooting
If you have any issues with the plugin or Zidoo services then you can run homebridge in debug mode, which will provide some additional information. This might be useful for debugging issues.
Homebridge debug mode:
homebridge -D
Deep debug log, add the following to your config.json:
"deepDebugLog": true
This will enable additional extra log which might be helpful to debug all kind of issues. Just be aware that this will produce a lot of log information so it is recommended to use a service like https://pastebin.com/ when providing the log for inspection.
Note: Controls won't update if the plugin does not receive a confirmation message from the device.
Known Issues
Turning on the Zidoo device only works by Wake up On Land (WOL), so the device needs an ethernet connection in order to gain full control of the Zidoo device.
If Homebridge is restared the IP and MAC addresses are going to be lost so the devices needs to be turned on manually to recapture the IP and MAC addresses
Special thanks
To Fernando for his patience and support.
If you have any suggestions/improvements please let know.
Enjoy!!