npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

homebridge-zidoo-androidtv

v4.0.0

Published

Homebridge Plugin to control your Zidoo player.

Downloads

53

Readme

homebridge-zidoo-androidtv

HomeKit integration for Zidoo

verified-by-homebridge homebridge-zidoo-androidtv mit-license

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

  1. Connect the Zidoo device to the internet and get the IP address
  2. 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:

  1. Open the Home app on your device.
  2. Tap the Home tab, then tap .
  3. Tap Add Accessory, and select I Don't Have a Code or Cannot Scan or More Options... whichever is available.
  4. Select the accessory you want to pair.
  5. 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: 10000
  • modelName [optional] Model name of your device
  • manufacturer [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: false
  • mediaButtons [optional] Allows control the playback state of your device. Default: false
  • NameOfTheButton [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!!