Merge pull request #1213 from ApolloAutomation/dev

Sync dev to main: CAST PRO-1 Music Assistant setup step, shared WizMote blueprint name

Author: Bunton33

docs/products/cast1/examples/wizmote-blueprint.md

@@ -1,10 +1,10 @@
 ---
 title: CAST-1 WizMote control
-description: Control your CAST-1 with a WizMote using the Apollo CAST-1 WizMote blueprint in Home Assistant.
+description: Control your CAST-1 with a WizMote using the Apollo CAST-1 and CAST PRO-1 WizMote blueprint in Home Assistant.
 ---
 # WizMote control
 
-A WizMote gives you physical control over playback on your CAST-1. The **Apollo CAST-1 WizMote** blueprint maps each of the nine buttons to a playback action, a light toggle, or any Home Assistant action you want, all set up without leaving Home Assistant.
+A WizMote gives you physical control over playback on your CAST-1. The **Apollo CAST-1 and CAST PRO-1 WizMote** blueprint maps each of the nine buttons to a playback action, a light toggle, or any Home Assistant action you want, all set up without leaving Home Assistant.
 
 Every button ships with a sensible default, so your WizMote works the moment you import the blueprint. Open any button's dropdown to change it, or set one to **Send HA Event** to run a custom action like playing a Music Assistant playlist.
 
@@ -53,7 +53,7 @@ You'll import the blueprint, pick your device, and choose what each WizMote butt
 
 2\. Click **Preview** then click **Import Blueprint**.
 
-3\. Click on **Apollo CAST-1 WizMote**, then click **Select a device** and choose your **Apollo CAST-1** from the dropdown.
+3\. Click on **Apollo CAST-1 and CAST PRO-1 WizMote**, then click **Select a device** and choose your **Apollo CAST-1** from the dropdown.
 
 4\. Every button already has a default, so your WizMote works right away. To change one, open its dropdown and pick a different action.
 

docs/products/castpro1/additional-info/analog-in.md

@@ -22,6 +22,16 @@ The **Analog In (Line In)** jack on your CAST PRO-1 turns any line-level source
 
 ![Plugging a USB-C power cable into the CAST PRO-1, then a 3.5mm cable into the Analog In jack](/assets/cast-pro-1-plug-in-audio-in.webp)
 
+## Set it up in Music Assistant
+
+Do this once, so Music Assistant can use your CAST PRO-1's Analog In. If you already did it in the [Getting Started guide](../setup/getting-started.md#stream-to-your-cast-pro-1), skip ahead.
+
+1\. Open **Music Assistant**. If your CAST PRO-1 shows **Setup required**, click it. You can also click **Review** on the **A new device was discovered that needs to be set up** banner, then **Start setup**.
+
+2\. Under **How do you want to connect?**, choose **Connect unpaired with audio input**. It's one click with no code.
+
+No **Setup required** on your CAST PRO-1? It's already set up, so go on to the next step.
+
 ## Play it in Music Assistant
 
 !!! warning "Your CAST PRO-1 plays through Optical while its Analog In streams"
@@ -65,7 +75,8 @@ Changing it restarts your CAST PRO-1, which stops anything playing on it.
 **The Sendspin Source isn't in Music Assistant**
 
 - Check your CAST PRO-1 is on firmware 26.11.3.2 or newer, and Music Assistant on 2.10.7 or newer.
