Sofabaton Plugin for Indigo

Indigo plugin for the Sofabaton X2 universal remote hub. Control and monitor your Sofabaton activities via MQTT.

Requirements

• Indigo 2023.2+ (Python 3.10+)
• Sofabaton X2 hub with MQTT configured (via Sofabaton app)
• MQTT broker on your network (e.g. Mosquitto, or the Indigo MQTT Broker plugin)

Installation

1. Download Sofabaton.indigoPlugin from the latest release
2. Double-click to install in Indigo
3. Python dependencies (paho-mqtt, zeroconf) are installed automatically on first load

Setup

1. Configure your MQTT broker

The Sofabaton X2 hub connects to an external MQTT broker. Set this up in the Sofabaton app:

1. Open the Sofabaton app
2. Go to Add Device → Home Assistant
3. Enter your MQTT broker's IP address, port, and credentials

2. Configure the plugin

In Indigo, go to Plugins → Sofabaton → Configure:

• Broker Host — IP address of your MQTT broker
• Broker Port — Default 1883
• Username / Password — If your broker requires authentication

3. Discover your hub

Go to Plugins → Sofabaton → Discover Hub (mDNS)

The plugin will find your Sofabaton hub on the network, save the MAC address, connect to MQTT, and auto-discover all activities.

How It Works

Devices

The plugin creates two types of Indigo devices:

The hub device displays the current activity name directly in the Indigo device list — "Off" when nothing is active, or the activity name (e.g. "Watch TV").

Listening

The plugin subscribes to MQTT topics from the hub. When someone uses the physical Sofabaton remote to switch activities, Indigo updates automatically in real time:

• Activity relay devices flip on/off
• Hub device shows the new activity name
• Triggers can fire on activity changes

Controlling

You can control the Sofabaton from Indigo:

• Turn on/off activity devices to activate/deactivate activities
• Send key presses (volume, navigation, play/pause, etc.) to a specific activity or the current activity
• Send macro and favorite keys by ID
• Stop all activities with one action

Actions

Available Keys

Up, Down, Left, Right, OK, Back, Home, Menu, Volume Up, Volume Down, Channel Up, Channel Down, Mute, Guide, Rewind, Play, Fast Forward, DVR, Pause, Exit, Red, Green, Yellow, Blue, A, B, C

Menu Items

MQTT Topics

The plugin communicates with the hub via these MQTT topics (where {MAC} is the hub's 12-character hex MAC address):

Subscribe (from hub): - activity/{MAC}/list — Activity list - activity/{MAC}/activity_control_up — Activity state changes - activity/{MAC}/keys_list — Assigned keys - activity/{MAC}/macro_keys_list — Macro keys - activity/{MAC}/favorites_keys_list — Favorite keys

Publish (to hub): - activity/{MAC}/activity_control_down — Activate/deactivate activities - activity/{MAC}/keys_control — Send key presses - activity/{MAC}/macro_keys_control — Send macro keys - activity/{MAC}/favorites_keys_control — Send favorite keys

Troubleshooting

Hub not found via mDNS

• Ensure the Sofabaton hub and Indigo server are on the same network/VLAN
• The hub advertises as _sofabaton_hub._udp.local.

MQTT not connecting

• Verify the broker is running and accessible from the Indigo server
• Check broker credentials match what's configured in the Sofabaton app
• Check the Indigo Event Log for connection errors

Activities not appearing

• Ensure the hub is configured for MQTT in the Sofabaton app (Add Device → Home Assistant)
• Try Plugins → Sofabaton → Refresh Activities

License

MIT