Roomie Remote plugin for Indigo

Integrates Roomie Remote into Indigo via Roomie's Local Network Control HTTP API. Each Roomie Room becomes an Indigo device whose states track the room's currently-running activity, and Indigo actions can start activities, power rooms off, and send remote button presses.

Features at a Glance

• One Indigo device per Roomie room, showing the current activity in the device list at a glance ("Watch Apple TV", "Off", ...).
• Optional relay-style activity devices (on = that activity is running; turn on/off to start the activity or power off the room).
• Automatic device creation: rooms get Indigo devices the first time they are seen (configurable, and deleted devices are not re-created behind your back).
• Actions: Start Activity (with activity picker), Power Off Room, Press Remote Button (full symbolic button set, repeat taps, channel digits), Run Activity by UUID (scripting escape hatch), Refresh Status.
• Trigger-friendly states: currentActivityName, onOffState, controllerReachable — with disciplined state updates so triggers only fire on real changes.
• Graceful degradation with exponential backoff when the Roomie controller is asleep or unreachable; devices show an "unreachable" error state.

Requirements

• Indigo 2025.1 or later.
• Roomie Remote X 10.3 or later with an active subscription that includes Local Network Control.
• Local Network Control enabled in Roomie's settings on the Primary Controller device.
• The Primary Controller must stay running with Roomie in the foreground — the API is served by the Roomie app itself. A dedicated always-on controller (e.g. an iPad in Guided Access / Single App Mode, or an Apple TV) is strongly recommended.
• A static IP or DHCP reservation for the controller is strongly recommended.

Installation

1. Download the latest release and double-click Roomie Remote.indigoPlugin on your Indigo server, or install via the Indigo plugin store when available.
2. In the plugin config dialog, enter the Roomie controller's IP address (port stays 47147 unless you changed it in Roomie).
3. On the first successful connection the plugin creates an Indigo device for each Roomie room (in a "Roomie Remote" device folder).

Plugin Configuration

Devices & States

Roomie Room (roomieRoom) — one per Roomie room.

A room whose current activity is an off-type ("System Off") is treated as off: onOffState false, empty activity UUID/name. This keeps triggers simple ("became off") instead of matching magic activity names.

Roomie Activity (roomieActivity) — optional relay-style device bound to one activity in one room; create them manually for the activities you care about, or enable the auto-create-activity-devices checkbox to get one per visible activity. The device is on while that activity is the room's current activity. Indigo's standard device controls map naturally: Turn On starts the activity, Turn Off powers off the room, Toggle does what you'd expect. This makes control pages and activity-level triggers trivial — no state matching needed.

Actions

• Start Activity — pick from the room's activities (toggle activities appear as separate "(On)"/"(Off)" entries). Optional delay (min 1.0s, a Roomie API requirement).
• Power Off Room — asks Roomie to resolve the correct off behavior for the room. A room that is already off is a no-op, not an error.
• Press Remote Button — symbolic buttons grouped by function (power, activity, volume, channel, transport, cursor, numeric, color, extended), with optional repeat taps (1–25) and channel digits. Buttons are resolved against the room's current activity by Roomie.
• Run Activity by UUID — plugin-level action for scripting and edge cases (activities in rooms without an Indigo device). Supports the toggle-state override and delay.
• Refresh Status — force an immediate poll. Indigo's standard device "Status Request" does the same.

Menu Items

• Test Connection — logs reachability and the room count.
• Dump Rooms & Activities to Log — pretty-prints every room and activity with UUIDs (toggle and off-type activities flagged). This is where you get UUIDs for Run Activity by UUID.
• Create Devices for All Rooms — creates Indigo devices for any rooms that don't have one (including ones you previously deleted).
• Force Refresh All — immediate poll with a full (non-diffed) state push.
• Toggle Debug Logging — temporary debug logging without opening the config dialog.

Triggers

No custom trigger types are needed — standard Indigo device-state triggers cover the use cases:

• "Living Room activity became Watch Apple TV" → state currentActivityName becomes value.
• "Any room turned off" → onOffState becomes false.
• "Controller went unreachable" → controllerReachable becomes false.

Troubleshooting

• "unreachable" on all devices / connection test fails: the Roomie API only answers while the Roomie app is running (foregrounded) on the Primary Controller with Local Network Control enabled. Check curl http://<controller>:47147/api/v1/rooms from the Indigo server — if the port is closed, wake the controller / re-enable Local Network Control.
• Room device shows "room not found": the room was deleted in Roomie (or the plugin is pointed at a different Roomie home). Delete the Indigo device or recreate the room.
• Activity picker is empty: the plugin hasn't reached the controller yet; use "Refresh Room List" / check the connection.

Development

See CLAUDE.md for architecture and workflow. Tests: python -m pytest (the indigo module is stubbed; no Indigo server needed).