Linux + iPhone Continuity / iMessage / SMS
docs: document hfp findings
Zack Barteld5c861401537
diff --git a/README.md b/README.mdindex 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 NotificationsRead 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 PairingThere 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 HandlingStreamline 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.mdindex 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 arepo-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 insteadPipeWire'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 errorDropping `hfp_hf` from `bluez5.roles` makes BlueZ's profile connect immediately andexport `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 exportedby 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.poindex 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.cppmsgid "Not a dialable number."msgstr "Není to vytáčitelné číslo."diff --git a/po/de.po b/po/de.poindex 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.cppmsgid "Not a dialable number."msgstr "Keine wählbare Nummer."diff --git a/po/es.po b/po/es.poindex 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.cppmsgid "Not a dialable number."msgstr "No es un número marcable."diff --git a/po/fr.po b/po/fr.poindex 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.cppmsgid "Not a dialable number."msgstr "Numéro non composable."diff --git a/po/it.po b/po/it.poindex 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.cppmsgid "Not a dialable number."msgstr "Non è un numero componibile."diff --git a/po/ja.po b/po/ja.poindex 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.cppmsgid "Not a dialable number."msgstr "発信できる番号ではありません。"diff --git a/po/ko.po b/po/ko.poindex 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.cppmsgid "Not a dialable number."msgstr "전화를 걸 수 있는 번호가 아닙니다."diff --git a/po/nl.po b/po/nl.poindex 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.cppmsgid "Not a dialable number."msgstr "Geen belbaar nummer."diff --git a/po/pl.po b/po/pl.poindex 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.cppmsgid "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.poindex 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.cppmsgid "Not a dialable number."msgstr "Não é um número discável."diff --git a/po/ru.po b/po/ru.poindex 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.cppmsgid "Not a dialable number."msgstr "Такой номер набрать нельзя."diff --git a/po/sv.po b/po/sv.poindex 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.cppmsgid "Not a dialable number."msgstr "Inte ett uppringbart nummer."diff --git a/po/tether.pot b/po/tether.potindex 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.cppmsgid "Not a dialable number."msgstr ""diff --git a/po/tr.po b/po/tr.poindex 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.cppmsgid "Not a dialable number."msgstr "Aranabilir bir numara değil."diff --git a/po/uk.po b/po/uk.poindex 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.cppmsgid "Not a dialable number."msgstr "Такий номер набрати не можна."diff --git a/po/zh_CN.po b/po/zh_CN.poindex 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.cppmsgid "Not a dialable number."msgstr "不是可拨打的号码。"diff --git a/scripts/bt-probe.sh b/scripts/bt-probe.shindex 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 connectedset -uo pipefail@@ -18,7 +21,11 @@ TARGET_COD_LOW=0x0408COD_MASK=0x1fffset_class=0-[[ ${1:-} == --set-class ]] && set_class=1+calls_only=0+case ${1:-} in+ --set-class) set_class=1 ;;+ --calls) calls_only=1 ;;+esacred=$'\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+echoecho "Tether Bluetooth capability probe"echo "================================="diff --git a/src/core/src/bluetooth/telephony.cpp b/src/core/src/bluetooth/telephony.cppindex 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.cppindex 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)