Home Assistant Add-on: Media Proxy

WebSocket-controlled media proxy that outputs DDP (UDP)

About

Stream videos, GIFs, still images, and YouTube content to tiny LED/LCD displays (e.g., ESPHome devices using DDP) with smart resizing, optional color-range expansion, and packet pacing.

This Home Assistant add-on provides a WebSocket control API and pushes pixel data over UDP using the DDP format, designed to work with ESPHome devices and other LED/LCD displays.

Documentation

For complete documentation, configuration options, API reference, and usage examples, see the main repository:

📖 Full Documentation

Installation

This add-on is part of the Stuart Parmenter Home Assistant Add-ons repository. To install:

1. Add the repository URL to your Home Assistant instance:

2. Search for the "Media Proxy" add-on and click it.

3. Click on the "INSTALL" button.

Quick Start

1. Start the add-on
2. The WebSocket control API will be available at ws://your-ha-ip:8788/control
3. Use the API to stream content to your LED/LCD displays
4. See the main documentation for API details and ESPHome integration examples

Custom Configuration

The addon reads configuration files from /addon_configs/2b3c960e_media_proxy/ on your Home Assistant host. To create and edit these files:

1. Install the File Editor addon from the Home Assistant addon store (found under Official add-ons)
2. Go to the File Editor addon configuration
3. Turn off "Enforce Basepath" to allow navigation outside the /homeassistant directory
4. Navigate to /addon_configs/2b3c960e_media_proxy/
5. Create a config.yaml file in this directory with your custom configuration

For configuration file format and options, see: Configuration Documentation

Alternatively, you can access these files directly if you have SSH access to your Home Assistant host.

ESPHome Integration

For ESPHome device integration examples, see: lvgl-ddp-stream

Support

GitHub Issues

License

MIT License - see LICENSE file for details.