homebridge-hdfury-vrroom
TypeScript icon, indicating that this package has built-in type declarations

1.0.5 • Public • Published

Homebridge HDFury Vrroom Plugin

This plugin allows you to control your HDFury Vrroom HDMI Matrix Switch through Apple HomeKit, enabling you to switch inputs for each output using the Home app.

Features

  • Control multiple outputs (TX0, TX1)
  • Switch between HDMI inputs (0-3)
  • Real-time status updates through polling
  • Input availability detection (5V sensing)

Installation

npm install -g homebridge-hdfury-vrroom

Configuration

Add this to your Homebridge config.json:

{
    "platforms": [
        {
            "platform": "HDFuryVrroom",
            "name": "HDFury Vrroom",
            "host": "vrroom-XX",  // Your Vrroom IP or hostname
            "inputs": [
                {
                    "name": "Apple TV",  // Input name in HomeKit
                    "port": 0  // HDMI input (0-3)
                },
                {
                    "name": "PlayStation",
                    "port": 1
                }
                // Add more inputs as needed
            ],
            "outputs": [
                {
                    "name": "Living Room TV",  // Display name in HomeKit
                    "tx": 0  // Output (0 or 1)
                },
                {
                    "name": "Bedroom TV",
                    "tx": 1
                }
            ]
        }
    ]
}

Configuration Options

  • host: Your Vrroom's IP address or hostname (required)
  • inputs: Array of input configurations
    • name: Display name for the input in HomeKit
    • port: HDMI input number (0-3)
  • outputs: Array of output configurations (required)
    • name: Display name for the output in HomeKit
    • tx: Output number (0 or 1)

Development

  1. Clone the repository:
git clone https://github.com/rijnbeek/hdfury-vrroom.git
cd hdfury-vrroom
  1. Install dependencies:
npm install
  1. Build the plugin:
npm run build
  1. Link for development:
npm link
  1. Watch for changes:
npm run watch

Troubleshooting

  1. Enable debug logging by starting Homebridge with:
homebridge -D
  1. Check the Vrroom's network connectivity:
ping vrroom-XX
  1. Verify the Vrroom's web interface is accessible at http://vrroom-XX

Support & Donation

If you find this plugin helpful, consider supporting its development:

"Buy Me A Coffee"

License

Apache-2.0 - see LICENSE file for details.

Package Sidebar

Install

npm i homebridge-hdfury-vrroom

Weekly Downloads

8

Version

1.0.5

License

Apache-2.0

Unpacked Size

66.3 kB

Total Files

28

Last publish

Collaborators

  • rijnbeek