From dbf622cb171809180a6081c12a78fb91da35d22c Mon Sep 17 00:00:00 2001
From: Mike Brady <4265913+mikebrady@users.noreply.github.com>
Date: Thu, 10 Mar 2022 19:25:04 +1100
Subject: [PATCH 1/3] Create ADDINGTOHOME.md

---
 ADDINGTOHOME.md | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)
 create mode 100644 ADDINGTOHOME.md

diff --git a/ADDINGTOHOME.md b/ADDINGTOHOME.md
new file mode 100644
index 00000000..eae5d8ec
--- /dev/null
+++ b/ADDINGTOHOME.md
@@ -0,0 +1,29 @@
+Here is a brief guide to adding a Shairport Sync device to the Apple Home application on iOS 15.3.1. Note that Shairport Sync has to be built with AirPlay 2 support.
+
+***
+
+Step 1: Open the "Home" app
+---
+
+Tap the `Add Accessory` panel or choose "Add Accessory" from the `+` symbol in the top right:
+
+![IMG_3678](https://user-images.githubusercontent.com/4265913/157615721-e42a07e3-f93e-49d0-9233-e7b92a577459.jpg)
+
+***
+
+Step 2: "More options..."
+---
+
+Step 2: Tap `More options...`
+
+![IMG_3679](https://user-images.githubusercontent.com/4265913/157616118-79c6d494-ce6e-4666-a6de-53cb40d0e751.jpg)
+
+
+***
+
+Step 3: Select your Shairport Sync device:
+---
+
+Your Shairport Sync device should appear here, though you may have to scroll. Tap the appropriate icon and follow the remaining instructions.
+
+![IMG_3680](https://user-images.githubusercontent.com/4265913/157616475-22ee2eb6-56f4-4368-a1ed-d925f9984f1e.jpg)

From b941dfd3ed27d817012d94200c3426a7e5f1d550 Mon Sep 17 00:00:00 2001
From: Mike Brady <4265913+mikebrady@users.noreply.github.com>
Date: Thu, 10 Mar 2022 19:27:13 +1100
Subject: [PATCH 2/3] Update TROUBLESHOOTING.md

---
 TROUBLESHOOTING.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/TROUBLESHOOTING.md b/TROUBLESHOOTING.md
index 23d1ebea..74734fb0 100644
--- a/TROUBLESHOOTING.md
+++ b/TROUBLESHOOTING.md
@@ -61,6 +61,9 @@ To see the AirPlay service Shairport Sync provides, your devices must be on the
 ### Faulty WiFi
 For an example of what it can take to track down a bad WiFi situation – in this case, a faulty WiFi adapter – please look at [this report](https://github.com/mikebrady/shairport-sync/issues/689).
 
+### Using your iOS device as a hotspot.
+An iOS device that is being used as a WiFi hotspot can not play audio to another device.
+
 ### Can't play from iTunes on Windows
 
 **Problem**

From cc74705a1477036b4a25c68d03dcaa5f2f41e43e Mon Sep 17 00:00:00 2001
From: Mike Brady <4265913+mikebrady@users.noreply.github.com>
Date: Thu, 10 Mar 2022 19:30:46 +1100
Subject: [PATCH 3/3] Update BUILDFORAP2.md

---
 BUILDFORAP2.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/BUILDFORAP2.md b/BUILDFORAP2.md
index 77ddba95..c98cb5ad 100644
--- a/BUILDFORAP2.md
+++ b/BUILDFORAP2.md
@@ -148,6 +148,10 @@ The Shairport Sync AirPlay service should appear on the network with a service n
 
 Connect and enjoy...
 
+### Adding to Home
+
+Follow the steps in [ADDINGTOHOME.md](https://github.com/mikebrady/shairport-sync/blob/development/ADDINGTOHOME.md) to add your Shairport Sync device to the Apple Home system.
+
 ### Restart Your Mac!
 
 At the time of writing, there seems to be a bug in AirPlay 2 on Apple Silicon Macs and on the Apple TV. It appears that, if the Mac/ATV has been sleeping, the AirPlay 2 infrastructure is not fully reenabled when it wakens up. The `nqptp` program incorporates a workaround which fixes this issue for ATVs and mostly fixes it for macOS. However, it does not completely fix macOS Music on Apple Silicon Macs. The only known solution is to reboot the Mac.