Skip to content

Linux + iPhone Continuity / iMessage / SMS

docs: document hfp findings

Zack Barteld5c861401537
diff --git a/README.md b/README.md
index f663898..c060d1d 100644
--- a/README.md
+++ b/README.md
@@ -32,7 +32,7 @@
| **Mail Extension** | ✅ Stable |
| **Messages (SMS/iMessage)** | 🧪 Beta |
| **Notification Mirroring** | 🧪 Beta |
-| **Phone Calls** | 🧪 Beta |
+| **Phone Calls** | 🧪 Alpha |
| **TOTP/OTP Vault** | 🗓️ Planning |
### Clipboard Sync
@@ -44,11 +44,6 @@ Drag and drop files from Linux directly into the iPhone app, or receive files au
### Messages and Notifications
Read and reply to SMS and iMessage conversations, and see notifications from any app on the phone, on the Linux desktop.
-### Phone Calls
-Place, answer and end calls on the iPhone from the desktop, with caller ID resolved
-against your contacts, plus the phone's carrier and signal. The call audio stays on the
-iPhone. Nothing to configure; see [docs/BLUETOOTH.md](docs/BLUETOOTH.md).
-
### Device Pairing
There are two ways tether communicates with the iPhone:
- WiFi: for clipboard sync, file transfer, and OTP handling
@@ -58,6 +53,10 @@ You can use either or both, depending on your needs.
Connections run over TLS 1.2 and both sides present a self-signed X.509 certificate.
+### Phone Calls
+Place, answer and end calls on the iPhone from the desktop, complete with caller ID and the phone's carrier and signal.
+The call audio stays on the iPhone. If you've used Linux long enough you know why (it sounds like "FulsePotty-o"). PulsAlsaWire is too hard to support across all deployment targets.
+
### OTP Handling
Streamline two-factor authentication across your devices:
- iOS Share Extension: Send OTP codes from your iPhone to your Linux clipboard.
diff --git a/docs/BLUETOOTH.md b/docs/BLUETOOTH.md
index 8fd0bea..8c336e5 100644
--- a/docs/BLUETOOTH.md
+++ b/docs/BLUETOOTH.md
@@ -24,6 +24,8 @@ Not every machine can do all of it, so Tether resolves one of two modes from liv
`tether --bt-status` reports which applies. `scripts/bt-probe.sh` is a
repo-only development probe that covers a few things the daemon does not check
(BlueZ version, `obex.service`, tooling); it is not installed by any package.
+`scripts/bt-probe.sh --calls` is a separate mode for the call path, meant to be run
+while a call is connected -- see "Calls".
## Setup requirements
@@ -174,15 +176,37 @@ all: it reads the snapshot and issues method calls on the monitor's connection.
### The audio stays on the phone
-This is control only, by construction rather than by choice. BlueZ owns the SCO link
-and exports no transport for it, so there is nothing to route to PipeWire. Ringing,
-caller ID, answering, hanging up and dialling all work from the desktop; the call
-itself plays on the iPhone.
-
-The consequence is that **no WirePlumber configuration is needed or wanted**. The
+Control only, by construction. Ringing, caller ID, answering, hanging up and dialling
+all work from the desktop; the call itself plays on the iPhone.
+
+BlueZ's hands-free profile never opens the voice link. HFP is two connections -- RFCOMM
+for the AT commands, SCO for the audio -- and BlueZ only uses the first. Three things
+say so:
+
+- `bluetoothd` contains no `AT+BCC` and no `+BCS`. Those are the Codec Connection
+ commands, the only way a hands-free unit asks the phone to open the voice link. The
+ rest of the AT vocabulary is complete: `BRSF`, `CIND`, `CMER`, `CLIP`, `CCWA`, `COPS`,
+ `CLCC`, `CHLD`, `CHUP`, `BLDN`, `+CIEV`.
+- `profiles/audio/transport.c`, which implements `org.bluez.MediaTransport1`, links with
+ `a2dp.c`, `bap.c` and `asha.c`. Its states are `idle/pending/broadcasting/active` with
+ `Links` for LE Audio BIGs. There is no SCO transport type in it.
+- Measured **during an active call**, where a lazily created transport would have shown
+ up: BlueZ exports no `/fd#` object and PipeWire creates no `bluez_card`.
+ `./scripts/bt-probe.sh --calls` checks all of this in one command.
+
+So the consequence is that **no WirePlumber configuration is needed or wanted**. The
`hfp_hf` role stays off, the machine never becomes an audio destination for the phone,
and "Keeping the phone's audio on the phone" below continues to apply unchanged.
+`org.bluez.Telephony1` is also where desktop call audio arrives on its own eventually.
+It is not an HFP-specific interface: `profiles/audio/telephony.c` is a shared layer
+sitting alongside `profiles/audio/ccp.c` (LE Audio Call Control), and the `UUID`
+property exists because more than one profile can provide it -- an iPhone over HFP
+reports `0000111f`, an LE Audio phone would report a TBS UUID through the same methods
+and the same `Call1` objects. LE Audio call audio is carried by an ordinary BAP
+`MediaTransport1`, which every audio server already consumes. Tether would need no
+change for either that or a future SCO export.
+
### What was tried instead
PipeWire's `bluez5` plugin implements the same profile in the HF role and publishes
@@ -201,7 +225,114 @@ btd_service_connect() hfp profile connect failed for <phone>: Input/output error
Dropping `hfp_hf` from `bluez5.roles` makes BlueZ's profile connect immediately and
export `telephony0`. Using PipeWire's instead would mean `bluetoothd --noplugin=hfp`,
a system-wide change to every Bluetooth device on the machine, in exchange for desktop
-call audio. That trade was not taken -- see 2026-09-04 below.
+call audio. That trade was not taken. The reasons are about maintenance across a large
+and varied install base, not capability:
+
+- **Two prerequisites, both moving.** PipeWire >= 1.4 for the telephony API, *and*
+ `--noplugin=hfp` -- but only on BlueZ >= 5.87, where the built-in profile exists.
+ The required system configuration therefore differs per distro, and appears under
+ existing users when their distro bumps BlueZ. Working calls would break on an
+ unrelated upgrade with no change in Tether.
+- **A CI target cannot run it.** `.github/workflows/ubuntu.yml` builds against Ubuntu
+ 24.04, an LTS supported to 2029, whose PipeWire predates the telephony API entirely.
+- **Not every machine has PipeWire.** PulseAudio hosts, servers, containers.
+- **It would bind Tether to one audio server permanently**, where
+ `org.bluez.Telephony1` is already the profile-agnostic layer described above.
+
+BlueZ's route has one prerequisite, `bluetoothd --experimental`, which Tether already
+requires for `org.bluez.Bearer.LE1`, already detects, and already prints the fix for.
+
+Users who want the audio on the desktop can still have it, at the cost of Tether's call
+control -- see below.
+
+### Getting the call audio onto the desktop instead
+
+Possible, and it costs more than it first appears. Walked end to end on 2026-09-04, so
+what follows is measured rather than reasoned.
+
+You give up two things:
+
+- **Tether's call control.** Handing the profile to PipeWire means BlueZ no longer owns
+ it, exports no `org.bluez.Telephony1`, and the Calls page goes empty.
+- **The phone's audio staying on the phone.** `a2dp_sink` turns out to be mandatory
+ here, so music and system sounds move to the desktop as well. Everything
+ "Keeping the phone's audio on the phone" below is written to avoid, you are opting
+ back into. This is the part that surprises people, so it is stated first.
+
+Tether has no code on this path and does not test it in CI.
+
+All three settings are required. Any one missing and nothing works at all.
+
+1. Stop BlueZ's built-in profile claiming UUID `0000111e`. Only needed on BlueZ >= 5.87;
+ older builds have no built-in to disable.
+
+ ```bash
+ sudo mkdir -p /etc/systemd/system/bluetooth.service.d
+ printf '[Service]\nExecStart=\nExecStart=%s --experimental --noplugin=hfp\n' \
+ "$(ls /usr/lib/bluetooth/bluetoothd /usr/libexec/bluetooth/bluetoothd 2>/dev/null | head -1)" \
+ | sudo tee /etc/systemd/system/bluetooth.service.d/no-hfp.conf
+ sudo systemctl daemon-reload && sudo systemctl restart bluetooth
+ ```
+
+ Keep `--experimental`: dropping it takes notification mirroring with it.
+
+2. Give PipeWire the roles and turn its telephony service on, in
+ `~/.config/wireplumber/wireplumber.conf.d/51-no-phone-audio.conf`:
+
+ ```
+ monitor.bluez.properties = {
+ bluez5.roles = [ a2dp_source a2dp_sink hfp_ag hfp_hf bap_source ]
+ bluez5.telephony-dbus-service = true
+ bluez5.telephony.default-reject-sco = true
+ }
+ ```
+
+ Then `systemctl --user restart wireplumber` and reconnect the phone. On
+ WirePlumber 0.4 the same setting goes in `bluetooth.lua.d` as
+ `bluez_monitor.properties["bluez5.roles"]`, as described below.
+
+ `a2dp_sink` is not optional, however much you want it to be. Without it iOS does not
+ treat the machine as an audio destination, does not list it in the Control Center
+ audio picker, and never connects hands-free to it -- PipeWire creates no
+ `bluez_card` at all. Adding it makes the card appear immediately.
+
+ `bluez5.telephony-dbus-service` is not optional either. `org.pipewire.Telephony`
+ being an owned bus name does not mean the service is enabled, and without this
+ setting no gateway object is ever registered.
+
+3. **Let the phone initiate.** The desktop cannot bring the link up. `Device1.Connect()`
+ ignores PipeWire's external profile; `ConnectProfile("0000111e")` fails with
+ `No more profiles to connect to`, because the iPhone advertises `0000111f` and BlueZ
+ matches against the remote's UUID list; `ConnectProfile("0000111f")` returns success
+ and does nothing. Select the machine on the phone -- Control Center's audio route, or
+ Settings > Bluetooth -- and the hands-free link comes up on its own.
+
+Success looks like this in WirePlumber's log
+(`WIREPLUMBER_DEBUG='*bluez*:5' wireplumber`):
+
+```
+spa.bluez5.native register_profile: Registering Profile /Profile/HFPHF 0000111e-...
+spa.bluez5.native profile_new_connection: NewConnection ... fd=59, profile /Profile/HFPHF
+spa.bluez5.native rfcomm_send_next_cmd: RFCOMM >> AT+BRSF=695
+spa.bluez5.telepho telephony_ag_register: registered AudioGateway: /org/pipewire/Telephony/ag1
+```
+
+and `busctl --user tree org.pipewire.Telephony` then shows the gateway. Call control
+lives on `org.pipewire.Telephony`, mirrored as `org.ofono.VoiceCallManager` and
+`org.ofono.VoiceCall`, so any oFono-compatible dialer can drive it while PipeWire
+carries the audio. `AudioGatewayTransport1.Activate()` pulls the audio to the desktop.
+PipeWire older than 1.4 publishes no telephony API at all, leaving audio but no call
+control.
+
+Watch for `Not activating device bluez_card.<ADDR>` in WirePlumber's log. That is
+`create-device.lua` declining a card whose `api.bluez5.connection` is not yet
+`connected`, and it means the hands-free service level connection has not finished --
+the AT handshake above is still in flight, or was interrupted.
+
+To undo it: delete `/etc/systemd/system/bluetooth.service.d/no-hfp.conf`, restore the
+`bluez5.roles` line to whatever it was, `sudo systemctl daemon-reload && sudo systemctl
+restart bluetooth`, `systemctl --user restart wireplumber`, and reconnect the phone.
+`./scripts/bt-probe.sh --calls` should show `telephony0` again.
### Turning it on
@@ -232,7 +363,8 @@ the narrower check; it rules out the `*`/`#` supplementary-service codes deliber
### What it does not do
-- No call audio on the desktop, per above.
+- No call audio on the desktop, per above. `./scripts/bt-probe.sh --calls`, run during a
+ call, reports which of the two states this machine is in.
- No call history. A missed call still arrives as an ANCS `MissedCall` notification.
- `HangupActive` and `HangupHeld` are documented but absent from BlueZ 5.87, so only
`HangupAll` is offered.
@@ -293,7 +425,9 @@ checks the daemon does not make.
| The link reads down forever with `br-connection-unknown`, while messages, contacts and notifications all work | This computer offers the iPhone no BR/EDR profile to connect to, and BlueZ only reports a link up while some local profile is connected | Nothing. Tether no longer waits on that link -- see 2026-08-23 below. Call support does not change this: BlueZ's hands-free profile is not one of the local profiles BlueZ counts |
| The iPhone's audio moves to the computer when Tether connects | The machine advertises itself as a Bluetooth speaker/headset, and iOS routes to it. Not caused by Tether beyond bringing the link up | See "Keeping the phone's audio on the phone" below |
| `tether --bt-calls` reports call control off | The iPhone has not connected Hands-Free, or `bluetoothd` is running without `--experimental` | The daemon's reason line names which. Confirm with `busctl --system tree org.bluez \| grep telephony` |
-| Calls work but the audio is on the iPhone | Working as designed. BlueZ owns the SCO link and exports no transport, so there is nothing to route here | Nothing. See "Calls" |
+| Calls work but the audio is on the iPhone | Working as designed. BlueZ signals the call and never opens the voice link, so there is nothing to route here | Nothing. `./scripts/bt-probe.sh --calls` during a call shows the evidence; "Getting the call audio onto the desktop instead" is the trade if you want it |
+| The Calls page is empty after configuring PipeWire for call audio | Expected. PipeWire owns the hands-free profile now, so BlueZ exports no `telephony0` for Tether to drive | Pick one: the revert steps under "Getting the call audio onto the desktop instead", or keep PipeWire and use an oFono-compatible dialer |
+| Configured PipeWire for call audio and the machine is not in the iPhone's audio picker | `a2dp_sink` is missing from `bluez5.roles`. iOS only speaks hands-free to a machine it considers an audio destination | Add `a2dp_sink`, and accept that the phone's music comes here too -- see "Getting the call audio onto the desktop instead" |
| `hfp_connect() unable to start connection` in the bluetoothd log | PipeWire's `hfp_hf` role and BlueZ's built-in profile are both claiming UUID `0000111e` | Remove `hfp_hf` from `bluez5.roles` -- see "Calls" and 2026-09-04 |
### Keeping the phone's audio on the phone
@@ -335,6 +469,11 @@ nothing here uses LE Audio. On WirePlumber 0.4 the same setting goes in
`~/.config/wireplumber/bluetooth.lua.d/51-no-phone-audio.lua` as
`bluez_monitor.properties["bluez5.roles"]`.
+If you later want call audio on the desktop, be aware this setting is the thing in the
+way: `a2dp_sink` is what makes iOS willing to speak hands-free to this machine at all.
+See "Getting the call audio onto the desktop instead" -- you cannot keep the music here
+and move the calls.
+
Two things that look like fixes and are not:
- `pactl set-card-profile bluez_card.<ADDR> off` stops the computer playing the audio,
@@ -1807,3 +1946,124 @@ Two smaller findings from the same session:
configuration if it still ends in `.conf`. Keep backups outside that directory.
- `HangupActive` and `HangupHeld` are in `man org.bluez.Telephony` but are not exported
by 5.87. Only `HangupAll` is.
+
+### 2026-09-04 - Why the audio cannot follow, and why that is the right trade
+
+BlueZ's hands-free profile signals calls and never opens the voice link. HFP runs over
+two connections, RFCOMM for the AT commands and SCO for the audio, and bluetoothd only
+uses the first. Its AT vocabulary is complete for control -- `BRSF`, `CIND`, `CMER`,
+`CLIP`, `CCWA`, `COPS`, `CLCC`, `CHLD`, `CHUP`, `BLDN`, `+CIEV` -- and contains no
+`AT+BCC` or `+BCS`, the Codec Connection commands that are the only way a hands-free
+unit asks the phone for audio. `profiles/audio/transport.c`, which implements
+`org.bluez.MediaTransport1`, links with `a2dp.c`, `bap.c` and `asha.c` and has no SCO
+transport type.
+
+Confirmed on a live call rather than inferred. With a call connected and talking, the
+`Call1` object is there and correct, and nothing else is:
+
+```
+$ ./scripts/bt-probe.sh --calls
+BlueZ telephony objects
+ /org/bluez/hci0/dev_<ADDR>/telephony0
+ .OperatorName property s "AT&T"
+ .Signal property y 2
+ .State property s "connected"
+ .UUID property s "0000111f-0000-1000-8000-00805f9b34fb"
+ /org/bluez/hci0/dev_<ADDR>/telephony0/call1
+ .LineIdentification property s "<number>"
+ .State property s "active"
+
+Media transports (a transport here would mean the audio can reach the desktop)
+ none -- BlueZ exports no transport, so the audio stays on the phone
+
+Audio server view
+ no bluez_card -- nothing for the desktop to play through
+```
+
+An `active` call with no transport and no audio device is the whole answer.
+
+PipeWire's implementation does carry the audio, and was rejected on maintenance grounds
+rather than capability. It needs two prerequisites that both move: PipeWire >= 1.4 for
+`org.pipewire.Telephony`, and `bluetoothd --noplugin=hfp` but only on BlueZ >= 5.87. The
+required system configuration therefore differs per distro and would appear under
+existing users when their distro bumps BlueZ -- working calls breaking on an unrelated
+upgrade, with no change in Tether. Ubuntu 24.04, one of this repo's own CI targets and
+an LTS supported to 2029, ships a PipeWire predating the API entirely. And it would bind
+Tether to one audio server on machines that may run PulseAudio or no audio stack at all.
+
+`org.bluez.Telephony1` costs one prerequisite, `--experimental`, which Tether already
+requires, detects and prints the fix for.
+
+It is also the profile-agnostic layer, which is what makes control-only acceptable
+rather than a dead end. `profiles/audio/telephony.c` is shared, sitting beside
+`profiles/audio/ccp.c` (LE Audio Call Control), and `Telephony1.UUID` exists because more
+than one profile can provide it: `0000111f` here over HFP, a TBS UUID on an LE Audio
+phone, through the same methods and the same `Call1` objects. LE Audio call audio rides
+an ordinary BAP `MediaTransport1` that every audio server already consumes. So the path
+to desktop call audio is BlueZ or the phone gaining it, not Tether growing an audio
+stack -- and Tether needs no change when it arrives.
+
+Users who want desktop audio today can hand the profile to PipeWire, at the cost of
+Tether's call control. Written up under "Getting the call audio onto the desktop
+instead", with the mutual exclusivity stated first.
+
+### 2026-09-04 - Walking the PipeWire route, and what it really costs
+
+The instructions above were written from reasoning and then tested before publishing.
+Two of the three steps were wrong, which is the argument for testing them.
+
+**`a2dp_sink` is mandatory, and that is the real price.** With
+`bluez5.roles = [ a2dp_source hfp_ag hfp_hf bap_source ]` and BlueZ's built-in disabled,
+PipeWire registered `/Profile/HFPHF` for `0000111e` -- confirmed on the adapter's UUID
+list -- and bluetoothd stopped logging its own `hfp_connect()` failure. Yet no
+`bluez_card` was ever created, no `ag0` appeared, and the machine did not show up in the
+iPhone's Control Center audio picker. Adding `a2dp_sink` produced the card instantly:
+
+```
+$ pactl list cards short
+827 bluez_card.60_57_C8_30_6A_F7 module-bluez5-device.c
+...
+ Active Profile: audio-gateway
+```
+
+So iOS decides whether to speak hands-free to a machine based on whether that machine is
+an audio destination at all, and A2DP sink is what makes it one. The consequence is that
+desktop call audio and "the phone's music stays on the phone" cannot both be had. That
+inverts the appeal of the whole route for anyone running the config in "Keeping the
+phone's audio on the phone".
+
+**`bluez5.telephony-dbus-service = true` must be set explicitly.** It was left out of the
+first draft because `busctl --user status org.pipewire.Telephony` showed the name owned,
+which was mistaken for the service being on. Ownership of the bus name is not the same
+as the service being enabled; without the setting no gateway is ever registered.
+
+**The desktop cannot bring the link up.** `Device1.Connect()` ignores an externally
+registered `Profile1`. `ConnectProfile("0000111e")` fails with `No more profiles to
+connect to`, because BlueZ matches `ConnectProfile` against the *remote's* advertised
+UUIDs and the iPhone advertises `0000111f`, not `111e`.
+`ConnectProfile("0000111f")` returns success and connects nothing meaningful -- BlueZ
+matches it to PipeWire's `/Profile/HFPAG`, this machine acting as the gateway, which is
+not the wanted direction. Every successful connection observed was initiated by the
+phone.
+
+With all three right, it does work end to end:
+
+```
+spa.bluez5.native profile_new_connection: NewConnection ... fd=59, profile /Profile/HFPHF
+spa.bluez5.native RFCOMM >> AT+BRSF=695
+spa.bluez5.native RFCOMM << +BRSF:1007 OK
+spa.bluez5.native RFCOMM >> AT+BAC=1,3,127,2
+spa.bluez5.telepho telephony_ag_register: registered AudioGateway: /org/pipewire/Telephony/ag1
+```
+
+One diagnostic worth knowing: `Not activating device bluez_card.<ADDR>` from
+WirePlumber's `create-device.lua` is not an error in itself. It gates on
+`api.bluez5.connection == "connected"`, which only becomes true once the hands-free
+service level connection completes. Seeing it means the AT handshake above has not
+finished, or was interrupted -- a short-lived debug instance of `wireplumber` is enough
+to cut it off mid-negotiation.
+
+None of this changes the shipped design. It sharpens the reason for it: the supported
+path needs one flag Tether already requires, and the alternative needs three settings
+across two daemons, gives up call control, gives up keeping the phone's audio on the
+phone, and still depends on the phone choosing to connect.
diff --git a/po/cs.po b/po/cs.po
index bb209ae..05dcc5b 100644
--- a/po/cs.po
+++ b/po/cs.po
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: tether\n"
"Report-Msgid-Bugs-To: [email protected]\n"
-"POT-Creation-Date: 2026-09-04 10:58-0700\n"
+"POT-Creation-Date: 2026-09-04 14:22-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Czech\n"
@@ -1099,6 +1099,10 @@ msgstr "iPhone nepřipojil hands-free k tomuto počítači."
msgid "Connecting to the iPhone's Hands-Free service."
msgstr "Připojování ke službě hands-free iPhonu."
+#: src/core/src/bluetooth/telephony.cpp src/gtk/calls_view.cpp
+msgid "Calls are controlled here; the audio plays on the iPhone."
+msgstr "Hovory se ovládají zde; zvuk se přehrává v iPhonu."
+
#: src/core/src/bluetooth/telephony.cpp
msgid "Not a dialable number."
msgstr "Není to vytáčitelné číslo."
diff --git a/po/de.po b/po/de.po
index acb3480..de761c6 100644
--- a/po/de.po
+++ b/po/de.po
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: tether\n"
"Report-Msgid-Bugs-To: [email protected]\n"
-"POT-Creation-Date: 2026-09-04 10:58-0700\n"
+"POT-Creation-Date: 2026-09-04 14:22-0700\n"
"PO-Revision-Date: 2026-08-22\n"
"Last-Translator: Tether project\n"
"Language-Team: German\n"
@@ -1123,6 +1123,11 @@ msgstr "Das iPhone hat Hands-Free nicht mit diesem Computer verbunden."
msgid "Connecting to the iPhone's Hands-Free service."
msgstr "Verbindung zum Hands-Free-Dienst des iPhones wird aufgebaut."
+#: src/core/src/bluetooth/telephony.cpp src/gtk/calls_view.cpp
+msgid "Calls are controlled here; the audio plays on the iPhone."
+msgstr ""
+"Anrufe werden hier gesteuert; der Ton wird auf dem iPhone wiedergegeben."
+
#: src/core/src/bluetooth/telephony.cpp
msgid "Not a dialable number."
msgstr "Keine wählbare Nummer."
diff --git a/po/es.po b/po/es.po
index 2fbf35f..1b76ddc 100644
--- a/po/es.po
+++ b/po/es.po
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: tether\n"
"Report-Msgid-Bugs-To: [email protected]\n"
-"POT-Creation-Date: 2026-09-04 10:58-0700\n"
+"POT-Creation-Date: 2026-09-04 14:22-0700\n"
"PO-Revision-Date: 2026-08-22\n"
"Last-Translator: Tether project\n"
"Language-Team: Spanish\n"
@@ -1113,6 +1113,10 @@ msgstr "El iPhone no ha conectado el manos libres a este equipo."
msgid "Connecting to the iPhone's Hands-Free service."
msgstr "Conectando con el servicio manos libres del iPhone."
+#: src/core/src/bluetooth/telephony.cpp src/gtk/calls_view.cpp
+msgid "Calls are controlled here; the audio plays on the iPhone."
+msgstr "Las llamadas se controlan aquí; el audio se reproduce en el iPhone."
+
#: src/core/src/bluetooth/telephony.cpp
msgid "Not a dialable number."
msgstr "No es un número marcable."
diff --git a/po/fr.po b/po/fr.po
index 5d9f6bf..8d259dc 100644
--- a/po/fr.po
+++ b/po/fr.po
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: tether\n"
"Report-Msgid-Bugs-To: [email protected]\n"
-"POT-Creation-Date: 2026-09-04 10:58-0700\n"
+"POT-Creation-Date: 2026-09-04 14:22-0700\n"
"PO-Revision-Date: 2026-08-22\n"
"Last-Translator: Tether project\n"
"Language-Team: French\n"
@@ -1120,6 +1120,10 @@ msgstr "L'iPhone n'a pas connecté le mode mains libres à cet ordinateur."
msgid "Connecting to the iPhone's Hands-Free service."
msgstr "Connexion au service mains libres de l'iPhone."
+#: src/core/src/bluetooth/telephony.cpp src/gtk/calls_view.cpp
+msgid "Calls are controlled here; the audio plays on the iPhone."
+msgstr "Les appels se pilotent ici ; l'audio est diffusé sur l'iPhone."
+
#: src/core/src/bluetooth/telephony.cpp
msgid "Not a dialable number."
msgstr "Numéro non composable."
diff --git a/po/it.po b/po/it.po
index 7fcd077..a7b2bb3 100644
--- a/po/it.po
+++ b/po/it.po
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: tether\n"
"Report-Msgid-Bugs-To: [email protected]\n"
-"POT-Creation-Date: 2026-09-04 10:58-0700\n"
+"POT-Creation-Date: 2026-09-04 14:22-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Italian\n"
@@ -1113,6 +1113,10 @@ msgstr "L'iPhone non ha collegato il vivavoce a questo computer."
msgid "Connecting to the iPhone's Hands-Free service."
msgstr "Connessione al servizio vivavoce dell'iPhone."
+#: src/core/src/bluetooth/telephony.cpp src/gtk/calls_view.cpp
+msgid "Calls are controlled here; the audio plays on the iPhone."
+msgstr "Le chiamate si controllano qui; l'audio viene riprodotto sull'iPhone."
+
#: src/core/src/bluetooth/telephony.cpp
msgid "Not a dialable number."
msgstr "Non è un numero componibile."
diff --git a/po/ja.po b/po/ja.po
index 0e48c87..281d303 100644
--- a/po/ja.po
+++ b/po/ja.po
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: tether\n"
"Report-Msgid-Bugs-To: [email protected]\n"
-"POT-Creation-Date: 2026-09-04 10:58-0700\n"
+"POT-Creation-Date: 2026-09-04 14:22-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Japanese\n"
@@ -1087,6 +1087,10 @@ msgstr "iPhone がこのコンピューターにハンズフリーを接続し
msgid "Connecting to the iPhone's Hands-Free service."
msgstr "iPhone のハンズフリーサービスに接続しています。"
+#: src/core/src/bluetooth/telephony.cpp src/gtk/calls_view.cpp
+msgid "Calls are controlled here; the audio plays on the iPhone."
+msgstr "通話はここで操作し、音声は iPhone で再生されます。"
+
#: src/core/src/bluetooth/telephony.cpp
msgid "Not a dialable number."
msgstr "発信できる番号ではありません。"
diff --git a/po/ko.po b/po/ko.po
index cae9bcd..62b7376 100644
--- a/po/ko.po
+++ b/po/ko.po
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: tether\n"
"Report-Msgid-Bugs-To: [email protected]\n"
-"POT-Creation-Date: 2026-09-04 10:58-0700\n"
+"POT-Creation-Date: 2026-09-04 14:22-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Korean\n"
@@ -1076,6 +1076,10 @@ msgstr "iPhone이 이 컴퓨터에 핸즈프리를 연결하지 않았습니다.
msgid "Connecting to the iPhone's Hands-Free service."
msgstr "iPhone의 핸즈프리 서비스에 연결하는 중입니다."
+#: src/core/src/bluetooth/telephony.cpp src/gtk/calls_view.cpp
+msgid "Calls are controlled here; the audio plays on the iPhone."
+msgstr "통화는 여기서 제어하고 오디오는 iPhone에서 재생됩니다."
+
#: src/core/src/bluetooth/telephony.cpp
msgid "Not a dialable number."
msgstr "전화를 걸 수 있는 번호가 아닙니다."
diff --git a/po/nl.po b/po/nl.po
index 82be201..f14de61 100644
--- a/po/nl.po
+++ b/po/nl.po
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: tether\n"
"Report-Msgid-Bugs-To: [email protected]\n"
-"POT-Creation-Date: 2026-09-04 10:58-0700\n"
+"POT-Creation-Date: 2026-09-04 14:22-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Dutch\n"
@@ -1108,6 +1108,10 @@ msgstr "De iPhone heeft handsfree niet met deze computer verbonden."
msgid "Connecting to the iPhone's Hands-Free service."
msgstr "Verbinden met de handsfree-dienst van de iPhone."
+#: src/core/src/bluetooth/telephony.cpp src/gtk/calls_view.cpp
+msgid "Calls are controlled here; the audio plays on the iPhone."
+msgstr "Oproepen worden hier bediend; het geluid speelt op de iPhone."
+
#: src/core/src/bluetooth/telephony.cpp
msgid "Not a dialable number."
msgstr "Geen belbaar nummer."
diff --git a/po/pl.po b/po/pl.po
index 16a6a02..ea222c8 100644
--- a/po/pl.po
+++ b/po/pl.po
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: tether\n"
"Report-Msgid-Bugs-To: [email protected]\n"
-"POT-Creation-Date: 2026-09-04 10:58-0700\n"
+"POT-Creation-Date: 2026-09-04 14:22-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Polish\n"
@@ -1109,6 +1109,10 @@ msgstr "iPhone nie połączył zestawu głośnomówiącego z tym komputerem."
msgid "Connecting to the iPhone's Hands-Free service."
msgstr "Łączenie z usługą zestawu głośnomówiącego iPhone’a."
+#: src/core/src/bluetooth/telephony.cpp src/gtk/calls_view.cpp
+msgid "Calls are controlled here; the audio plays on the iPhone."
+msgstr "Połączeniami sterujesz tutaj; dźwięk odtwarzany jest na iPhonie."
+
#: src/core/src/bluetooth/telephony.cpp
msgid "Not a dialable number."
msgstr "To nie jest numer, który można wybrać."
diff --git a/po/pt_BR.po b/po/pt_BR.po
index aa0e5a6..1a917df 100644
--- a/po/pt_BR.po
+++ b/po/pt_BR.po
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: tether\n"
"Report-Msgid-Bugs-To: [email protected]\n"
-"POT-Creation-Date: 2026-09-04 10:58-0700\n"
+"POT-Creation-Date: 2026-09-04 14:22-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Brazilian Portuguese\n"
@@ -1109,6 +1109,10 @@ msgstr "O iPhone não conectou o viva-voz a este computador."
msgid "Connecting to the iPhone's Hands-Free service."
msgstr "Conectando ao serviço viva-voz do iPhone."
+#: src/core/src/bluetooth/telephony.cpp src/gtk/calls_view.cpp
+msgid "Calls are controlled here; the audio plays on the iPhone."
+msgstr "As chamadas são controladas aqui; o áudio toca no iPhone."
+
#: src/core/src/bluetooth/telephony.cpp
msgid "Not a dialable number."
msgstr "Não é um número discável."
diff --git a/po/ru.po b/po/ru.po
index ab2f1af..a369d4c 100644
--- a/po/ru.po
+++ b/po/ru.po
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: tether\n"
"Report-Msgid-Bugs-To: [email protected]\n"
-"POT-Creation-Date: 2026-09-04 10:58-0700\n"
+"POT-Creation-Date: 2026-09-04 14:22-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Russian\n"
@@ -1108,6 +1108,10 @@ msgstr "iPhone не подключил Hands-Free к этому компьюте
msgid "Connecting to the iPhone's Hands-Free service."
msgstr "Подключение к службе Hands-Free на iPhone."
+#: src/core/src/bluetooth/telephony.cpp src/gtk/calls_view.cpp
+msgid "Calls are controlled here; the audio plays on the iPhone."
+msgstr "Вызовами управляют отсюда; звук воспроизводится на iPhone."
+
#: src/core/src/bluetooth/telephony.cpp
msgid "Not a dialable number."
msgstr "Такой номер набрать нельзя."
diff --git a/po/sv.po b/po/sv.po
index 0d0c628..244d306 100644
--- a/po/sv.po
+++ b/po/sv.po
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: tether\n"
"Report-Msgid-Bugs-To: [email protected]\n"
-"POT-Creation-Date: 2026-09-04 10:58-0700\n"
+"POT-Creation-Date: 2026-09-04 14:22-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Swedish\n"
@@ -1096,6 +1096,10 @@ msgstr "iPhone har inte anslutit handsfree till den här datorn."
msgid "Connecting to the iPhone's Hands-Free service."
msgstr "Ansluter till iPhones handsfree-tjänst."
+#: src/core/src/bluetooth/telephony.cpp src/gtk/calls_view.cpp
+msgid "Calls are controlled here; the audio plays on the iPhone."
+msgstr "Samtal styrs härifrån; ljudet spelas upp på iPhone."
+
#: src/core/src/bluetooth/telephony.cpp
msgid "Not a dialable number."
msgstr "Inte ett uppringbart nummer."
diff --git a/po/tether.pot b/po/tether.pot
index ea44615..a4888cc 100644
--- a/po/tether.pot
+++ b/po/tether.pot
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: tether 0.2.24\n"
"Report-Msgid-Bugs-To: [email protected]\n"
-"POT-Creation-Date: 2026-09-04 10:58-0700\n"
+"POT-Creation-Date: 2026-09-04 14:22-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <[email protected]>\n"
@@ -992,6 +992,10 @@ msgstr ""
msgid "Connecting to the iPhone's Hands-Free service."
msgstr ""
+#: src/core/src/bluetooth/telephony.cpp src/gtk/calls_view.cpp
+msgid "Calls are controlled here; the audio plays on the iPhone."
+msgstr ""
+
#: src/core/src/bluetooth/telephony.cpp
msgid "Not a dialable number."
msgstr ""
diff --git a/po/tr.po b/po/tr.po
index e410a2d..6b9b0db 100644
--- a/po/tr.po
+++ b/po/tr.po
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: tether\n"
"Report-Msgid-Bugs-To: [email protected]\n"
-"POT-Creation-Date: 2026-09-04 10:58-0700\n"
+"POT-Creation-Date: 2026-09-04 14:22-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Turkish\n"
@@ -1095,6 +1095,10 @@ msgstr "iPhone eller serbest bağlantısını bu bilgisayara kurmadı."
msgid "Connecting to the iPhone's Hands-Free service."
msgstr "iPhone’un eller serbest hizmetine bağlanılıyor."
+#: src/core/src/bluetooth/telephony.cpp src/gtk/calls_view.cpp
+msgid "Calls are controlled here; the audio plays on the iPhone."
+msgstr "Çağrılar buradan yönetilir; ses iPhone’da çalar."
+
#: src/core/src/bluetooth/telephony.cpp
msgid "Not a dialable number."
msgstr "Aranabilir bir numara değil."
diff --git a/po/uk.po b/po/uk.po
index 0823aca..b754661 100644
--- a/po/uk.po
+++ b/po/uk.po
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: tether\n"
"Report-Msgid-Bugs-To: [email protected]\n"
-"POT-Creation-Date: 2026-09-04 10:58-0700\n"
+"POT-Creation-Date: 2026-09-04 14:22-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Ukrainian\n"
@@ -1107,6 +1107,10 @@ msgstr "iPhone не підключив Hands-Free до цього комп’ю
msgid "Connecting to the iPhone's Hands-Free service."
msgstr "Підключення до служби Hands-Free на iPhone."
+#: src/core/src/bluetooth/telephony.cpp src/gtk/calls_view.cpp
+msgid "Calls are controlled here; the audio plays on the iPhone."
+msgstr "Викликами керують звідси; звук відтворюється на iPhone."
+
#: src/core/src/bluetooth/telephony.cpp
msgid "Not a dialable number."
msgstr "Такий номер набрати не можна."
diff --git a/po/zh_CN.po b/po/zh_CN.po
index 43d72c9..cb9366c 100644
--- a/po/zh_CN.po
+++ b/po/zh_CN.po
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: tether\n"
"Report-Msgid-Bugs-To: [email protected]\n"
-"POT-Creation-Date: 2026-09-04 10:58-0700\n"
+"POT-Creation-Date: 2026-09-04 14:22-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Simplified Chinese\n"
@@ -1049,6 +1049,10 @@ msgstr "iPhone 尚未与本机建立免提连接。"
msgid "Connecting to the iPhone's Hands-Free service."
msgstr "正在连接 iPhone 的免提服务。"
+#: src/core/src/bluetooth/telephony.cpp src/gtk/calls_view.cpp
+msgid "Calls are controlled here; the audio plays on the iPhone."
+msgstr "通话在此控制,音频在 iPhone 上播放。"
+
#: src/core/src/bluetooth/telephony.cpp
msgid "Not a dialable number."
msgstr "不是可拨打的号码。"
diff --git a/scripts/bt-probe.sh b/scripts/bt-probe.sh
index 9a811d8..20f18f5 100755
--- a/scripts/bt-probe.sh
+++ b/scripts/bt-probe.sh
@@ -5,6 +5,9 @@
# Compatibility = MAP + PBAP only; no notification mirroring
#
# Read-only unless --set-class is given.
+#
+# --set-class set the adapter's Class of Device to A/V Hands-Free
+# --calls probe the call path; run it while a call is connected
set -uo pipefail
@@ -18,7 +21,11 @@ TARGET_COD_LOW=0x0408
COD_MASK=0x1fff
set_class=0
-[[ ${1:-} == --set-class ]] && set_class=1
+calls_only=0
+case ${1:-} in
+ --set-class) set_class=1 ;;
+ --calls) calls_only=1 ;;
+esac
red=$'\e[31m'; grn=$'\e[32m'; ylw=$'\e[33m'; dim=$'\e[2m'; rst=$'\e[0m'
[[ -t 1 ]] || { red=; grn=; ylw=; dim=; rst=; }
@@ -38,6 +45,76 @@ prop() {
awk '{ $1=""; sub(/^ /,""); gsub(/"/,""); print }'
}
+# Where the call audio goes is decided by whoever owns the hands-free profile,
+# and only an active call proves it. Run this while a call is connected.
+probe_calls() {
+ echo
+ echo "Call audio probe (run this while a call is CONNECTED)"
+ echo "====================================================="
+
+ echo
+ echo "BlueZ telephony objects"
+ local tree
+ tree=$(busctl --system tree org.bluez 2>/dev/null)
+ if grep -q '/telephony' <<<"$tree"; then
+ grep -o '/org/bluez/[^ ]*/telephony[0-9]*[^ ]*' <<<"$tree" | sort -u | while read -r path; do
+ ok "$path"
+ # Only the telephony interface; the generic D-Bus ones are noise.
+ busctl --system introspect org.bluez "$path" 2>/dev/null |
+ awk '/^org\.bluez\.(Telephony|Call)1/ { p = 1; next }
+ /^org\./ { p = 0 }
+ p && /^\./ { printf " %s\n", $0 }'
+ done
+ else
+ bad "no telephony object — HFP is not connected, or bluetoothd lacks --experimental"
+ fi
+
+ # The whole question: does BlueZ hand the SCO link to an audio server?
+ echo
+ echo "Media transports (a transport here would mean the audio can reach the desktop)"
+ if grep -qE '/fd[0-9]+' <<<"$tree"; then
+ grep -oE '/org/bluez/[^ ]*/fd[0-9]+' <<<"$tree" | sort -u | while read -r path; do
+ clash "$path"
+ busctl --system get-property org.bluez "$path" org.bluez.MediaTransport1 UUID 2>/dev/null |
+ awk '{ printf " UUID %s\n", $2 }'
+ done
+ note "Unexpected: report this, it changes what Tether can do."
+ else
+ ok "none — BlueZ exports no transport, so the audio stays on the phone"
+ fi
+
+ echo
+ echo "Audio server view"
+ if command -v pactl >/dev/null; then
+ if pactl list cards short 2>/dev/null | grep -q bluez; then
+ clash "a bluez_card exists:"
+ pactl list cards short 2>/dev/null | grep bluez | awk '{ printf " %s\n", $2 }'
+ else
+ ok "no bluez_card — nothing for the desktop to play through"
+ fi
+ else
+ note "pactl not installed; skipping"
+ fi
+
+ echo
+ echo "bluetoothd, last 40 lines"
+ journalctl -u bluetooth -n 40 --no-pager 2>/dev/null |
+ grep -iE 'sco|transport|codec|hfp' | tail -10 |
+ awk '{ printf " %s\n", $0 }' || note "no matching log lines"
+
+ echo
+ echo "Verdict"
+ if grep -qE '/fd[0-9]+' <<<"$tree"; then
+ printf ' %sTRANSPORT PRESENT%s — the call audio can reach this machine.\n' "$ylw" "$rst"
+ else
+ printf ' %sCONTROL ONLY%s — BlueZ signals the call but never opens the voice link.\n' "$grn" "$rst"
+ printf ' The audio plays on the phone. See "Calls" in docs/BLUETOOTH.md.\n'
+ fi
+ exit 0
+}
+
+(( calls_only == 1 )) && probe_calls
+
echo
echo "Tether Bluetooth capability probe"
echo "================================="
diff --git a/src/core/src/bluetooth/telephony.cpp b/src/core/src/bluetooth/telephony.cpp
index 9e40eef..8aec3ea 100644
--- a/src/core/src/bluetooth/telephony.cpp
+++ b/src/core/src/bluetooth/telephony.cpp
@@ -118,7 +118,7 @@ namespace tether::bluetooth {
else if (!gw.ready())
j["reason"] = _("Connecting to the iPhone's Hands-Free service.");
else
- j["reason"] = "";
+ j["reason"] = _("Calls are controlled here; the audio plays on the iPhone.");
return j;
}
diff --git a/src/gtk/calls_view.cpp b/src/gtk/calls_view.cpp
index c9072f4..725f77a 100644
--- a/src/gtk/calls_view.cpp
+++ b/src/gtk/calls_view.cpp
@@ -133,6 +133,10 @@ namespace tether::ui {
std::string secondary = state_text(state);
if (!name.empty() && !number.empty())
secondary += secondary.empty() ? number : " - " + number;
+
+ if (call.value("connected", false))
+ secondary += std::string("\n") + _("Calls are controlled here; the audio plays on the iPhone.");
+
GtkWidget* secondary_label = gtk_label_new(secondary.c_str());
gtk_label_set_xalign(GTK_LABEL(secondary_label), 0.0);
gtk_style_context_add_class(gtk_widget_get_style_context(secondary_label), "muted");
@@ -203,7 +207,7 @@ namespace tether::ui {
const std::string reason = calls.is_object() ? calls.value("reason", "") : "";
set_text(g_calls.status_label,
g_calls.available
- ? _("No calls.")
+ ? std::string(_("No calls.")) + (reason.empty() ? "" : "\n" + reason)
: (reason.empty() ? _("Call control is off. Turn it on with 'tether --bt-calls-enable on'.")
: reason));
if (g_calls.visible)