Merge request branch dev into main via CloudCannon

docs/products/m1/examples/sendspin.md

@@ -4,8 +4,20 @@ description: Use the M-1 with SendSpin audio visualizers
 ---
 # SendSpin
 
-[SendSpin](https://www.sendspin-audio.com/) is an audio visualization platform that pairs well with the M-1 running the [hub75-studio](https://github.com/pavlov-net/hub75-studio) ESPHome firmware.
+[SendSpin](https://www.sendspin-audio.com/) is an open standard for syncing music across multiple devices. Although this is primarily used by music players like homepods or the <a href="https://www.home-assistant.io/voice-pe/" target="_blank" rel="noreferrer nofollow noopener">HA Voice PE</a>, the Apollo M-1 LED Matrix can display your album art automagically. Pairs well with the M-1 running the [hub75-studio](https://github.com/pavlov-net/hub75-studio) ESPHome firmware. Further, when paired with a <a href="https://www.amazon.com/WiZ-Remote-Compatible-Lights-Assistant/dp/B091TGDS6F" target="_blank" rel="noreferrer nofollow noopener">Wizmote</a>, you're able to do things like turn the panel on/off, control the volume (buttons 1 and 2), pause/play, previous/next track (buttons 3 and 4), and brightness. This remote support requires editing the yaml at this time but will be getting easier soon!
 
-!!! info "More details coming soon"
+!!! success "Your device needs to be running the ESPHome firmware to use Sendspin."
 
-    Step-by-step setup for SendSpin on the M-1 will be added here. For now, head to <a href="https://www.sendspin-audio.com/" target="_blank" rel="noreferrer nofollow noopener">https://www.sendspin-audio.com/</a> to learn more about SendSpin.
+    If you have a stock M-1 LED Matrix you will be on the WLED-MM firmware. You will need to <a href="https://wiki.apolloautomation.com/products/m1/setup/getting-started-m1-esphome/" target="_blank" rel="noreferrer nofollow noopener">follow this tutorial</a> to switch to the ESPHome firmware!
+
+1\. You will need to be running <a href="https://www.music-assistant.io/" target="_blank" rel="noreferrer nofollow noopener">Music Assistant</a> which has Sendspin baked in! Click the button below to install it on your Home Assistant OS setup.
+
+[![Open your Home Assistant instance and show the dashboard of a Supervisor add-on.](https://my.home-assistant.io/badges/supervisor_addon.svg)](https://my.home-assistant.io/redirect/supervisor_addon/?addon=d5369777_music_assistant&amp;repository_url=https%3A%2F%2Fgithub.com%2Fmusic-assistant%2Fhome-assistant-addon)
+
+!!! success "This tutorial expects you to already have music providers and players setup."
+
+    Make sure you have already followed the Music Assistant onboarding and setup a music provider or multiple and added some players to play music on. Your M-1 will already be shown as a sendspin player if you are running the ESPHome firmware. <a href="https://wiki.apolloautomation.com/products/m1/setup/getting-started-m1-esphome/" target="_blank" rel="noreferrer nofollow noopener">Click here</a> to get your M-1 running ESPHome firmware first!
+
+2\. Head to the <a href="http://homeassistant.local:8123/d5369777_music_assistant" target="_blank" rel="noreferrer nofollow noopener">Music Assistant dashboard</a> and select one of your media players. Then click the players icon then click the players icon again and check off your Apollo M-1 LED Matrix.
+
+![](../../../assets/sendspin-add-m-1-as-player.gif)

docs/products/m1/setup/getting-started-m1-esphome.md

@@ -116,22 +116,30 @@ The <a href="https://github.com/pavlov-net/media-proxy" target="_blank" rel="nor
 
 ![](../../../assets/matrix-gif-example.gif)
 
-[Click here to learn what all you can do with the Media Proxy!](https://wiki.apolloautomation.com/products/m1/examples/media-proxy/){ .md-button .md-button--primary }
+[Click here to learn what all you can do with the Media Proxy!](https://wiki.apolloautomation.com/products/m1/examples/media-proxy/){    .md-button .md-button--primary }
 
 ###### WizMote Remote
 
-The M-1 ESPHome firmware has built-in support for the <a href="https://www.wizconnected.com/en-us/p/accessory-wizmote/8718699788209" target="_blank" rel="noreferrer nofollow noopener">WiZ WizMote</a> remote, so you can change pages, dim the panel, and toggle it on/off without your phone.
+The M-1 ESPHome firmware has built-in support for the <a href="https://www.amazon.com/WiZ-Remote-Compatible-Lights-Assistant/dp/B091TGDS6F" target="_blank" rel="noreferrer nofollow noopener">WiZ WizMote</a> 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 <a href="http://homeassistant.local:8123/config/integrations/integration/esphome" target="_blank" rel="noreferrer nofollow noopener">ESPHome integration page</a>.
 
 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.
 
+![](../../../assets/wizmote-pairing-example.gif)
+
 4\. Confirm pairing by checking the **WizMote Status** entity. It should read **Paired** along with the WizMote's MAC address.
 
-!!! example "Default button mapping"
+![](../../../assets/wizmote-pair-successful.png)
+
+!!! tip "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.
+
+    <a href="https://github.com/pavlov-net/hub75-studio/wiki/Customization#configuring-page-navigation" target="_blank" rel="noreferrer nofollow noopener">Visit the documentation page</a> to learn how to configure the buttons to do anything you want!
 
-    - **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.
+[Click here to learn how to use your new remote with SendSpin!](https://wiki.apolloautomation.com/products/m1/examples/sendspin/){ .md-button .md-button--primary }