Skip to content

Linux + iPhone Continuity / iMessage / SMS

docs: clear audio description

Zack Bartel442a1d7596eb
diff --git a/README.md b/README.md
index 6d3b379..d4f9062 100644
--- a/README.md
+++ b/README.md
@@ -60,7 +60,10 @@ Place, answer and end calls on the iPhone from the desktop, complete with caller
Recent calls from the iPhone are listed with a button to call back, and the iPhone's favorites are starred at the top of Contacts. These need **Phone Recents** and **Phone Favorites** turned on under the iPhone's Bluetooth settings for this computer.
The call audio stays on the iPhone. If you've used Linux long enough you know why (it sounds like "FalsePotty-o"). PulsAlsaWire is too hard to support across all deployment targets.
-Stock PipeWire makes the computer a speaker for the phone, which takes call control away and moves the iPhone's music and sounds to the desktop. The recommended audio setting is in [Keeping the phone's audio on the phone](docs/BLUETOOTH.md#keeping-the-phones-audio-on-the-phone). Or keep it and switch with `tether --bt-phone-audio here|phone`.
+Out of the box, Linux offers itself to the iPhone as a Bluetooth speaker. The iPhone's music and sounds then play on the computer, and call control stops working. One small audio setting fixes it, and you pick which way:
+
+- **Keep the iPhone's sound on the iPhone, always.** See [Keeping the phone's audio on the phone](docs/BLUETOOTH.md#keeping-the-phones-audio-on-the-phone).
+- **Switch whenever you like.** Settings > Experimental > *Play the iPhone's audio on this computer*, or `tether --bt-phone-audio here` and `tether --bt-phone-audio phone`. See [Switching it instead](docs/BLUETOOTH.md#switching-it-instead).
### OTP Handling
Streamline two-factor authentication across your devices:
diff --git a/docs/BLUETOOTH.md b/docs/BLUETOOTH.md
index 9dafd0e..252aeaf 100644
--- a/docs/BLUETOOTH.md
+++ b/docs/BLUETOOTH.md
@@ -1054,6 +1054,9 @@ for a phone, and leaving them out leaves the iPhone nothing to route to. Leaving
also what hands BlueZ the hands-free profile, which is where call control and the indicators come
from -- see "Calls".
+These roles leave out `a2dp_sink`, so `tether --bt-phone-audio` reports `unavailable` and its switch
+does nothing. To keep the choice, see "Switching it instead" below.
+
The one thing given up is the phone using the computer as a speaker or speakerphone. If you want
call audio on the desktop, `a2dp_sink` is mandatory for it, and with it the phone's music and
sounds come here too, and AirPods handoff falls back to the computer; see "Getting the call audio
@@ -1061,8 +1064,20 @@ onto the desktop instead".
#### Switching it instead
-To keep `a2dp_sink` and choose per moment, leave the roles alone (drop only `hfp_hf` if you want
-call control) and use:
+To keep `a2dp_sink` and choose each time, use the stock roles without `hfp_hf`. Dropping `hfp_hf` keeps
+call control on BlueZ; see "Calls". On WirePlumber 0.5 and later:
+
+```bash
+mkdir -p ~/.config/wireplumber/wireplumber.conf.d
+cat > ~/.config/wireplumber/wireplumber.conf.d/51-no-phone-audio.conf <<'EOF'
+monitor.bluez.properties = {
+ bluez5.roles = [ a2dp_sink a2dp_source bap_sink bap_source bap_bcast_sink bap_bcast_source hfp_ag ]
+}
+EOF
+systemctl --user restart wireplumber
+```
+
+This replaces the file above if you made it. As there, only one file should set `bluez5.roles`. Then:
```bash
tether --bt-phone-audio here # play the iPhone's music and sounds on this computer