Skip to content

Linux + iPhone Continuity / iMessage / SMS

fix: appimage btclass setup

Zack Bartel3c829576701d
diff --git a/README.md b/README.md
index e8946d2..55038a3 100644
--- a/README.md
+++ b/README.md
@@ -102,6 +102,9 @@ chmod +x tether-*-x86_64.AppImage
./tether-*-x86_64.AppImage --install-extension-host # if you use the browser or mail extension
```
+The iPhone Bluetooth features need a systemd unit the AppImage cannot install for you.
+`--bt-setup` prints the command that writes it.
+
Requires glibc 2.38 and libstdc++ from GCC 13 (Fedora 39+, Ubuntu 23.10+, Debian 13+, Arch).
### Flatpak
diff --git a/docs/BLUETOOTH.md b/docs/BLUETOOTH.md
index c09b4df..79235be 100644
--- a/docs/BLUETOOTH.md
+++ b/docs/BLUETOOTH.md
@@ -47,7 +47,7 @@ class. `sudo btmgmt class 4 8` sets it for now.
**It does not survive a `bluetoothd` restart**. bluetoothd rewrites the
class from its own default every time it starts. Already-granted session survives that, but a phone that has not yet granted the permissions will refuse MAP and PBAP with an OBEX error that seems like a missing service record rather than
like a permissions problem.
-The packaged unit handles that:
+A packaged install handles that with a unit it already put on disk:
```bash
sudo systemctl enable --now tether-btclass@hci0
@@ -56,6 +56,13 @@ sudo systemctl enable --now tether-btclass@hci0
`PartOf=bluetooth.service` re-runs it on every `bluetooth.service` restart. It writes the
class, reads it back, and retries for ten seconds.
+**A portable build has no unit on disk to enable**, since neither the AppImage nor the Flatpak
+can write a system directory. That command fails there with `Unit [email protected]
+does not exist`. The unit text is compiled into the binary instead, and `--bt-setup` prints the
+form that applies to the running build: the AppImage prints `sudo "$APPIMAGE"
+--install-btclass-unit` to write the unit out first, everything else prints it as a
+here-document. Take the command from `--bt-setup` rather than from here.
+
**BlueZ needs the experimental bearer API** for ANCS, and it must be active
*before* pairing: a bond made without it has no LE half. `--bt-setup` prints the
drop-in command:
@@ -77,7 +84,8 @@ a wrong `ExecStart` leaves `bluetooth.service` failing with `status=203/EXEC`.
Nothing is installed into `bluetooth.service.d` by the package: a drop-in there
takes effect the moment the package lands, and changing how `bluetoothd` runs
for the whole machine is the user's decision. The class unit ships but stays
-disabled for the same reason.
+disabled for the same reason, and `--install-btclass-unit` writes it without
+enabling it on the builds that have no package to ship it.
Without it `bluetoothd` still registers `org.bluez.Bearer.LE1`, but as an empty
marker: no properties, no `Connect()`. So the interface being present is not
@@ -397,6 +405,7 @@ checks the daemon does not make.
| Symptom | Cause | What to do |
|---|---|---|
| `systemctl enable --now tether-btclass@hci0` hangs in `activating (start)` forever | `btmgmt` epolls its stdin before running the command, and epoll rejects the `/dev/null` systemd hands it, so it waits having done nothing | Update the unit -- it pipes into `btmgmt` now. On an older build, `sudo btmgmt class 4 8` by hand sets the class until `bluetoothd` restarts, see 2026-09-01 below |
+| `systemctl enable --now tether-btclass@hci0` says `Unit [email protected] does not exist` | A portable build (AppImage, Flatpak) installed no unit -- only the distro packages do | `tether --bt-setup` and run the command it prints, which writes the unit first, see 2026-09-05 below |
| Messages and contacts worked, then stopped, and the error mentions a service record | `bluetoothd` restarted and reset the Class of Device | `sudo systemctl enable --now tether-btclass@hci0`, then re-pair if the phone dropped the bond |
| The phone never offers notifications / Sync Contacts | The class is wrong, or the ANCS advertisement is not running | Check for `class=ok` in `tether --bt-status`, can take minutes |
| MAP or PBAP reports `forbidden` | The matching toggle on the phone is off | Turn it on. This is not a pairing failure |
@@ -2147,3 +2156,42 @@ firmware gets resolving lists wrong.
No known-bad-controller list was added. One report is not a rule, and naming the hardware
in every dump has to come first.
+
+### 2026-09-05 - The setup command the AppImage prints could not be pasted
+
+Reported as #136 from CachyOS: `sudo systemctl enable --now tether-btclass@hci0` answers `Unit
[email protected] does not exist`, so iOS never offers Messages and Contacts.
+
+Correct as far as it goes -- an AppImage installs nothing system-wide, and only the distro
+packages put `[email protected]` in `/usr/lib/systemd/system`. That case was already
+handled: `CMakeLists.txt` compiles the unit text into the binary and `set_class_command()`
+probes the four unit directories, emitting a `sudo tee ... <<'EOF'` here-document when the file
+is absent. The path existed and did not work.
+
+`print_bt_setup()` indented every line of a step's command by five spaces so a multi-line
+command would read as one block. A here-document delimiter only ends the document at column 0
+-- `<<-` strips tabs and never spaces -- so the printed ` EOF` closed nothing:
+
+```
+$ bash step.sh
+warning: here-document at line 1 delimited by end-of-file (wanted `EOF')
+```
+
+Pasted into a terminal the shell sits on a `>` continuation prompt, and the `daemon-reload` and
+`enable` lines that follow are swallowed into the unit body instead of running. The GTK Devices
+page was never affected: its "Copy commands" button copies the raw string and does no
+indentation.
+
+The docs made it worse by never mentioning the split. `docs/BLUETOOTH.md` printed the
+packaged-install command as *the* answer and contained no occurrence of "AppImage", "Flatpak" or
+"portable"; the README's AppImage section did not mention the class unit at all. So a portable
+user following the documentation reached a command that cannot work, with nothing pointing at
+`--bt-setup`.
+
+Fixed by printing command lines flush left, which removes the failure mode rather than working
+around it, and by adding `tether --install-btclass-unit`: it writes the embedded unit to
+`/etc/systemd/system/[email protected]`, refuses without root, and never enables anything,
+so the AppImage now prints three short lines instead of a 24-line paste. Flatpak keeps the
+here-document, because `flatpak run` under `sudo` is the wrong user. The test on
+`set_class_command()` now asserts the unit text ends in a newline and that the here-document
+carries a bare `EOF` line to close it.
diff --git a/docs/img/tether_header_small.png b/docs/img/tether_header_small.png
new file mode 100644
index 0000000..81a4a02
Binary files /dev/null and b/docs/img/tether_header_small.png differ
diff --git a/docs/man/man1/tether.1.in b/docs/man/man1/tether.1.in
index 7449425..ac77f52 100644
--- a/docs/man/man1/tether.1.in
+++ b/docs/man/man1/tether.1.in
@@ -60,6 +60,11 @@ Install the browser and mail extension's native messaging manifests into this
user's Firefox, Thunderbird, and Chromium directories, pointing at a wrapper in
\fB~/.local/bin\fR. Needed only for a portable build such as the AppImage; the
distro packages install the manifests system\-wide.
+.TP
+\fB\-\-install-btclass-unit\fR
+Write \[email protected]\fR to \fB/etc/systemd/system\fR. Needs root, and
+never enables it. Needed only for a portable build such as the AppImage; the distro
+packages install the unit themselves. See \fB\-\-bt-setup\fR.
.SH BLUETOOTH OPTIONS
Bluetooth carries iPhone messages (MAP), contacts (PBAP), and notification
mirroring (ANCS). It is independent of the Wi-Fi pairing above.
@@ -69,8 +74,9 @@ Show the one-time system setup Bluetooth still needs, with the command for each
step. Nothing is applied: the steps change how the machine behaves over
Bluetooth outside Tether, so running them is left to the user. One step enables
\fBtether-btclass@\fR\fIADAPTER\fR\fB.service\fR, which is installed by the
-package but never enabled for you. A portable build installs neither file, so
-the printed commands write them out instead.
+package but never enabled for you. A portable build has no unit on disk, so the
+printed command writes it out first: with \fB\-\-install-btclass-unit\fR on
+the AppImage, and as a here\-document elsewhere.
.TP
\fB\-\-bt-status\fR
Show Bluetooth adapter capability and delivery mode.
@@ -174,13 +180,8 @@ tether \-\-bt-setup
\fB/usr/lib/systemd/system/tether\[email protected]\fR
Sets the Bluetooth adapter's Class of Device to A/V Hands\-Free, which iOS
requires before it will offer its Messages and Contacts permissions. Installed
-but not enabled; see \fB\-\-bt-setup\fR.
-.TP
-\fB/usr/share/tether/bluetooth\-experimental.conf\fR
-systemd drop\-in that runs \fBbluetoothd\fR with \fB\-\-experimental\fR, which
-exposes the LE bearer interface ANCS notification mirroring needs. Copy it into
-\fB/etc/systemd/system/bluetooth.service.d/\fR to apply it; see
-\fB\-\-bt-setup\fR. It must be in place before pairing.
+by the distro packages but never enabled; a portable build writes it to
+\fB/etc/systemd/system\fR instead. See \fB\-\-bt-setup\fR.
.SH SEE ALSO
.BR tetherd (8),
.BR tether-gtk (1)
diff --git a/po/cs.po b/po/cs.po
index d13433c..9ca609d 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 18:25-0700\n"
+"POT-Creation-Date: 2026-09-05 11:01-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Czech\n"
@@ -193,6 +193,13 @@ msgstr ""
"poštu pro tohoto uživatele. Potřeba jen u přenosných sestavení; distribuční "
"balíčky je instalují pro celý systém."
+#: src/cli/main.cpp
+msgid ""
+"Write the [email protected] unit, which sets the Bluetooth adapter "
+"class iOS requires. Needs root, and never enables it. Needed only for "
+"portable builds; the distro packages install it."
+msgstr "Zapíše jednotku [email protected], která nastavuje třídu adaptéru Bluetooth vyžadovanou systémem iOS. Vyžaduje root a nikdy ji nepovolí. Potřebné pouze pro přenosná sestavení; balíčky distribuce ji instalují samy."
+
#: src/cli/main.cpp
msgid "Accept a pending pairing request locally."
msgstr "Přijmout čekající žádost o spárování místně."
@@ -241,6 +248,24 @@ msgstr ""
"\n"
"Restartujte prohlížeč nebo poštovního klienta, aby se změna projevila.\n"
+#: src/cli/main.cpp
+#, c++-format
+msgid "Writing {} needs root. Run this with sudo.\n"
+msgstr "Zápis {} vyžaduje root. Spusťte to přes sudo.\n"
+
+#: src/cli/main.cpp
+#, c++-format
+msgid "Could not write {}.\n"
+msgstr "Nepodařilo se zapsat {}.\n"
+
+#: src/cli/main.cpp
+#, c-format
+msgid ""
+"\n"
+"It is not enabled. Run 'systemctl daemon-reload', then 'systemctl enable --"
+"now tether-btclass@hci0' to apply it.\n"
+msgstr "\nNení povolena. Spusťte 'systemctl daemon-reload' a poté 'systemctl enable --now tether-btclass@hci0', aby se použila.\n"
+
#: src/cli/main.cpp
msgid "Could not read Bluetooth status from the daemon.\n"
msgstr "Nepodařilo se načíst stav Bluetooth od démona.\n"
@@ -761,7 +786,11 @@ msgid ""
"is never asked for the service. Nothing on the iPhone changes this and re-"
"pairing will not either. Check the controller with tether --bt-status; "
"another one can be selected with tether --bt-adapter."
-msgstr "Tento počítač nevysílá požadavek na oznámení, takže iPhone o službu nikdy není požádán. Nic na iPhonu to nezmění a opětovné párování také ne. Zkontrolujte řadič pomocí tether --bt-status; jiný lze vybrat pomocí tether --bt-adapter."
+msgstr ""
+"Tento počítač nevysílá požadavek na oznámení, takže iPhone o službu nikdy "
+"není požádán. Nic na iPhonu to nezmění a opětovné párování také ne. "
+"Zkontrolujte řadič pomocí tether --bt-status; jiný lze vybrat pomocí tether "
+"--bt-adapter."
#: src/core/src/bluetooth/bearer_supervisor.cpp
msgid ""
diff --git a/po/de.po b/po/de.po
index 269d525..238680e 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 18:25-0700\n"
+"POT-Creation-Date: 2026-09-05 11:01-0700\n"
"PO-Revision-Date: 2026-08-22\n"
"Last-Translator: Tether project\n"
"Language-Team: German\n"
@@ -195,6 +195,13 @@ msgstr ""
"für diesen Benutzer. Nur für portable Builds nötig; die Distributionspakete "
"installieren sie systemweit."
+#: src/cli/main.cpp
+msgid ""
+"Write the [email protected] unit, which sets the Bluetooth adapter "
+"class iOS requires. Needs root, and never enables it. Needed only for "
+"portable builds; the distro packages install it."
+msgstr "Schreibt die Unit [email protected], die die von iOS geforderte Bluetooth-Adapterklasse setzt. Benötigt root und aktiviert sie nie. Nur für portable Builds nötig; die Distributionspakete installieren sie selbst."
+
#: src/cli/main.cpp
msgid "Accept a pending pairing request locally."
msgstr "Eine ausstehende Kopplungsanfrage lokal annehmen."
@@ -243,6 +250,24 @@ msgstr ""
"\n"
"Starte den Browser oder das Mail-Programm neu, damit es übernommen wird.\n"
+#: src/cli/main.cpp
+#, c++-format
+msgid "Writing {} needs root. Run this with sudo.\n"
+msgstr "Das Schreiben von {} erfordert root. Führen Sie dies mit sudo aus.\n"
+
+#: src/cli/main.cpp
+#, c++-format
+msgid "Could not write {}.\n"
+msgstr "{} konnte nicht geschrieben werden.\n"
+
+#: src/cli/main.cpp
+#, c-format
+msgid ""
+"\n"
+"It is not enabled. Run 'systemctl daemon-reload', then 'systemctl enable --"
+"now tether-btclass@hci0' to apply it.\n"
+msgstr "\nSie ist nicht aktiviert. Führen Sie 'systemctl daemon-reload' aus und danach 'systemctl enable --now tether-btclass@hci0', um sie anzuwenden.\n"
+
#: src/cli/main.cpp
msgid "Could not read Bluetooth status from the daemon.\n"
msgstr "Der Bluetooth-Status konnte nicht vom Daemon gelesen werden.\n"
@@ -768,7 +793,11 @@ msgid ""
"is never asked for the service. Nothing on the iPhone changes this and re-"
"pairing will not either. Check the controller with tether --bt-status; "
"another one can be selected with tether --bt-adapter."
-msgstr "Dieser Computer sendet die Benachrichtigungsanfrage nicht aus, das iPhone wird also nie nach dem Dienst gefragt. Daran ändert weder etwas am iPhone noch ein erneutes Koppeln etwas. Prüfen Sie den Controller mit tether --bt-status; ein anderer lässt sich mit tether --bt-adapter auswählen."
+msgstr ""
+"Dieser Computer sendet die Benachrichtigungsanfrage nicht aus, das iPhone "
+"wird also nie nach dem Dienst gefragt. Daran ändert weder etwas am iPhone "
+"noch ein erneutes Koppeln etwas. Prüfen Sie den Controller mit tether --bt-"
+"status; ein anderer lässt sich mit tether --bt-adapter auswählen."
#: src/core/src/bluetooth/bearer_supervisor.cpp
msgid ""
diff --git a/po/es.po b/po/es.po
index ca094a8..b0420aa 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 18:25-0700\n"
+"POT-Creation-Date: 2026-09-05 11:01-0700\n"
"PO-Revision-Date: 2026-08-22\n"
"Last-Translator: Tether project\n"
"Language-Team: Spanish\n"
@@ -195,6 +195,13 @@ msgstr ""
"de correo para este usuario. Solo es necesario en compilaciones portables; "
"los paquetes de la distribución los instalan para todo el sistema."
+#: src/cli/main.cpp
+msgid ""
+"Write the [email protected] unit, which sets the Bluetooth adapter "
+"class iOS requires. Needs root, and never enables it. Needed only for "
+"portable builds; the distro packages install it."
+msgstr "Escribe la unidad [email protected], que establece la clase de adaptador Bluetooth que iOS requiere. Necesita root y nunca la activa. Solo es necesario para compilaciones portables; los paquetes de la distribución la instalan."
+
#: src/cli/main.cpp
msgid "Accept a pending pairing request locally."
msgstr "Aceptar localmente una solicitud de emparejamiento pendiente."
@@ -243,6 +250,24 @@ msgstr ""
"\n"
"Reinicia el navegador o el cliente de correo para que lo detecte.\n"
+#: src/cli/main.cpp
+#, c++-format
+msgid "Writing {} needs root. Run this with sudo.\n"
+msgstr "Escribir {} requiere root. Ejecútalo con sudo.\n"
+
+#: src/cli/main.cpp
+#, c++-format
+msgid "Could not write {}.\n"
+msgstr "No se pudo escribir {}.\n"
+
+#: src/cli/main.cpp
+#, c-format
+msgid ""
+"\n"
+"It is not enabled. Run 'systemctl daemon-reload', then 'systemctl enable --"
+"now tether-btclass@hci0' to apply it.\n"
+msgstr "\nNo está activada. Ejecuta 'systemctl daemon-reload' y luego 'systemctl enable --now tether-btclass@hci0' para aplicarla.\n"
+
#: src/cli/main.cpp
msgid "Could not read Bluetooth status from the daemon.\n"
msgstr "No se pudo leer el estado de Bluetooth del daemon.\n"
@@ -764,7 +789,11 @@ msgid ""
"is never asked for the service. Nothing on the iPhone changes this and re-"
"pairing will not either. Check the controller with tether --bt-status; "
"another one can be selected with tether --bt-adapter."
-msgstr "Este equipo no está emitiendo la solicitud de notificaciones, así que nunca se le pide el servicio al iPhone. Nada en el iPhone cambia esto, y volver a emparejar tampoco. Compruebe la controladora con tether --bt-status; se puede elegir otra con tether --bt-adapter."
+msgstr ""
+"Este equipo no está emitiendo la solicitud de notificaciones, así que nunca "
+"se le pide el servicio al iPhone. Nada en el iPhone cambia esto, y volver a "
+"emparejar tampoco. Compruebe la controladora con tether --bt-status; se "
+"puede elegir otra con tether --bt-adapter."
#: src/core/src/bluetooth/bearer_supervisor.cpp
msgid ""
diff --git a/po/fr.po b/po/fr.po
index 0211629..57be65c 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 18:25-0700\n"
+"POT-Creation-Date: 2026-09-05 11:01-0700\n"
"PO-Revision-Date: 2026-08-22\n"
"Last-Translator: Tether project\n"
"Language-Team: French\n"
@@ -199,6 +199,13 @@ msgstr ""
"portables ; les paquets de la distribution les installent pour tout le "
"système."
+#: src/cli/main.cpp
+msgid ""
+"Write the [email protected] unit, which sets the Bluetooth adapter "
+"class iOS requires. Needs root, and never enables it. Needed only for "
+"portable builds; the distro packages install it."
+msgstr "Écrit l'unité [email protected], qui définit la classe d'adaptateur Bluetooth exigée par iOS. Nécessite root et ne l'active jamais. Utile uniquement pour les builds portables ; les paquets de la distribution l'installent."
+
#: src/cli/main.cpp
msgid "Accept a pending pairing request locally."
msgstr "Accepter localement une demande d'appairage en attente."
@@ -248,6 +255,24 @@ msgstr ""
"Redémarrez le navigateur ou le client de messagerie pour qu'il en tienne "
"compte.\n"
+#: src/cli/main.cpp
+#, c++-format
+msgid "Writing {} needs root. Run this with sudo.\n"
+msgstr "L'écriture de {} nécessite root. Lancez ceci avec sudo.\n"
+
+#: src/cli/main.cpp
+#, c++-format
+msgid "Could not write {}.\n"
+msgstr "Impossible d'écrire {}.\n"
+
+#: src/cli/main.cpp
+#, c-format
+msgid ""
+"\n"
+"It is not enabled. Run 'systemctl daemon-reload', then 'systemctl enable --"
+"now tether-btclass@hci0' to apply it.\n"
+msgstr "\nElle n'est pas activée. Lancez 'systemctl daemon-reload', puis 'systemctl enable --now tether-btclass@hci0' pour l'appliquer.\n"
+
#: src/cli/main.cpp
msgid "Could not read Bluetooth status from the daemon.\n"
msgstr "Impossible de lire l'état Bluetooth depuis le démon.\n"
@@ -769,7 +794,11 @@ msgid ""
"is never asked for the service. Nothing on the iPhone changes this and re-"
"pairing will not either. Check the controller with tether --bt-status; "
"another one can be selected with tether --bt-adapter."
-msgstr "Cet ordinateur n'émet pas la demande de notifications, l'iPhone n'est donc jamais sollicité pour le service. Rien sur l'iPhone n'y change quoi que ce soit, et refaire l'appairage non plus. Vérifiez le contrôleur avec tether --bt-status ; on peut en choisir un autre avec tether --bt-adapter."
+msgstr ""
+"Cet ordinateur n'émet pas la demande de notifications, l'iPhone n'est donc "
+"jamais sollicité pour le service. Rien sur l'iPhone n'y change quoi que ce "
+"soit, et refaire l'appairage non plus. Vérifiez le contrôleur avec tether --"
+"bt-status ; on peut en choisir un autre avec tether --bt-adapter."
#: src/core/src/bluetooth/bearer_supervisor.cpp
msgid ""
diff --git a/po/it.po b/po/it.po
index d2aadd1..37459d7 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 18:25-0700\n"
+"POT-Creation-Date: 2026-09-05 11:01-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Italian\n"
@@ -196,6 +196,13 @@ msgstr ""
"posta per questo utente. Serve solo alle build portabili; i pacchetti della "
"distribuzione li installano a livello di sistema."
+#: src/cli/main.cpp
+msgid ""
+"Write the [email protected] unit, which sets the Bluetooth adapter "
+"class iOS requires. Needs root, and never enables it. Needed only for "
+"portable builds; the distro packages install it."
+msgstr "Scrive l'unità [email protected], che imposta la classe dell'adattatore Bluetooth richiesta da iOS. Richiede root e non la abilita mai. Serve solo per le build portabili; i pacchetti della distribuzione la installano."
+
#: src/cli/main.cpp
msgid "Accept a pending pairing request locally."
msgstr "Accetta localmente una richiesta di accoppiamento in sospeso."
@@ -244,6 +251,24 @@ msgstr ""
"\n"
"Riavvia il browser o il client di posta per applicare la modifica.\n"
+#: src/cli/main.cpp
+#, c++-format
+msgid "Writing {} needs root. Run this with sudo.\n"
+msgstr "Scrivere {} richiede root. Esegui questo comando con sudo.\n"
+
+#: src/cli/main.cpp
+#, c++-format
+msgid "Could not write {}.\n"
+msgstr "Impossibile scrivere {}.\n"
+
+#: src/cli/main.cpp
+#, c-format
+msgid ""
+"\n"
+"It is not enabled. Run 'systemctl daemon-reload', then 'systemctl enable --"
+"now tether-btclass@hci0' to apply it.\n"
+msgstr "\nNon è abilitata. Esegui 'systemctl daemon-reload', poi 'systemctl enable --now tether-btclass@hci0' per applicarla.\n"
+
#: src/cli/main.cpp
msgid "Could not read Bluetooth status from the daemon.\n"
msgstr "Impossibile leggere lo stato Bluetooth dal daemon.\n"
@@ -764,7 +789,11 @@ msgid ""
"is never asked for the service. Nothing on the iPhone changes this and re-"
"pairing will not either. Check the controller with tether --bt-status; "
"another one can be selected with tether --bt-adapter."
-msgstr "Questo computer non sta trasmettendo la richiesta di notifiche, quindi all'iPhone non viene mai chiesto il servizio. Nulla sull'iPhone lo cambia, e nemmeno rifare l'associazione. Controlla il controller con tether --bt-status; se ne può scegliere un altro con tether --bt-adapter."
+msgstr ""
+"Questo computer non sta trasmettendo la richiesta di notifiche, quindi "
+"all'iPhone non viene mai chiesto il servizio. Nulla sull'iPhone lo cambia, e "
+"nemmeno rifare l'associazione. Controlla il controller con tether --bt-"
+"status; se ne può scegliere un altro con tether --bt-adapter."
#: src/core/src/bluetooth/bearer_supervisor.cpp
msgid ""
diff --git a/po/ja.po b/po/ja.po
index b2dc6c8..57e2251 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 18:25-0700\n"
+"POT-Creation-Date: 2026-09-05 11:01-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Japanese\n"
@@ -194,6 +194,13 @@ msgstr ""
"ユーザー用にインストールします。ポータブルビルドでのみ必要です。ディストリ"
"ビューションのパッケージはシステム全体にインストールします。"
+#: src/cli/main.cpp
+msgid ""
+"Write the [email protected] unit, which sets the Bluetooth adapter "
+"class iOS requires. Needs root, and never enables it. Needed only for "
+"portable builds; the distro packages install it."
+msgstr "iOS が要求する Bluetooth アダプターのクラスを設定する [email protected] ユニットを書き出します。root が必要で、有効化は行いません。ポータブルビルドでのみ必要です。ディストリビューションのパッケージは自分でインストールします。"
+
#: src/cli/main.cpp
msgid "Accept a pending pairing request locally."
msgstr "保留中のペアリング要求をローカルで承認します。"
@@ -242,6 +249,24 @@ msgstr ""
"\n"
"反映するにはブラウザーまたはメールクライアントを再起動してください。\n"
+#: src/cli/main.cpp
+#, c++-format
+msgid "Writing {} needs root. Run this with sudo.\n"
+msgstr "{} の書き込みには root が必要です。sudo で実行してください。\n"
+
+#: src/cli/main.cpp
+#, c++-format
+msgid "Could not write {}.\n"
+msgstr "{} を書き込めませんでした。\n"
+
+#: src/cli/main.cpp
+#, c-format
+msgid ""
+"\n"
+"It is not enabled. Run 'systemctl daemon-reload', then 'systemctl enable --"
+"now tether-btclass@hci0' to apply it.\n"
+msgstr "\n有効にはなっていません。適用するには 'systemctl daemon-reload' を実行し、続けて 'systemctl enable --now tether-btclass@hci0' を実行してください。\n"
+
#: src/cli/main.cpp
msgid "Could not read Bluetooth status from the daemon.\n"
msgstr "デーモンから Bluetooth の状態を読み取れませんでした。\n"
@@ -749,7 +774,11 @@ msgid ""
"is never asked for the service. Nothing on the iPhone changes this and re-"
"pairing will not either. Check the controller with tether --bt-status; "
"another one can be selected with tether --bt-adapter."
-msgstr "このコンピューターが通知の要求を電波に乗せていないため、iPhone にサービスが要求されることがありません。iPhone 側では解決できず、ペアリングをやり直しても変わりません。tether --bt-status でコントローラーを確認してください。別のものは tether --bt-adapter で選べます。"
+msgstr ""
+"このコンピューターが通知の要求を電波に乗せていないため、iPhone にサービスが要"
+"求されることがありません。iPhone 側では解決できず、ペアリングをやり直しても変"
+"わりません。tether --bt-status でコントローラーを確認してください。別のもの"
+"は tether --bt-adapter で選べます。"
#: src/core/src/bluetooth/bearer_supervisor.cpp
msgid ""
diff --git a/po/ko.po b/po/ko.po
index 020ec86..7057fba 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 18:25-0700\n"
+"POT-Creation-Date: 2026-09-05 11:01-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Korean\n"
@@ -193,6 +193,13 @@ msgstr ""
"설치합니다. 휴대용 빌드에만 필요하며, 배포판 패키지는 시스템 전체에 설치합니"
"다."
+#: src/cli/main.cpp
+msgid ""
+"Write the [email protected] unit, which sets the Bluetooth adapter "
+"class iOS requires. Needs root, and never enables it. Needed only for "
+"portable builds; the distro packages install it."
+msgstr "iOS가 요구하는 블루투스 어댑터 클래스를 설정하는 [email protected] 유닛을 씁니다. root가 필요하며 활성화는 하지 않습니다. 포터블 빌드에만 필요합니다. 배포판 패키지는 직접 설치합니다."
+
#: src/cli/main.cpp
msgid "Accept a pending pairing request locally."
msgstr "대기 중인 페어링 요청을 로컬에서 수락합니다."
@@ -241,6 +248,24 @@ msgstr ""
"\n"
"적용하려면 브라우저나 메일 클라이언트를 다시 시작하세요.\n"
+#: src/cli/main.cpp
+#, c++-format
+msgid "Writing {} needs root. Run this with sudo.\n"
+msgstr "{} 쓰기에는 root가 필요합니다. sudo로 실행하세요.\n"
+
+#: src/cli/main.cpp
+#, c++-format
+msgid "Could not write {}.\n"
+msgstr "{}을(를) 쓸 수 없습니다.\n"
+
+#: src/cli/main.cpp
+#, c-format
+msgid ""
+"\n"
+"It is not enabled. Run 'systemctl daemon-reload', then 'systemctl enable --"
+"now tether-btclass@hci0' to apply it.\n"
+msgstr "\n활성화되지 않았습니다. 적용하려면 'systemctl daemon-reload'를 실행한 다음 'systemctl enable --now tether-btclass@hci0'을 실행하세요.\n"
+
#: src/cli/main.cpp
msgid "Could not read Bluetooth status from the daemon.\n"
msgstr "데몬에서 Bluetooth 상태를 읽지 못했습니다.\n"
@@ -742,7 +767,11 @@ msgid ""
"is never asked for the service. Nothing on the iPhone changes this and re-"
"pairing will not either. Check the controller with tether --bt-status; "
"another one can be selected with tether --bt-adapter."
-msgstr "이 컴퓨터가 알림 요청을 송출하지 않아 iPhone에 서비스를 요청하는 일이 없습니다. iPhone에서 할 수 있는 일은 없으며 다시 페어링해도 마찬가지입니다. tether --bt-status로 컨트롤러를 확인하고, tether --bt-adapter로 다른 것을 선택할 수 있습니다."
+msgstr ""
+"이 컴퓨터가 알림 요청을 송출하지 않아 iPhone에 서비스를 요청하는 일이 없습니"
+"다. iPhone에서 할 수 있는 일은 없으며 다시 페어링해도 마찬가지입니다. tether "
+"--bt-status로 컨트롤러를 확인하고, tether --bt-adapter로 다른 것을 선택할 수 "
+"있습니다."
#: src/core/src/bluetooth/bearer_supervisor.cpp
msgid ""
diff --git a/po/nl.po b/po/nl.po
index 945b9cb..8d8db46 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 18:25-0700\n"
+"POT-Creation-Date: 2026-09-05 11:01-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Dutch\n"
@@ -195,6 +195,13 @@ msgstr ""
"voor deze gebruiker. Alleen nodig bij draagbare builds; de "
"distributiepakketten installeren ze systeembreed."
+#: src/cli/main.cpp
+msgid ""
+"Write the [email protected] unit, which sets the Bluetooth adapter "
+"class iOS requires. Needs root, and never enables it. Needed only for "
+"portable builds; the distro packages install it."
+msgstr "Schrijft de unit [email protected], die de Bluetooth-adapterklasse instelt die iOS vereist. Vereist root en schakelt hem nooit in. Alleen nodig voor draagbare builds; de distributiepakketten installeren hem zelf."
+
#: src/cli/main.cpp
msgid "Accept a pending pairing request locally."
msgstr "Een openstaand koppelverzoek lokaal accepteren."
@@ -243,6 +250,24 @@ msgstr ""
"\n"
"Herstart de browser of het mailprogramma om dit te laten werken.\n"
+#: src/cli/main.cpp
+#, c++-format
+msgid "Writing {} needs root. Run this with sudo.\n"
+msgstr "Het schrijven van {} vereist root. Voer dit uit met sudo.\n"
+
+#: src/cli/main.cpp
+#, c++-format
+msgid "Could not write {}.\n"
+msgstr "Kon {} niet schrijven.\n"
+
+#: src/cli/main.cpp
+#, c-format
+msgid ""
+"\n"
+"It is not enabled. Run 'systemctl daemon-reload', then 'systemctl enable --"
+"now tether-btclass@hci0' to apply it.\n"
+msgstr "\nHij is niet ingeschakeld. Voer 'systemctl daemon-reload' uit en daarna 'systemctl enable --now tether-btclass@hci0' om hem toe te passen.\n"
+
#: src/cli/main.cpp
msgid "Could not read Bluetooth status from the daemon.\n"
msgstr "Kon de Bluetooth-status niet van de daemon lezen.\n"
@@ -759,7 +784,11 @@ msgid ""
"is never asked for the service. Nothing on the iPhone changes this and re-"
"pairing will not either. Check the controller with tether --bt-status; "
"another one can be selected with tether --bt-adapter."
-msgstr "Deze computer zendt het meldingsverzoek niet uit, dus de iPhone wordt nooit om de service gevraagd. Niets op de iPhone verandert dit, en opnieuw koppelen ook niet. Controleer de controller met tether --bt-status; een andere kies je met tether --bt-adapter."
+msgstr ""
+"Deze computer zendt het meldingsverzoek niet uit, dus de iPhone wordt nooit "
+"om de service gevraagd. Niets op de iPhone verandert dit, en opnieuw "
+"koppelen ook niet. Controleer de controller met tether --bt-status; een "
+"andere kies je met tether --bt-adapter."
#: src/core/src/bluetooth/bearer_supervisor.cpp
msgid ""
diff --git a/po/pl.po b/po/pl.po
index 5ac21e1..bf8b63a 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 18:25-0700\n"
+"POT-Creation-Date: 2026-09-05 11:01-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Polish\n"
@@ -195,6 +195,13 @@ msgstr ""
"dla tego użytkownika. Potrzebne tylko w wersjach przenośnych; pakiety "
"dystrybucji instalują je systemowo."
+#: src/cli/main.cpp
+msgid ""
+"Write the [email protected] unit, which sets the Bluetooth adapter "
+"class iOS requires. Needs root, and never enables it. Needed only for "
+"portable builds; the distro packages install it."
+msgstr "Zapisuje jednostkę [email protected], która ustawia klasę adaptera Bluetooth wymaganą przez iOS. Wymaga roota i nigdy jej nie włącza. Potrzebne tylko dla wersji przenośnych; pakiety dystrybucji instalują ją same."
+
#: src/cli/main.cpp
msgid "Accept a pending pairing request locally."
msgstr "Zaakceptuj lokalnie oczekujące żądanie parowania."
@@ -243,6 +250,24 @@ msgstr ""
"\n"
"Uruchom ponownie przeglądarkę lub klienta poczty, aby to zadziałało.\n"
+#: src/cli/main.cpp
+#, c++-format
+msgid "Writing {} needs root. Run this with sudo.\n"
+msgstr "Zapis {} wymaga roota. Uruchom to przez sudo.\n"
+
+#: src/cli/main.cpp
+#, c++-format
+msgid "Could not write {}.\n"
+msgstr "Nie udało się zapisać {}.\n"
+
+#: src/cli/main.cpp
+#, c-format
+msgid ""
+"\n"
+"It is not enabled. Run 'systemctl daemon-reload', then 'systemctl enable --"
+"now tether-btclass@hci0' to apply it.\n"
+msgstr "\nNie jest włączona. Uruchom 'systemctl daemon-reload', a następnie 'systemctl enable --now tether-btclass@hci0', aby ją zastosować.\n"
+
#: src/cli/main.cpp
msgid "Could not read Bluetooth status from the daemon.\n"
msgstr "Nie udało się odczytać stanu Bluetooth od demona.\n"
@@ -764,7 +789,11 @@ msgid ""
"is never asked for the service. Nothing on the iPhone changes this and re-"
"pairing will not either. Check the controller with tether --bt-status; "
"another one can be selected with tether --bt-adapter."
-msgstr "Ten komputer nie nadaje żądania powiadomień, więc iPhone nigdy nie jest proszony o tę usługę. Nic po stronie iPhone'a tego nie zmieni, ponowne parowanie także nie. Sprawdź kontroler poleceniem tether --bt-status; inny można wybrać poleceniem tether --bt-adapter."
+msgstr ""
+"Ten komputer nie nadaje żądania powiadomień, więc iPhone nigdy nie jest "
+"proszony o tę usługę. Nic po stronie iPhone'a tego nie zmieni, ponowne "
+"parowanie także nie. Sprawdź kontroler poleceniem tether --bt-status; inny "
+"można wybrać poleceniem tether --bt-adapter."
#: src/core/src/bluetooth/bearer_supervisor.cpp
msgid ""
diff --git a/po/pt_BR.po b/po/pt_BR.po
index 5a5c269..07fd246 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 18:25-0700\n"
+"POT-Creation-Date: 2026-09-05 11:01-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Brazilian Portuguese\n"
@@ -195,6 +195,13 @@ msgstr ""
"mail para este usuário. Necessário apenas em builds portáteis; os pacotes da "
"distribuição os instalam para todo o sistema."
+#: src/cli/main.cpp
+msgid ""
+"Write the [email protected] unit, which sets the Bluetooth adapter "
+"class iOS requires. Needs root, and never enables it. Needed only for "
+"portable builds; the distro packages install it."
+msgstr "Grava a unidade [email protected], que define a classe do adaptador Bluetooth exigida pelo iOS. Precisa de root e nunca a habilita. Necessário apenas para builds portáteis; os pacotes da distribuição a instalam."
+
#: src/cli/main.cpp
msgid "Accept a pending pairing request locally."
msgstr "Aceitar localmente uma solicitação de pareamento pendente."
@@ -244,6 +251,24 @@ msgstr ""
"Reinicie o navegador ou o cliente de e-mail para que a alteração tenha "
"efeito.\n"
+#: src/cli/main.cpp
+#, c++-format
+msgid "Writing {} needs root. Run this with sudo.\n"
+msgstr "Gravar {} exige root. Execute isto com sudo.\n"
+
+#: src/cli/main.cpp
+#, c++-format
+msgid "Could not write {}.\n"
+msgstr "Não foi possível gravar {}.\n"
+
+#: src/cli/main.cpp
+#, c-format
+msgid ""
+"\n"
+"It is not enabled. Run 'systemctl daemon-reload', then 'systemctl enable --"
+"now tether-btclass@hci0' to apply it.\n"
+msgstr "\nEla não está habilitada. Execute 'systemctl daemon-reload' e depois 'systemctl enable --now tether-btclass@hci0' para aplicá-la.\n"
+
#: src/cli/main.cpp
msgid "Could not read Bluetooth status from the daemon.\n"
msgstr "Não foi possível ler o estado do Bluetooth no daemon.\n"
@@ -761,7 +786,11 @@ msgid ""
"is never asked for the service. Nothing on the iPhone changes this and re-"
"pairing will not either. Check the controller with tether --bt-status; "
"another one can be selected with tether --bt-adapter."
-msgstr "Este computador não está transmitindo o pedido de notificações, então o serviço nunca é solicitado ao iPhone. Nada no iPhone muda isso, e refazer o pareamento também não. Verifique a controladora com tether --bt-status; outra pode ser escolhida com tether --bt-adapter."
+msgstr ""
+"Este computador não está transmitindo o pedido de notificações, então o "
+"serviço nunca é solicitado ao iPhone. Nada no iPhone muda isso, e refazer o "
+"pareamento também não. Verifique a controladora com tether --bt-status; "
+"outra pode ser escolhida com tether --bt-adapter."
#: src/core/src/bluetooth/bearer_supervisor.cpp
msgid ""
diff --git a/po/ru.po b/po/ru.po
index 3519bd4..e967f65 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 18:25-0700\n"
+"POT-Creation-Date: 2026-09-05 11:01-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Russian\n"
@@ -195,6 +195,13 @@ msgstr ""
"и почты для этого пользователя. Нужно только для переносимых сборок; пакеты "
"дистрибутивов ставят их для всей системы."
+#: src/cli/main.cpp
+msgid ""
+"Write the [email protected] unit, which sets the Bluetooth adapter "
+"class iOS requires. Needs root, and never enables it. Needed only for "
+"portable builds; the distro packages install it."
+msgstr "Записывает юнит [email protected], задающий класс Bluetooth-адаптера, который требует iOS. Требует root и никогда его не включает. Нужно только для переносимых сборок; пакеты дистрибутива устанавливают его сами."
+
#: src/cli/main.cpp
msgid "Accept a pending pairing request locally."
msgstr "Принять ожидающий запрос на сопряжение локально."
@@ -243,6 +250,24 @@ msgstr ""
"\n"
"Перезапустите браузер или почтовый клиент, чтобы изменения вступили в силу.\n"
+#: src/cli/main.cpp
+#, c++-format
+msgid "Writing {} needs root. Run this with sudo.\n"
+msgstr "Для записи {} нужен root. Запустите это через sudo.\n"
+
+#: src/cli/main.cpp
+#, c++-format
+msgid "Could not write {}.\n"
+msgstr "Не удалось записать {}.\n"
+
+#: src/cli/main.cpp
+#, c-format
+msgid ""
+"\n"
+"It is not enabled. Run 'systemctl daemon-reload', then 'systemctl enable --"
+"now tether-btclass@hci0' to apply it.\n"
+msgstr "\nОн не включён. Выполните 'systemctl daemon-reload', затем 'systemctl enable --now tether-btclass@hci0', чтобы применить его.\n"
+
#: src/cli/main.cpp
msgid "Could not read Bluetooth status from the daemon.\n"
msgstr "Не удалось прочитать состояние Bluetooth у демона.\n"
@@ -766,7 +791,11 @@ msgid ""
"is never asked for the service. Nothing on the iPhone changes this and re-"
"pairing will not either. Check the controller with tether --bt-status; "
"another one can be selected with tether --bt-adapter."
-msgstr "Этот компьютер не передаёт запрос уведомлений в эфир, поэтому iPhone никогда не просят об этой службе. Ничто на iPhone этого не изменит, повторное сопряжение тоже. Проверьте контроллер командой tether --bt-status; другой можно выбрать командой tether --bt-adapter."
+msgstr ""
+"Этот компьютер не передаёт запрос уведомлений в эфир, поэтому iPhone никогда "
+"не просят об этой службе. Ничто на iPhone этого не изменит, повторное "
+"сопряжение тоже. Проверьте контроллер командой tether --bt-status; другой "
+"можно выбрать командой tether --bt-adapter."
#: src/core/src/bluetooth/bearer_supervisor.cpp
msgid ""
diff --git a/po/sv.po b/po/sv.po
index d116c75..f5348c5 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 18:25-0700\n"
+"POT-Creation-Date: 2026-09-05 11:01-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Swedish\n"
@@ -195,6 +195,13 @@ msgstr ""
"för den här användaren. Behövs bara för portabla byggen; "
"distributionspaketen installerar dem systemomfattande."
+#: src/cli/main.cpp
+msgid ""
+"Write the [email protected] unit, which sets the Bluetooth adapter "
+"class iOS requires. Needs root, and never enables it. Needed only for "
+"portable builds; the distro packages install it."
+msgstr "Skriver enheten [email protected], som sätter den Bluetooth-adapterklass som iOS kräver. Kräver root och aktiverar den aldrig. Behövs bara för portabla byggen; distributionspaketen installerar den själva."
+
#: src/cli/main.cpp
msgid "Accept a pending pairing request locally."
msgstr "Godkänn en väntande parkopplingsförfrågan lokalt."
@@ -243,6 +250,24 @@ msgstr ""
"\n"
"Starta om webbläsaren eller e-postklienten för att det ska börja gälla.\n"
+#: src/cli/main.cpp
+#, c++-format
+msgid "Writing {} needs root. Run this with sudo.\n"
+msgstr "Att skriva {} kräver root. Kör detta med sudo.\n"
+
+#: src/cli/main.cpp
+#, c++-format
+msgid "Could not write {}.\n"
+msgstr "Kunde inte skriva {}.\n"
+
+#: src/cli/main.cpp
+#, c-format
+msgid ""
+"\n"
+"It is not enabled. Run 'systemctl daemon-reload', then 'systemctl enable --"
+"now tether-btclass@hci0' to apply it.\n"
+msgstr "\nDen är inte aktiverad. Kör 'systemctl daemon-reload' och sedan 'systemctl enable --now tether-btclass@hci0' för att tillämpa den.\n"
+
#: src/cli/main.cpp
msgid "Could not read Bluetooth status from the daemon.\n"
msgstr "Kunde inte läsa Bluetooth-statusen från demonen.\n"
@@ -758,7 +783,11 @@ msgid ""
"is never asked for the service. Nothing on the iPhone changes this and re-"
"pairing will not either. Check the controller with tether --bt-status; "
"another one can be selected with tether --bt-adapter."
-msgstr "Den här datorn sänder inte ut notisförfrågan, så iPhone blir aldrig tillfrågad om tjänsten. Ingenting på iPhone ändrar det, och att para ihop på nytt gör det inte heller. Kontrollera styrkretsen med tether --bt-status; en annan kan väljas med tether --bt-adapter."
+msgstr ""
+"Den här datorn sänder inte ut notisförfrågan, så iPhone blir aldrig "
+"tillfrågad om tjänsten. Ingenting på iPhone ändrar det, och att para ihop på "
+"nytt gör det inte heller. Kontrollera styrkretsen med tether --bt-status; en "
+"annan kan väljas med tether --bt-adapter."
#: src/core/src/bluetooth/bearer_supervisor.cpp
msgid ""
diff --git a/po/tether.pot b/po/tether.pot
index 38f9ac1..808c47d 100644
--- a/po/tether.pot
+++ b/po/tether.pot
@@ -6,9 +6,9 @@
#, fuzzy
msgid ""
msgstr ""
-"Project-Id-Version: tether 0.2.24\n"
+"Project-Id-Version: tether 0.2.25\n"
"Report-Msgid-Bugs-To: [email protected]\n"
-"POT-Creation-Date: 2026-09-04 18:25-0700\n"
+"POT-Creation-Date: 2026-09-05 11:01-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"
@@ -181,6 +181,13 @@ msgid ""
"system-wide."
msgstr ""
+#: src/cli/main.cpp
+msgid ""
+"Write the [email protected] unit, which sets the Bluetooth adapter "
+"class iOS requires. Needs root, and never enables it. Needed only for "
+"portable builds; the distro packages install it."
+msgstr ""
+
#: src/cli/main.cpp
msgid "Accept a pending pairing request locally."
msgstr ""
@@ -224,6 +231,24 @@ msgid ""
"Restart the browser or mail client to pick this up.\n"
msgstr ""
+#: src/cli/main.cpp
+#, c++-format
+msgid "Writing {} needs root. Run this with sudo.\n"
+msgstr ""
+
+#: src/cli/main.cpp
+#, c++-format
+msgid "Could not write {}.\n"
+msgstr ""
+
+#: src/cli/main.cpp
+#, c-format
+msgid ""
+"\n"
+"It is not enabled. Run 'systemctl daemon-reload', then 'systemctl enable --"
+"now tether-btclass@hci0' to apply it.\n"
+msgstr ""
+
#: src/cli/main.cpp
msgid "Could not read Bluetooth status from the daemon.\n"
msgstr ""
diff --git a/po/tr.po b/po/tr.po
index b48bf96..6afd8b4 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 18:25-0700\n"
+"POT-Creation-Date: 2026-09-05 11:01-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Turkish\n"
@@ -194,6 +194,13 @@ msgstr ""
"için kurar. Yalnızca taşınabilir yapılar için gereklidir; dağıtım paketleri "
"bunları sistem genelinde kurar."
+#: src/cli/main.cpp
+msgid ""
+"Write the [email protected] unit, which sets the Bluetooth adapter "
+"class iOS requires. Needs root, and never enables it. Needed only for "
+"portable builds; the distro packages install it."
+msgstr "iOS'un istediği Bluetooth adaptör sınıfını ayarlayan [email protected] birimini yazar. root gerektirir ve onu asla etkinleştirmez. Yalnızca taşınabilir yapılar için gereklidir; dağıtım paketleri onu kendisi kurar."
+
#: src/cli/main.cpp
msgid "Accept a pending pairing request locally."
msgstr "Bekleyen bir eşleşme isteğini yerel olarak kabul et."
@@ -242,6 +249,24 @@ msgstr ""
"\n"
"Etkili olması için tarayıcıyı veya posta istemcisini yeniden başlatın.\n"
+#: src/cli/main.cpp
+#, c++-format
+msgid "Writing {} needs root. Run this with sudo.\n"
+msgstr "{} yazmak için root gerekir. Bunu sudo ile çalıştırın.\n"
+
+#: src/cli/main.cpp
+#, c++-format
+msgid "Could not write {}.\n"
+msgstr "{} yazılamadı.\n"
+
+#: src/cli/main.cpp
+#, c-format
+msgid ""
+"\n"
+"It is not enabled. Run 'systemctl daemon-reload', then 'systemctl enable --"
+"now tether-btclass@hci0' to apply it.\n"
+msgstr "\nEtkin değil. Uygulamak için 'systemctl daemon-reload' ve ardından 'systemctl enable --now tether-btclass@hci0' çalıştırın.\n"
+
#: src/cli/main.cpp
msgid "Could not read Bluetooth status from the daemon.\n"
msgstr "Bluetooth durumu arka plan hizmetinden okunamadı.\n"
@@ -758,7 +783,11 @@ msgid ""
"is never asked for the service. Nothing on the iPhone changes this and re-"
"pairing will not either. Check the controller with tether --bt-status; "
"another one can be selected with tether --bt-adapter."
-msgstr "Bu bilgisayar bildirim isteğini yayına vermiyor, bu yüzden iPhone'dan hizmet hiçbir zaman istenmiyor. iPhone tarafında hiçbir şey bunu değiştirmez, yeniden eşleştirme de değiştirmez. Denetleyiciyi tether --bt-status ile denetleyin; başka biri tether --bt-adapter ile seçilebilir."
+msgstr ""
+"Bu bilgisayar bildirim isteğini yayına vermiyor, bu yüzden iPhone'dan hizmet "
+"hiçbir zaman istenmiyor. iPhone tarafında hiçbir şey bunu değiştirmez, "
+"yeniden eşleştirme de değiştirmez. Denetleyiciyi tether --bt-status ile "
+"denetleyin; başka biri tether --bt-adapter ile seçilebilir."
#: src/core/src/bluetooth/bearer_supervisor.cpp
msgid ""
diff --git a/po/uk.po b/po/uk.po
index 7ed0a17..7488f46 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 18:25-0700\n"
+"POT-Creation-Date: 2026-09-05 11:01-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Ukrainian\n"
@@ -196,6 +196,13 @@ msgstr ""
"та пошти для цього користувача. Потрібно лише для переносних збірок; пакунки "
"дистрибутивів встановлюють їх для всієї системи."
+#: src/cli/main.cpp
+msgid ""
+"Write the [email protected] unit, which sets the Bluetooth adapter "
+"class iOS requires. Needs root, and never enables it. Needed only for "
+"portable builds; the distro packages install it."
+msgstr "Записує юніт [email protected], який задає клас адаптера Bluetooth, потрібний iOS. Потребує root і ніколи його не вмикає. Потрібно лише для переносних збірок; пакунки дистрибутива встановлюють його самі."
+
#: src/cli/main.cpp
msgid "Accept a pending pairing request locally."
msgstr "Прийняти локально запит на створення пари, що очікує."
@@ -244,6 +251,24 @@ msgstr ""
"\n"
"Перезапустіть браузер або поштовий клієнт, щоб зміни набули чинності.\n"
+#: src/cli/main.cpp
+#, c++-format
+msgid "Writing {} needs root. Run this with sudo.\n"
+msgstr "Для запису {} потрібен root. Запустіть це через sudo.\n"
+
+#: src/cli/main.cpp
+#, c++-format
+msgid "Could not write {}.\n"
+msgstr "Не вдалося записати {}.\n"
+
+#: src/cli/main.cpp
+#, c-format
+msgid ""
+"\n"
+"It is not enabled. Run 'systemctl daemon-reload', then 'systemctl enable --"
+"now tether-btclass@hci0' to apply it.\n"
+msgstr "\nВін не увімкнений. Виконайте 'systemctl daemon-reload', потім 'systemctl enable --now tether-btclass@hci0', щоб застосувати його.\n"
+
#: src/cli/main.cpp
msgid "Could not read Bluetooth status from the daemon.\n"
msgstr "Не вдалося прочитати стан Bluetooth у демона.\n"
@@ -767,7 +792,11 @@ msgid ""
"is never asked for the service. Nothing on the iPhone changes this and re-"
"pairing will not either. Check the controller with tether --bt-status; "
"another one can be selected with tether --bt-adapter."
-msgstr "Цей комп'ютер не передає запит сповіщень в ефір, тож iPhone ніколи не просять про цю службу. Ніщо на iPhone цього не змінить, повторне спарювання теж. Перевірте контролер командою tether --bt-status; інший можна вибрати командою tether --bt-adapter."
+msgstr ""
+"Цей комп'ютер не передає запит сповіщень в ефір, тож iPhone ніколи не "
+"просять про цю службу. Ніщо на iPhone цього не змінить, повторне спарювання "
+"теж. Перевірте контролер командою tether --bt-status; інший можна вибрати "
+"командою tether --bt-adapter."
#: src/core/src/bluetooth/bearer_supervisor.cpp
msgid ""
diff --git a/po/zh_CN.po b/po/zh_CN.po
index e2ab218..1b72896 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 18:25-0700\n"
+"POT-Creation-Date: 2026-09-05 11:01-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Simplified Chinese\n"
@@ -187,6 +187,13 @@ msgstr ""
"为当前用户安装浏览器和邮件扩展的原生消息清单。仅便携版需要;发行版软件包会安"
"装到系统范围。"
+#: src/cli/main.cpp
+msgid ""
+"Write the [email protected] unit, which sets the Bluetooth adapter "
+"class iOS requires. Needs root, and never enables it. Needed only for "
+"portable builds; the distro packages install it."
+msgstr "写入 [email protected] 单元,它设置 iOS 所需的蓝牙适配器类别。需要 root,且从不启用它。仅便携式构建需要;发行版软件包会自行安装。"
+
#: src/cli/main.cpp
msgid "Accept a pending pairing request locally."
msgstr "在本地接受待处理的配对请求。"
@@ -234,6 +241,24 @@ msgstr ""
"\n"
"请重启浏览器或邮件客户端以使其生效。\n"
+#: src/cli/main.cpp
+#, c++-format
+msgid "Writing {} needs root. Run this with sudo.\n"
+msgstr "写入 {} 需要 root。请用 sudo 运行。\n"
+
+#: src/cli/main.cpp
+#, c++-format
+msgid "Could not write {}.\n"
+msgstr "无法写入 {}。\n"
+
+#: src/cli/main.cpp
+#, c-format
+msgid ""
+"\n"
+"It is not enabled. Run 'systemctl daemon-reload', then 'systemctl enable --"
+"now tether-btclass@hci0' to apply it.\n"
+msgstr "\n它尚未启用。运行 'systemctl daemon-reload',然后运行 'systemctl enable --now tether-btclass@hci0' 以应用。\n"
+
#: src/cli/main.cpp
msgid "Could not read Bluetooth status from the daemon.\n"
msgstr "无法从守护进程读取蓝牙状态。\n"
@@ -731,7 +756,10 @@ msgid ""
"is never asked for the service. Nothing on the iPhone changes this and re-"
"pairing will not either. Check the controller with tether --bt-status; "
"another one can be selected with tether --bt-adapter."
-msgstr "这台计算机没有把通知请求发送到空中,因此从未向 iPhone 请求该服务。在 iPhone 上做任何操作都无法改变这一点,重新配对也不行。用 tether --bt-status 检查控制器;可以用 tether --bt-adapter 选择另一个。"
+msgstr ""
+"这台计算机没有把通知请求发送到空中,因此从未向 iPhone 请求该服务。在 iPhone "
+"上做任何操作都无法改变这一点,重新配对也不行。用 tether --bt-status 检查控制"
+"器;可以用 tether --bt-adapter 选择另一个。"
#: src/core/src/bluetooth/bearer_supervisor.cpp
msgid ""
diff --git a/src/cli/main.cpp b/src/cli/main.cpp
index 80b52d2..c20e3ea 100644
--- a/src/cli/main.cpp
+++ b/src/cli/main.cpp
@@ -4,6 +4,7 @@
#include <csignal>
#include <cstring>
#include <ctime>
+#include <fstream>
#include <iostream>
#include <nlohmann/json.hpp>
#include <sstream>
@@ -17,6 +18,7 @@
#include <tether/extension_host.hpp>
#include <tether/i18n.hpp>
#include <tether/log.hpp>
+#include <tether/packaging.hpp>
#include <tether/version.hpp>
#include <thread>
#include <unistd.h>
@@ -218,6 +220,9 @@ static const Opt kOptions[] = {
{"--install-extension-host",
N_("Install the browser and mail extension's native messaging manifests for this user. Needed only for "
"portable builds; the distro packages install them system-wide.")},
+ {"--install-btclass-unit",
+ N_("Write the [email protected] unit, which sets the Bluetooth adapter class iOS requires. Needs "
+ "root, and never enables it. Needed only for portable builds; the distro packages install it.")},
{"--accept <fingerprint>", N_("Accept a pending pairing request locally.")},
{"--forget <fingerprint>", N_("Remove a Wi-Fi pairing and drop its session.")},
{"--pair", N_("Send a pair_request over TCP to the daemon.")},
@@ -277,6 +282,31 @@ static int print_extension_host_install() {
return 0;
}
+// The unit the distro packages install. A portable (AppImage, Flatpak) build has no way to put it there, so the
+// binary gives the commands to run.
+static int install_btclass_unit() {
+ static constexpr const char* kPath = "/etc/systemd/system/[email protected]";
+
+ if (geteuid() != 0) {
+ debug::log(ERR, _("Writing {} needs root. Run this with sudo.\n"), kPath);
+ return 1;
+ }
+
+ std::ofstream out(kPath, std::ios::trunc);
+ out << tether::packaging::BTCLASS_UNIT;
+ out.close();
+ if (!out) {
+ debug::log(ERR, _("Could not write {}.\n"), kPath);
+ return 1;
+ }
+
+ fprintf(stdout, _("Installed %s\n"), kPath);
+ fprintf(stdout,
+ _("\nIt is not enabled. Run 'systemctl daemon-reload', then "
+ "'systemctl enable --now tether-btclass@hci0' to apply it.\n"));
+ return 0;
+}
+
// The two known gaps (adapter class, experimental API) change the machine
// outside Tether, so they are printed for the user to run, never applied here.
static int print_bt_setup(tether::Client& client) {
@@ -309,10 +339,9 @@ static int print_bt_setup(tether::Client& client) {
size_t n = 0;
for (const auto& step : setup) {
fprintf(stdout, "\n%zu. %s\n\n", ++n, step.value("what", "").c_str());
- // Indent every line so a multi-line command still reads as one block.
std::istringstream lines(step.value("command", ""));
for (std::string line; std::getline(lines, line);)
- fprintf(stdout, " %s\n", line.c_str());
+ fprintf(stdout, "%s\n", line.c_str());
}
fprintf(stdout, _("\nRe-run 'tether --bt-setup' afterwards to confirm.\n"));
@@ -899,6 +928,8 @@ int main(int argc, char* argv[]) {
action = "list";
} else if (arg == "--install-extension-host") {
action = "install_extension_host";
+ } else if (arg == "--install-btclass-unit") {
+ action = "install_btclass_unit";
} else if (arg == "--bt-setup") {
action = "bt_setup";
} else if (arg == "--bt-status") {
@@ -1019,6 +1050,9 @@ int main(int argc, char* argv[]) {
if (action == "install_extension_host")
return print_extension_host_install();
+ if (action == "install_btclass_unit")
+ return install_btclass_unit();
+
tether::Client client;
// Fast-path local operations that don't need active daemon connection fundamentally
diff --git a/src/core/src/bluetooth/objects.cpp b/src/core/src/bluetooth/objects.cpp
index 309a007..c73aea9 100644
--- a/src/core/src/bluetooth/objects.cpp
+++ b/src/core/src/bluetooth/objects.cpp
@@ -3,6 +3,7 @@
#include <tether/packaging.hpp>
#include <algorithm>
+#include <cstdlib>
#include <cstring>
#include <filesystem>
#include <fstream>
@@ -398,6 +399,14 @@ namespace tether::bluetooth {
return enable;
}
+ // The AppImage can write the unit itself, which beats pasting it. Flatpak cannot:
+ // "flatpak run" under sudo is the wrong user, so it falls through to the here-document.
+ if (const char* appimage = std::getenv("APPIMAGE"); appimage && *appimage)
+ return "sudo \"" + std::string(appimage) +
+ "\" --install-btclass-unit\n"
+ "sudo systemctl daemon-reload\n" +
+ enable;
+
return "sudo tee /etc/systemd/system/[email protected] >/dev/null <<'EOF'\n" +
std::string(packaging::BTCLASS_UNIT) +
"EOF\n"
diff --git a/test/test_bluetooth_objects.cpp b/test/test_bluetooth_objects.cpp
index db63e45..a4ebe38 100644
--- a/test/test_bluetooth_objects.cpp
+++ b/test/test_bluetooth_objects.cpp
@@ -1,5 +1,9 @@
#include <gtest/gtest.h>
#include <tether/bluetooth/objects.hpp>
+#include <tether/packaging.hpp>
+
+#include <sstream>
+#include <string_view>
using namespace tether::bluetooth;
@@ -559,6 +563,18 @@ TEST(Capability, WrongClassIsReportedButDoesNotDowngradeMode) {
ASSERT_EQ(cap.setup.size(), 1u);
EXPECT_TRUE(cap.setup[0].command.ends_with("sudo systemctl enable --now tether-btclass@hci0"))
<< cap.setup[0].command;
+
+ // The portable-build branch pastes the unit through a here-document, and a here-document
+ // delimiter only ends it at column 0. That is why the unit text has to end in a newline:
+ // without it EOF lands on the last line of the unit and closes nothing.
+ EXPECT_TRUE(std::string_view(tether::packaging::BTCLASS_UNIT).ends_with("\n"));
+ if (cap.setup[0].command.find("<<'EOF'") != std::string::npos) {
+ bool terminated = false;
+ std::istringstream lines(cap.setup[0].command);
+ for (std::string line; std::getline(lines, line);)
+ terminated = terminated || line == "EOF";
+ EXPECT_TRUE(terminated) << cap.setup[0].command;
+ }
}
TEST(Capability, PrefersAPoweredAdapter) {