-- In Music Assistant, go to **Settings → Players** and open your CAST PRO-1. If it shows **Setup required**, select it to start the setup and choose **Connect unpaired with audio input**. If you picked **Connect unpaired without audio input** earlier, select **Turn on audio input**.
+- Set it up in Music Assistant first. See [Set it up in Music Assistant](#set-it-up-in-music-assistant).
+- If you chose **Connect unpaired without audio input** earlier, go to **Settings → Players** in Music Assistant, open your CAST PRO-1's settings, and select **Turn on audio input**.
 
 **No sound from the speakers on your CAST PRO-1**
 

docs/products/castpro1/examples/wizmote-blueprint.md

@@ -1,10 +1,10 @@
 ---
 title: CAST PRO-1 WizMote control
-description: Control your CAST PRO-1 with a WizMote using the Apollo CAST PRO-1 WizMote blueprint in Home Assistant.
+description: Control your CAST PRO-1 with a WizMote using the Apollo CAST-1 and CAST PRO-1 WizMote blueprint in Home Assistant.
 ---
 # WizMote control
 
-A WizMote gives you physical control over playback on your CAST PRO-1. The **Apollo CAST PRO-1 WizMote** blueprint maps each of the nine buttons to a playback action, a light toggle, or any Home Assistant action you want, all set up without leaving Home Assistant.
+A WizMote gives you physical control over playback on your CAST PRO-1. The **Apollo CAST-1 and CAST PRO-1 WizMote** blueprint maps each of the nine buttons to a playback action, a light toggle, or any Home Assistant action you want, all set up without leaving Home Assistant.
 
 Every button ships with a sensible default, so your WizMote works the moment you import the blueprint. Open any button's dropdown to change it, or set one to **Send HA Event** to run a custom action like playing a Music Assistant playlist.
 
@@ -49,18 +49,16 @@ You'll import the blueprint, pick your device, and choose what each WizMote butt
 
 1\. Click the Import Blueprint button below then click **Open link**.
 
-<!-- TODO: this links the CAST-1 blueprint. Confirm it lists CAST PRO-1 devices, or swap in a CAST PRO-1 blueprint URL and name. -->
-
 [![Open your Home Assistant instance and show the blueprint import dialog with a specific blueprint pre-filled.](https://my.home-assistant.io/badges/blueprint_import.svg)](https://my.home-assistant.io/redirect/blueprint_import/?blueprint_url=https%3A%2F%2Fraw.githubusercontent.com%2FApolloAutomation%2FBlueprints%2Frefs%2Fheads%2Fmain%2FCAST-1%2FCAST-1-WizMote.yaml)
 
 2\. Click **Preview** then click **Import Blueprint**.
 
-3\. Click on **Apollo CAST PRO-1 WizMote**, then click **Select a device** and choose your **Apollo CAST_PRO-1** from the dropdown.
+3\. Click on **Apollo CAST-1 and CAST PRO-1 WizMote**, then click **Select a device** and choose your **Apollo CAST_PRO-1** from the dropdown.
 
 4\. Every button already has a default, so your WizMote works right away. To change one, open its dropdown and pick a different action.
 
 5\. For any button set to **Send HA Event** (Buttons 3 and 4 by default), click **Add Action** below it and choose what it should do, like playing a Music Assistant playlist or toggling a light.
 
 6\. Name your automation something like **Apollo CAST PRO-1 WizMote** and click **Save**. Your WizMote now controls your CAST PRO-1!
 
-<!-- TODO image: /assets/cast-pro-1-import-blueprint.gif | alt: Importing the Apollo CAST PRO-1 WizMote blueprint and selecting a CAST PRO-1 in Home Assistant -->
+<!-- TODO image: /assets/cast-pro-1-import-blueprint.gif | alt: Importing the Apollo CAST-1 and CAST PRO-1 WizMote blueprint and selecting a CAST PRO-1 in Home Assistant -->

docs/products/castpro1/setup/getting-started.md

@@ -150,7 +150,7 @@ With Music Assistant running, you can start playing music through your speakers.
 
 2\. Your CAST PRO-1 appears in the player list in Music Assistant. Select it as your player.
 
-If it shows **Setup required**, select it to start the setup and choose **Connect unpaired with audio input**. Picking the option with audio input lets you play its [Analog In (Line In)](../additional-info/analog-in.md) later.
+If it shows **Setup required**, set it up once. Click it, or click **Review** on the **A new device was discovered that needs to be set up** banner and then **Start setup**. Under **How do you want to connect?**, choose **Connect unpaired with audio input**. It's one click with no code, and it lets you play the CAST PRO-1's [Analog In (Line In)](../additional-info/analog-in.md) later.
 
 3\. Pick any song, playlist, or radio station and it plays through the speakers connected to your CAST PRO-1.