From 9114b8485df2e7055f35e436878043580504e5ba Mon Sep 17 00:00:00 2001 From: Brandon Harvey <8107750+bharvey88@users.noreply.github.com> Date: Wed, 29 Apr 2026 16:42:29 -0500 Subject: [PATCH] Update M-1 ESPHome docs: WizMote, Media Proxy repo links, advanced admonition (#756) - Add WizMote Remote subsection under Optional Features covering pairing via the WizMote Auto-Discovery switch and the default button mapping. - Reword the ESPHome Device Builder admonition to reflect that adopting is required for advanced customization (optional pages, multi-panel, WizMote button rebinding) rather than a generic "advanced YAML edits" pointer. - Update Media Proxy GitHub links to the new pavlov-net/media-proxy home in both getting-started-m1-esphome.md and examples/media-proxy.md. Co-authored-by: Brandon Harvey --- docs/products/m1/examples/media-proxy.md | 4 +-- .../m1/setup/getting-started-m1-esphome.md | 26 ++++++++++++++++--- 2 files changed, 24 insertions(+), 6 deletions(-) diff --git a/docs/products/m1/examples/media-proxy.md b/docs/products/m1/examples/media-proxy.md index dfd655449..a06811e9f 100644 --- a/docs/products/m1/examples/media-proxy.md +++ b/docs/products/m1/examples/media-proxy.md @@ -4,7 +4,7 @@ description: Stream GIFs, YouTube videos, still images, and album art to your M- --- # Media Proxy -The Media Proxy is a Home Assistant add-on that takes almost any media URL, resizes and decodes it for your panel, and streams the result to the M-1 over the network. It's how the M-1 ESPHome firmware plays animated GIFs, YouTube videos, still images, and album art on a 64x64 panel without you having to convert anything by hand. +The Media Proxy is a Home Assistant add-on that takes almost any media URL, resizes and decodes it for your panel, and streams the result to the M-1 over the network. It's how the M-1 ESPHome firmware plays animated GIFs, YouTube videos, still images, and album art on a 64x64 panel without you having to convert anything by hand. !!! tip "Need to install it first?" @@ -53,6 +53,6 @@ Once Media Proxy is installed and running, all of these things are driven from a ## Going further -- The Media Proxy README covers fit modes, autocrop tuning, hardware acceleration setup, and the YAML config file if you want to tweak how content gets resized or decoded. +- The Media Proxy README covers fit modes, autocrop tuning, hardware acceleration setup, and the YAML config file if you want to tweak how content gets resized or decoded. - The homeassistant-addons repo is the home of the Media Proxy add-on itself, including release notes and install troubleshooting. - If you need to (re)install Media Proxy, the steps live on the M-1 ESPHome Getting Started page. diff --git a/docs/products/m1/setup/getting-started-m1-esphome.md b/docs/products/m1/setup/getting-started-m1-esphome.md index dd034fe9c..148f7a33d 100644 --- a/docs/products/m1/setup/getting-started-m1-esphome.md +++ b/docs/products/m1/setup/getting-started-m1-esphome.md @@ -62,9 +62,9 @@ Head to the ESPHome Device Builder add-on to customize its YAML configuration (custom effects, additional sensors, etc.). This is **not required** for normal use, skip this section unless you specifically want to edit the firmware configuration. + Adopting the M-1 into the ESPHome Device Builder add-on lets you edit its YAML configuration. This is needed if you want to enable optional pages (Team Tracker, QR Codes, MSR-2 Radar, additional Now Playing instances), drive multiple chained panels, or change which pages the WizMote scene buttons map to. See the hub75-studio Customization wiki for the full list. **Skip this section if the default firmware already does everything you need.** 1\. Install the ESPHome Device Builder inside Home Assistant OS by clicking the button below. Make sure to toggle on start on Boot, Watchdog, and Show in sidebar. @@ -96,7 +96,7 @@ wifi_password: "your-wifi-password-here" ###### Media Proxy -The Media Proxy app allows you to view gifs, still images, youtube videos, and even use Sendspin with album art when using Music Assistant! +The Media Proxy app allows you to view gifs, still images, youtube videos, and even use Sendspin with album art when using Music Assistant! 1\. Head to settings -> Apps -> Click Install App -> 3 dots -> click repositories -> click Add -> paste in https://github.com/stuartparmenter/homeassistant-addons @@ -116,4 +116,22 @@ The WiZ WizMote remote, so you can change pages, dim the panel, and toggle it on/off without your phone. + +1\. In Home Assistant, open the M-1 device on the ESPHome integration page. + +2\. Find the **WizMote Auto-Discovery** switch and turn it on. + +3\. Press any button on your WizMote. The M-1 picks up the WizMote's MAC and pairs automatically. + +4\. Confirm pairing by checking the **WizMote Status** entity. It should read **Paired** along with the WizMote's MAC address. + +!!! example "Default button mapping" + + - **On / Off / Night**: turn the panel on, off, or drop to a minimum night-mode brightness. + - **Brightness Up / Down**: adjust panel brightness in steps. + - **Scene buttons 1-4**: jump to **Clock**, **Visual Effects**, **Pong**, and **Media Stream**, in that order. \ No newline at end of file