florian-asche · florian-asche · Jul 26, 2026 · Jul 26, 2026 · Jul 26, 2026
diff --git a/02-stage-audiodriver-satellite1-v1.0/01-driver/03-run-chroot.sh b/02-stage-audiodriver-satellite1-v1.0/01-driver/03-run-chroot.sh
@@ -20,5 +20,5 @@ dpkg -i satellite1-rpi-setup_*_arm64.deb
 
 # 3. Install the Python SDK
 #echo "Download and install Python SDK"
-wget https://github.com/FutureProofHomes/Satellite1-RPi-SDK/releases/download/develop/satellite1-rpi-sdk_0.1.5_arm64.deb
+wget https://github.com/FutureProofHomes/Satellite1-RPi-SDK/releases/download/v0.1.6/satellite1-rpi-sdk_0.1.6_arm64.deb
 dpkg -i satellite1-rpi-sdk_*_arm64.deb
diff --git a/README.md b/README.md
@@ -10,11 +10,11 @@ PiCompose uses the official [pi-gen](https://github.com/RPi-Distro/pi-gen) tool
 
 The image is configured to:
 
-1. Install needed drivers for the hardware (2-MicHat)
+1. Install needed drivers for the hardware (2-MicHat, Satellite1)
 2. Start seeed-voicecard service (If you use 2-MicHat)
 3. Start Pipewire service
 4. Start Keep-Audio-Alive service (If you use Respeaker Lite)
-5. Set audio volume to 100%
+5. Set system audio volume to 100%
 6. Set hostname
 7. Search for Docker Compose files in a special directory on the main partition
    💡 **Note:** If you use the Linux-Voice-Assistant Image LVA and Snapcast will be included in the project directory.
@@ -36,7 +36,7 @@ This repository contains fully prepared images for specific voice hardware of Ho
 
 ### Hardware
 
-There is a seperated page for the supported hardware. You can find the link to it in the list below, when you click on the Name.
+There is a separate page for the supported hardware. You can find the link to it in the list below, when you click on the Name.
 
 ### Images overview
 
@@ -53,7 +53,11 @@ Here is a Overview for the specific images of each hardware:
 
 ### Installation
 
-You can burn the image to your sd card with the [Raspberry Pi Imager tool](https://www.raspberrypi.com/software/). You can set wifi credentials, ssh public keys and other settings before you burn the image to your sd card. In order to use the feature where you can change the settings in the `Raspberry Pi Imager >=v2.5.0` you need to set a custom image repository.
+You can burn the image to your sd card with the [Raspberry Pi Imager tool](https://www.raspberrypi.com/documentation/computers/getting-started.html#imager-install). You can set wifi credentials, ssh public keys and other settings before you burn the image to your sd card. In order to use the feature where you can change the settings in the `Raspberry Pi Imager >= v2.0` you need to set a custom image repository.
+
+💡 **Note:** If you use the Customisation" (sic) part of the "Raspberry Pi Imager tool", the "User" must be set to "pi".
+
+Windows, macOS, and Linux are supported. On macOS, you can use the Raspberry Pi Imager application or install it via Homebrew.
 
 Windows
 
@@ -67,9 +71,15 @@ Linux
 rpi-imager --repo https://github.com/florian-asche/PiCompose/releases/download/rpi-imager-json/rpi-imager.json
 ```
 
+macOS
+
+```sh
+rpi-imager --repo https://github.com/florian-asche/PiCompose/releases/download/rpi-imager-json/rpi-imager.json
+```
+
 You can also put the [URL](https://github.com/florian-asche/PiCompose/releases/download/rpi-imager-json/rpi-imager.json) in Settings - Image Repository - Use own URL.
 
-If you dont want to use the Raspberry Pi Imager tool you can also [download](https://github.com/florian-asche/PiCompose/releases) the image and configure keyboard, timezone and wifi credentials with the `raspi-config` tool.
+If you don't want to use the Raspberry Pi Imager tool you can also [download](https://github.com/florian-asche/PiCompose/releases) the image and configure keyboard, timezone and wifi credentials with the [`raspi-config` tool](https://www.raspberrypi.com/documentation/computers/configuration.html#raspi-config). If you don't use the Raspberry Pi Imager customization, you'll need to connect a monitor, keyboard, and mouse to access the Pi initially to configure SSH and WiFi via `raspi-config`.
 
 ### Configuration
 
@@ -124,7 +134,7 @@ The system will automatically reboot and install the audio drivers. After that y
 You will notice that the hardware is not visible if you run `aplay -L`.<br>
 ❗ *You need to manually reboot one more time.*
 
-After that `aplay -L` should show the `seeed2micvoicec` or `Lite` soundcard depending on your hardware.
+After that `aplay -L` should show the `seeed2micvoicec`, `Lite`, or `Satellite1` soundcard depending on your hardware.
 
 piCompose should download and install the containers.
 You can watch the `/var/log/picompose.log` logfile if you want to monitor the process.

diff --git a/docs/hardware_sattelite1.md b/docs/hardware_sattelite1.md
@@ -5,45 +5,41 @@
 Features:
 - Microphone Processing: High-performance microphones with an XMOS audio processing chip. 
 - Audio Output: Supports high-quality Snapcast multi-room music playback via the powerful 25W built-in amplifier or headphone jack.
-- Controls: 4 programmable tactile buttons, including hardware mute for privacy.  360 degree addressable LED ring.
+- Controls: 4 programmable tactile buttons, including hardware mute for privacy. 360 degree addressable LED ring.
 - Sensors: Monitors room temperature, humidity, luminosity, and human presence (when paired with a mmWave radar sensor).
 - Radios: Built-in 2.4 GHz Wi-Fi and Bluetooth® 5 (LE).
 - Expandable: FX23L expansion connector for future accessories.
 - Compatible: Works with Home Assistant, Music Assistant
 - Audio Processor: XMOS XU316, 16-core 32-bit RISC running at 800 MHz with 3200 MIPS, 1024 KB SRAM, and 8 MB Flash.
 
+## Order Options
 
-## Order
+### Full Kit
 
-What you need to buy:
+Buy the [full kit](https://futureproofhomes.net/products/satellite1-smart-speaker) and add a Raspberry Pi Zero 2 WH.
 
-### Base:
+### Individual Parts
 
-- Raspberry Pi Zero 2 WH (currently no link) or if you can solder the pins yourself [Raspberry Pi Zero 2 W](https://amzn.to/3M0G4hC)
-- [SD-Card](https://amzn.to/4qfx06l)
+💡 **Note:** You will need to buy a Pi Zero 2 board with the pins already attached (WH version) to use a HAT board. You can buy the Pi board with factory-installed pins from authorized resellers, or use a hammer-in kit to install the pins on the board. There are probably a few adventurous souls that want to solder in the pins but I expect that most people won't.
 
-### Satellite1 HAT Board:
+| Part | Primary Source | Alternative Sources |
+|------|------------------|---------------------|
+| Satellite1 HAT Board | [FutureProofHomes](https://futureproofhomes.net/products/satellite1-1-hat-board) | - |
+| Raspberry Pi Zero 2 WH or Raspberry Pi Zero 2 W | - | [Amazon](https://amzn.to/3M0G4hC) |
+| Charger | [FutureProofHomes](https://futureproofhomes.net/products/30w-usb-c-pd-charger) | [Amazon: Anker Nano Charger](https://www.amazon.com/dp/B0B2MLRF93) |
+| Charger Cable (USB-C) | [FutureProofHomes](https://futureproofhomes.net/products/usb-c-cable) | - |
+| SD Card | - | [Amazon](https://amzn.to/4qfx06l) |
+| Speaker | [FutureProofHomes](https://futureproofhomes.net/products/3-inch-woofer-4ohm-20w) | [Amazon](https://www.amazon.com/dp/B0822XCPT8), [Aliexpress](https://s.click.aliexpress.com/e/_c33mJJNH) |
+| Tweeter | [FutureProofHomes](https://futureproofhomes.net/products/tweeter-4ohm-20w) | [Amazon](https://amzn.to/4k9gHXq), [Aliexpress](https://de.aliexpress.com/item/1005008134122115.html) |
+| Two Way Speaker Crossover Board | [FutureProofHomes](https://futureproofhomes.net/products/two-way-speaker-crossover) | [Aliexpress](https://de.aliexpress.com/item/1005006342929950.html) |
+| Speaker Cable 2x | [FutureProofHomes (Red)](https://futureproofhomes.net/products/4-8mm-spade-cable-red), [FutureProofHomes (Black)](https://futureproofhomes.net/products/2-8mm-spade-cable-black) | - |
+| JST Connector | [FutureProofHomes](https://futureproofhomes.net/products/jst-xh-2-54mm-2-pin-male-connector) | [Amazon](https://amzn.to/3TC4Urq) |
+| Screws | [FutureProofHomes](https://futureproofhomes.net/products/m3x10mm-hex-socket-head-cap-screws) | [Amazon](https://amzn.to/3RiytxE) |
+| Sealing Foam | [FutureProofHomes](https://futureproofhomes.net/products/epdm-sealing-foam-strip) | [Amazon](https://amzn.to/4yHYA1I) |
+| OEM 3D Print Design | [FutureProofHomes GitHub](https://github.com/FutureProofHomes/Satellite1-Enclosures/tree/main/OEM%20Enclosures/Satellite1.1%20Smart%20Speaker%20Enclosure%20Kit) | - |
 
-- [Satellite1 HAT Board](https://futureproofhomes.net/products/satellite1-top-microphone-board)
-- [9V 3A Power Supply for US](https://amzn.to/49RDELn)
-
-
-## Speaker:
-
-- [Whole Speaker kit](https://futureproofhomes.net/products/satellite1-smart-speaker-enclosure-kit)
-
-Or if you want to build and 3D-Print it yourself:
-
-- [Speaker](https://amzn.to/4k9gkfu) or [Aliexpress](https://de.aliexpress.com/item/1005011560142502.html?spm=a2g0o.productlist.main.3.33c9JJacJJacEB&algo_pvid=64814943-53f2-4063-858b-24b8bff7bd47&algo_exp_id=64814943-53f2-4063-858b-24b8bff7bd47-2&pdp_ext_f=%7B%22order%22%3A%22-1%22%2C%22eval%22%3A%221%22%2C%22fromPage%22%3A%22search%22%7D&pdp_npi=6%40dis%21EUR%217.78%213.89%21%21%2162.89%2131.44%21%402103868817699707030983290ea297%2112000055921741746%21sea%21DE%21797676231%21X%211%210%21n_tag%3A-29919%3Bd%3A64670a7c%3Bm03_new_user%3A-29895&curPageLogUid=uNvseW668v4i&utparam-url=scene%3Asearch%7Cquery_from%3A%7Cx_object_id%3A1005011560142502%7C_p_origin_prod%3A)
-- Optional: [Alternative Speaker](https://amzn.to/3ZIgnFA)
-- [Cable for Speaker](https://amzn.to/3NQtEJT)
-- [Crossover](https://de.aliexpress.com/item/1005006342929950.html?invitationCode=RElGaGNTVnp5aVh0S3dka2VST2FHR2l1eUNRV2NZcThRWmgvWnRFdUtnYWVQemFTZUJrNWVWT0s1MU1hdTAyWg&srcSns=sns_Copy&spreadType=socialShare&social_params=61399346706&bizType=ProductDetail&spreadCode=RElGaGNTVnp5aVh0S3dka2VST2FHR2l1eUNRV2NZcThRWmgvWnRFdUtnYWVQemFTZUJrNWVWT0s1MU1hdTAyWg&aff_fcid=2fae6e0ee0d445b393d87f5cf6411c9f-1769967697975-07738-_EIJyBko&tt=MG&aff_fsk=_EIJyBko&aff_platform=default&sk=_EIJyBko&aff_trace_key=2fae6e0ee0d445b393d87f5cf6411c9f-1769967697975-07738-_EIJyBko&shareId=61399346706&businessType=ProductDetail&platform=AE&terminal_id=29ee5f8658dd4e0898da1a1fba47d83e&afSmartRedirect=y)
-- [Tweeter](https://amzn.to/4k9gHXq) or [Aliexpress](https://de.aliexpress.com/item/1005008134122115.html?spm=a2g0o.productlist.main.1.593aGJ4bGJ4bug&algo_pvid=d39a4e60-913d-4c2c-b30e-7b5e0f643b71&algo_exp_id=d39a4e60-913d-4c2c-b30e-7b5e0f643b71-0&pdp_ext_f=%7B%22order%22%3A%225%22%2C%22eval%22%3A%221%22%2C%22fromPage%22%3A%22search%22%7D&pdp_npi=6%40dis%21EUR%218.05%218.05%21%21%219.37%219.37%21%40211b61ae17699713550016574ea8ce%2112000043930964935%21sea%21DE%21797676231%21X%211%210%21n_tag%3A-29919%3Bd%3A64670a7c%3Bm03_new_user%3A-29895&curPageLogUid=QHG13DgSQL42&utparam-url=scene%3Asearch%7Cquery_from%3A%7Cx_object_id%3A1005008134122115%7C_p_origin_prod%3A)
-- [Insulation](https://amzn.to/4t7Gtj3)
-
-
-## Additional information:
+## Additional Information
 
 - [Hardware Documentation](https://docs.futureproofhomes.net/satellite1-assembly/#first-boot-powering-on)
-- [Speaker Enclosure](https://docs.futureproofhomes.net/satellite1-smart-speaker-enclosure-kit/)
-- [OEM 3D Print Design](https://github.com/FutureProofHomes/Satellite1-Enclosures/tree/main/OEM%20Enclosures/Satellite1%20Smart%20Speaker%20Enclosure%20Kit)
+- [How to build the Speaker Enclosure](https://docs.futureproofhomes.net/satellite1-smart-speaker-enclosure-kit/)
+- [Alternative 3D Designs](https://docs.futureproofhomes.net/satellite1-squircle-enclosures) - Compatible with [alternative speakers](https://amzn.to/4pGP4rp)