DallasHoff / homebridge-openrgb

Control the RGB lighting of your PC components and peripherals with HomeKit.
https://www.npmjs.com/package/homebridge-openrgb
Apache License 2.0
13 stars 0 forks source link
homebridge homebridge-plugin homekit openrgb rgb

OpenRGB Homebridge Plugin

verified-by-homebridge npm Donate

This plugin allows you to integrate Homebridge with the OpenRGB lighting control software on your PC so that you can control the lighting of your PC's components and peripherals with HomeKit. Each RGB device is added to HomeKit as an RGB lightbulb that you can control with Siri, the Home app, scenes, automations, or however else you interact with your HomeKit smart home.

This solution works with PC hardware from the most popular brands like ASUS, Gigabyte, MSI, Corsair, Razer, Logitech, NZXT, and many more.

Installation

Install OpenRGB on your PC

OpenRGB is a software project that aims to replace the need to use several different RGB lighting control software programs from multiple vendors, allowing you to control all of your PC components' and peripherals' lighting with just one piece of software.

Follow OpenRGB's instructions for installing the software on your PC. Then, follow these instructions to configure OpenRGB to start automatically when you turn on your PC. Be sure to make use of the --server flag so that the OpenRGB SDK server starts on boot too. This plugin interacts with your PC's lighting through that server.

Install this Plugin on Homebridge

If you do not already have a Homebridge setup, follow Homebridge's setup guide to get up and running.

Now, you can install the homebridge-openrgb plugin through the Homebridge UI which will help you install and configure the plugin. Alternatively, install the plugin through NPM with:

npm install -g homebridge-openrgb

Configuration

Configure the plugin so that it knows where to connect to your PC(s) running the OpenRGB SDK server. You can do this through the Homebridge UI or add the configuration to the platforms array in the configuration file at ~/.homebridge/config.json

Configuration Fields:

Typically, a computer's IP address will change periodically, so I recommend using your PC's hostname to configure this plugin's host field. On Windows, you can run the hostname command from the command line to view your PC's name. Your hostname will then be that name, lowercase, with .local appended to the end. Alternatively, you could configure your router to reserve a specific IP address for your PC and use that in the host field.

Example Configuration:

{
  "platforms": [
    {
      "platform": "OpenRgbPlatform",
      "name": "OpenRGB",
      "servers": [
        {
          "name": "John's Computer",
          "host": "johns-computer.local",
          "port": 6742
        },
        {
          "name": "Jane's Computer",
          "host": "janes-computer.local",
          "port": 6742
        }
      ],
      "discoveryInterval": 60,
      "preserveDisconnected": false,
      "suppressConnectionErrors": false
    }
  ]
}