Skip to content

Linux + iPhone Continuity / iMessage / SMS

docs: update docs to use cleaned up subcommands

Zack Bartel0c43747279e8
diff --git a/README.md b/README.md
index 92b0c12..91878ee 100644
--- a/README.md
+++ b/README.md
@@ -237,8 +237,8 @@ make install
or
```bash
- tether --pending # the requests waiting, with their fingerprints
- tether --accept <fingerprint>
+ tether pending # the requests waiting, with their fingerprints
+ tether accept <fingerprint>
```
3. Bluetooth (for Messages and Notifications):
@@ -247,7 +247,7 @@ make install
needs, with the exact commands:
```bash
- tether --bt-setup
+ tether bt setup
```
Tether never applies these itself: they change how the machine behaves over
@@ -257,7 +257,7 @@ make install
*If* you have more than one Bluetooth controller, pick the one to use. Default is the first powered one.
```bash
- tether --bt-adapter hci1 # or the controller's address, or "auto"
+ tether bt adapter hci1 # or the controller's address, or "auto"
```
Then pair. In the GTK app, pick your iPhone under BLUETOOTH on the Devices
@@ -267,9 +267,9 @@ make install
or
```bash
- tether --bt-devices # find the iPhone's address
- tether --bt-pair <address>
- tether --bt-connection # what is up, and what is not
+ tether bt devices # find the iPhone's address
+ tether bt pair <address>
+ tether bt connection # what is up, and what is not
```
4. On the iPhone, under Settings > Bluetooth > (i) for this computer, enable
@@ -284,10 +284,10 @@ The daemon does not need a Wayland session. Everything but clipboard sync works
over SSH, pairing included:
```bash
-systemctl --user enable --now tetherd.service # portable build? tether --install-service first
-tether --pending # the pairing requests waiting, with fingerprints
-tether --accept 9a4f21...
-tether --status # devices, links, and recent transfers
+systemctl --user enable --now tetherd.service # portable build? tether service first
+tether pending # the pairing requests waiting, with fingerprints
+tether accept 9a4f21...
+tether status # devices, links, and recent transfers
```
See [docs/HEADLESS.md](docs/HEADLESS.md).
@@ -324,7 +324,7 @@ See [docs/HEADLESS.md](docs/HEADLESS.md).
- `bluez`, `bluez-utils`, and `bluez-obex` (for messages and notifications)
#### Bluetooth (for Messages and Notifications)
-- BlueZ 5.86+ must be running with experimental bearer API. `tether --bt-setup`
+- BlueZ 5.86+ must be running with experimental bearer API. `tether bt setup`
prints the systemd drop-in command that enables it. Do this **before** pairing.
- A controller with BR/EDR, LE, and advertising support.
- Notification mirroring does not work on iOS 18 and earlier.
@@ -373,7 +373,7 @@ sudo systemctl enable --now avahi-daemon
Messages and notifications need one-time system setup. See [docs/BLUETOOTH.md](docs/BLUETOOTH.md), or run:
```bash
-tether --bt-setup
+tether bt setup
```
## Security
diff --git a/docs/HEADLESS.md b/docs/HEADLESS.md
index f60ddcc..0bb56a6 100644
--- a/docs/HEADLESS.md
+++ b/docs/HEADLESS.md
@@ -33,7 +33,7 @@ A portable build (an AppImage, or a tree you built yourself) has no package to
install that unit, so the CLI writes one pointed at wherever that build lives:
```bash
-tether --install-service # writes ~/.config/systemd/user/tetherd.service
+tether service # writes ~/.config/systemd/user/tetherd.service
```
It never enables or starts anything: it prints the commands above and leaves the
@@ -52,10 +52,10 @@ to accept, and on the desktop that prompt is a GTK window you do not have here,
so accept it from the shell instead:
```bash
-tether --status # is the daemon up, is mDNS advertising
-tether --pending # the requests waiting, with their fingerprints
-tether --accept 9a4f21c8…
-tether --list-devices # what is paired now
+tether status # is the daemon up, is mDNS advertising
+tether pending # the requests waiting, with their fingerprints
+tether accept 9a4f21c8…
+tether devices # what is paired now
```
If the phone cannot find the machine, mDNS or the firewall is usually why:
@@ -72,10 +72,10 @@ it is still a port.
## Use it
```bash
-tether -f ./report.pdf # to the phone
-tether --status # what arrived, and from whom
-tether --bt-threads # conversations, over Bluetooth
-tether --bt-send <thread> "on my way"
+tether send ./report.pdf # to the phone
+tether status # what arrived, and from whom
+tether bt threads # conversations, over Bluetooth
+tether bt send <thread> "on my way"
```
Files the phone sends land in `$XDG_DOWNLOAD_DIR`, or `~/Downloads`. On a server
@@ -89,7 +89,7 @@ systemctl --user edit tetherd.service
## Clipboard sync
-`tether --status` says `Clipboard: off, no Wayland session on this machine` and
+`tether status` says `Clipboard: off, no Wayland session on this machine` and
that is the whole story: without a compositor there is no clipboard to sync. The
rest of the daemon does not care. If the machine does run a compositor and this
still says off, the compositor is missing `wlr-data-control` or
@@ -101,5 +101,5 @@ The CLI talks to a remote daemon over the same TLS the phone uses:
```bash
tether -g --host 10.0.0.5
-tether --pair --host 10.0.0.5
+tether pair --host 10.0.0.5
```
diff --git a/po/cs.po b/po/cs.po
index 37ef24a..9fe6605 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-10 09:25-0700\n"
+"POT-Creation-Date: 2026-09-10 09:49-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Czech\n"
@@ -852,9 +852,9 @@ msgid ""
"tetherd from whatever this system uses for services, or let a client start "
"it on demand.\n"
msgstr ""
-"V tomto počítači není systemd, takže není žádná uživatelská služba ke správě. "
-"Spusťte tetherd tím, co tento systém používá pro služby, nebo jej nechte "
-"spustit klientem na vyžádání.\n"
+"V tomto počítači není systemd, takže není žádná uživatelská služba ke "
+"správě. Spusťte tetherd tím, co tento systém používá pro služby, nebo jej "
+"nechte spustit klientem na vyžádání.\n"
#: src/cli/main.cpp
#, c-format
@@ -934,6 +934,21 @@ msgstr[0] "Nalezeno %zu zařízení za %.1fs\n"
msgstr[1] "Nalezena %zu zařízení za %.1fs\n"
msgstr[2] "Nalezeno %zu zařízení za %.1fs\n"
+#: src/cli/main.cpp
+msgid ""
+"The daemon is not running, and could not be started. Check the log in "
+"$XDG_STATE_HOME/tether, or start it with 'systemctl --user start "
+"tetherd.service'.\n"
+msgstr ""
+"Démon neběží a nepodařilo se jej spustit. Zkontrolujte log v "
+"$XDG_STATE_HOME/tether, nebo jej spusťte příkazem 'systemctl --user start "
+"tetherd.service'.\n"
+
+#: src/cli/main.cpp
+#, c++-format
+msgid "No daemon answered at {}:{}.\n"
+msgstr "Na {}:{} neodpověděl žádný démon.\n"
+
#: src/cli/main.cpp
msgid ""
"Explicit framework connection locally rejected! Did you target explicitly "
diff --git a/po/de.po b/po/de.po
index d07b722..2d659dd 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-10 09:25-0700\n"
+"POT-Creation-Date: 2026-09-10 09:49-0700\n"
"PO-Revision-Date: 2026-08-22\n"
"Last-Translator: Tether project\n"
"Language-Team: German\n"
@@ -860,8 +860,8 @@ msgid ""
"it on demand.\n"
msgstr ""
"Auf diesem Rechner läuft kein systemd, es gibt also keinen Benutzerdienst zu "
-"verwalten. Starten Sie tetherd über das, was dieses System für Dienste nutzt, "
-"oder lassen Sie ihn von einem Client bei Bedarf starten.\n"
+"verwalten. Starten Sie tetherd über das, was dieses System für Dienste "
+"nutzt, oder lassen Sie ihn von einem Client bei Bedarf starten.\n"
#: src/cli/main.cpp
#, c-format
@@ -941,6 +941,21 @@ msgid_plural "Found %zu devices in %.1fs\n"
msgstr[0] "%zu Gerät in %.1fs gefunden\n"
msgstr[1] "%zu Geräte in %.1fs gefunden\n"
+#: src/cli/main.cpp
+msgid ""
+"The daemon is not running, and could not be started. Check the log in "
+"$XDG_STATE_HOME/tether, or start it with 'systemctl --user start "
+"tetherd.service'.\n"
+msgstr ""
+"Der Daemon läuft nicht und ließ sich nicht starten. Sehen Sie ins Log in "
+"$XDG_STATE_HOME/tether, oder starten Sie ihn mit 'systemctl --user start "
+"tetherd.service'.\n"
+
+#: src/cli/main.cpp
+#, c++-format
+msgid "No daemon answered at {}:{}.\n"
+msgstr "Kein Daemon hat auf {}:{} geantwortet.\n"
+
#: src/cli/main.cpp
msgid ""
"Explicit framework connection locally rejected! Did you target explicitly "
diff --git a/po/es.po b/po/es.po
index ba670c1..c0a644c 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-10 09:25-0700\n"
+"POT-Creation-Date: 2026-09-10 09:49-0700\n"
"PO-Revision-Date: 2026-08-22\n"
"Last-Translator: Tether project\n"
"Language-Team: Spanish\n"
@@ -939,6 +939,21 @@ msgid_plural "Found %zu devices in %.1fs\n"
msgstr[0] "Se encontró %zu dispositivo en %.1fs\n"
msgstr[1] "Se encontraron %zu dispositivos en %.1fs\n"
+#: src/cli/main.cpp
+msgid ""
+"The daemon is not running, and could not be started. Check the log in "
+"$XDG_STATE_HOME/tether, or start it with 'systemctl --user start "
+"tetherd.service'.\n"
+msgstr ""
+"El demonio no está en marcha y no se pudo iniciar. Revisa el registro en "
+"$XDG_STATE_HOME/tether, o inícialo con 'systemctl --user start "
+"tetherd.service'.\n"
+
+#: src/cli/main.cpp
+#, c++-format
+msgid "No daemon answered at {}:{}.\n"
+msgstr "Ningún demonio respondió en {}:{}.\n"
+
#: src/cli/main.cpp
msgid ""
"Explicit framework connection locally rejected! Did you target explicitly "
diff --git a/po/fr.po b/po/fr.po
index 43c31d6..f9f1738 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-10 09:25-0700\n"
+"POT-Creation-Date: 2026-09-10 09:49-0700\n"
"PO-Revision-Date: 2026-08-22\n"
"Last-Translator: Tether project\n"
"Language-Team: French\n"
@@ -943,6 +943,21 @@ msgid_plural "Found %zu devices in %.1fs\n"
msgstr[0] "%zu appareil trouvé en %.1fs\n"
msgstr[1] "%zu appareils trouvés en %.1fs\n"
+#: src/cli/main.cpp
+msgid ""
+"The daemon is not running, and could not be started. Check the log in "
+"$XDG_STATE_HOME/tether, or start it with 'systemctl --user start "
+"tetherd.service'.\n"
+msgstr ""
+"Le démon ne tourne pas et n'a pas pu être démarré. Consultez le journal "
+"dans $XDG_STATE_HOME/tether, ou lancez-le avec 'systemctl --user start "
+"tetherd.service'.\n"
+
+#: src/cli/main.cpp
+#, c++-format
+msgid "No daemon answered at {}:{}.\n"
+msgstr "Aucun démon n'a répondu sur {}:{}.\n"
+
#: src/cli/main.cpp
msgid ""
"Explicit framework connection locally rejected! Did you target explicitly "
diff --git a/po/it.po b/po/it.po
index efd76fb..d23b799 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-10 09:25-0700\n"
+"POT-Creation-Date: 2026-09-10 09:49-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Italian\n"
@@ -937,6 +937,21 @@ msgid_plural "Found %zu devices in %.1fs\n"
msgstr[0] "Trovato %zu dispositivo in %.1fs\n"
msgstr[1] "Trovati %zu dispositivi in %.1fs\n"
+#: src/cli/main.cpp
+msgid ""
+"The daemon is not running, and could not be started. Check the log in "
+"$XDG_STATE_HOME/tether, or start it with 'systemctl --user start "
+"tetherd.service'.\n"
+msgstr ""
+"Il demone non è in esecuzione e non è stato possibile avviarlo. Controlla il "
+"log in $XDG_STATE_HOME/tether, oppure avvialo con 'systemctl --user start "
+"tetherd.service'.\n"
+
+#: src/cli/main.cpp
+#, c++-format
+msgid "No daemon answered at {}:{}.\n"
+msgstr "Nessun demone ha risposto su {}:{}.\n"
+
#: src/cli/main.cpp
msgid ""
"Explicit framework connection locally rejected! Did you target explicitly "
diff --git a/po/ja.po b/po/ja.po
index 34e2b1c..99ff25d 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-10 09:25-0700\n"
+"POT-Creation-Date: 2026-09-10 09:49-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Japanese\n"
@@ -923,6 +923,21 @@ msgid "Found %zu device in %.1fs\n"
msgid_plural "Found %zu devices in %.1fs\n"
msgstr[0] "%2$.1fs で %1$zu 台のデバイスが見つかりました\n"
+#: src/cli/main.cpp
+msgid ""
+"The daemon is not running, and could not be started. Check the log in "
+"$XDG_STATE_HOME/tether, or start it with 'systemctl --user start "
+"tetherd.service'.\n"
+msgstr ""
+"デーモンが実行されておらず、起動もできませんでした。$XDG_STATE_HOME/tether の"
+"ログを確認するか、'systemctl --user start tetherd.service' で起動してくださ"
+"い。\n"
+
+#: src/cli/main.cpp
+#, c++-format
+msgid "No daemon answered at {}:{}.\n"
+msgstr "{}:{} で応答するデーモンがありません。\n"
+
#: src/cli/main.cpp
msgid ""
"Explicit framework connection locally rejected! Did you target explicitly "
diff --git a/po/ko.po b/po/ko.po
index ba569c2..08919b8 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-10 09:25-0700\n"
+"POT-Creation-Date: 2026-09-10 09:49-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Korean\n"
@@ -836,9 +836,9 @@ msgid ""
"tetherd from whatever this system uses for services, or let a client start "
"it on demand.\n"
msgstr ""
-"이 컴퓨터에는 systemd가 없으므로 관리할 사용자 서비스가 없습니다. 이 시스템이 "
-"서비스에 사용하는 방법으로 tetherd를 시작하거나, 클라이언트가 필요할 때 "
-"시작하도록 두십시오.\n"
+"이 컴퓨터에는 systemd가 없으므로 관리할 사용자 서비스가 없습니다. 이 시스템"
+"이 서비스에 사용하는 방법으로 tetherd를 시작하거나, 클라이언트가 필요할 때 시"
+"작하도록 두십시오.\n"
#: src/cli/main.cpp
#, c-format
@@ -914,6 +914,21 @@ msgid "Found %zu device in %.1fs\n"
msgid_plural "Found %zu devices in %.1fs\n"
msgstr[0] "%2$.1f초 만에 기기 %1$zu대를 찾았습니다\n"
+#: src/cli/main.cpp
+msgid ""
+"The daemon is not running, and could not be started. Check the log in "
+"$XDG_STATE_HOME/tether, or start it with 'systemctl --user start "
+"tetherd.service'.\n"
+msgstr ""
+"데몬이 실행 중이 아니며 시작할 수도 없었습니다. $XDG_STATE_HOME/tether의 로그를 "
+"확인하거나 'systemctl --user start tetherd.service'로 시작하십시오."
+"\n"
+
+#: src/cli/main.cpp
+#, c++-format
+msgid "No daemon answered at {}:{}.\n"
+msgstr "{}:{}에서 응답한 데몬이 없습니다.\n"
+
#: src/cli/main.cpp
msgid ""
"Explicit framework connection locally rejected! Did you target explicitly "
diff --git a/po/nl.po b/po/nl.po
index a5dba34..35405e1 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-10 09:25-0700\n"
+"POT-Creation-Date: 2026-09-10 09:49-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Dutch\n"
@@ -856,8 +856,8 @@ msgid ""
"it on demand.\n"
msgstr ""
"Op deze machine draait geen systemd, dus er is geen gebruikersservice om te "
-"beheren. Start tetherd met wat dit systeem voor services gebruikt, of laat een "
-"client hem starten wanneer dat nodig is.\n"
+"beheren. Start tetherd met wat dit systeem voor services gebruikt, of laat "
+"een client hem starten wanneer dat nodig is.\n"
#: src/cli/main.cpp
#, c-format
@@ -935,6 +935,21 @@ msgid_plural "Found %zu devices in %.1fs\n"
msgstr[0] "%zu apparaat gevonden in %.1fs\n"
msgstr[1] "%zu apparaten gevonden in %.1fs\n"
+#: src/cli/main.cpp
+msgid ""
+"The daemon is not running, and could not be started. Check the log in "
+"$XDG_STATE_HOME/tether, or start it with 'systemctl --user start "
+"tetherd.service'.\n"
+msgstr ""
+"De daemon draait niet en kon niet worden gestart. Bekijk het logboek in "
+"$XDG_STATE_HOME/tether, of start hem met 'systemctl --user start "
+"tetherd.service'.\n"
+
+#: src/cli/main.cpp
+#, c++-format
+msgid "No daemon answered at {}:{}.\n"
+msgstr "Geen daemon antwoordde op {}:{}.\n"
+
#: src/cli/main.cpp
msgid ""
"Explicit framework connection locally rejected! Did you target explicitly "
diff --git a/po/pl.po b/po/pl.po
index 1953335..0548419 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-10 09:25-0700\n"
+"POT-Creation-Date: 2026-09-10 09:49-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Polish\n"
@@ -939,6 +939,21 @@ msgstr[0] "Znaleziono %zu urządzenie w %.1fs\n"
msgstr[1] "Znaleziono %zu urządzenia w %.1fs\n"
msgstr[2] "Znaleziono %zu urządzeń w %.1fs\n"
+#: src/cli/main.cpp
+msgid ""
+"The daemon is not running, and could not be started. Check the log in "
+"$XDG_STATE_HOME/tether, or start it with 'systemctl --user start "
+"tetherd.service'.\n"
+msgstr ""
+"Demon nie działa i nie udało się go uruchomić. Sprawdź dziennik w "
+"$XDG_STATE_HOME/tether albo uruchom go poleceniem 'systemctl --user start "
+"tetherd.service'.\n"
+
+#: src/cli/main.cpp
+#, c++-format
+msgid "No daemon answered at {}:{}.\n"
+msgstr "Żaden demon nie odpowiedział na {}:{}.\n"
+
#: src/cli/main.cpp
msgid ""
"Explicit framework connection locally rejected! Did you target explicitly "
diff --git a/po/pt_BR.po b/po/pt_BR.po
index 4ecd15e..4705867 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-10 09:25-0700\n"
+"POT-Creation-Date: 2026-09-10 09:49-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Brazilian Portuguese\n"
@@ -933,6 +933,21 @@ msgid_plural "Found %zu devices in %.1fs\n"
msgstr[0] "%zu dispositivo encontrado em %.1fs\n"
msgstr[1] "%zu dispositivos encontrados em %.1fs\n"
+#: src/cli/main.cpp
+msgid ""
+"The daemon is not running, and could not be started. Check the log in "
+"$XDG_STATE_HOME/tether, or start it with 'systemctl --user start "
+"tetherd.service'.\n"
+msgstr ""
+"O daemon não está em execução e não pôde ser iniciado. Veja o log em "
+"$XDG_STATE_HOME/tether, ou inicie-o com 'systemctl --user start "
+"tetherd.service'.\n"
+
+#: src/cli/main.cpp
+#, c++-format
+msgid "No daemon answered at {}:{}.\n"
+msgstr "Nenhum daemon respondeu em {}:{}.\n"
+
#: src/cli/main.cpp
msgid ""
"Explicit framework connection locally rejected! Did you target explicitly "
diff --git a/po/ru.po b/po/ru.po
index 7241e57..29ffe82 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-10 09:25-0700\n"
+"POT-Creation-Date: 2026-09-10 09:49-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Russian\n"
@@ -941,6 +941,21 @@ msgstr[0] "Найдено %zu устройство за %.1fs\n"
msgstr[1] "Найдено %zu устройства за %.1fs\n"
msgstr[2] "Найдено %zu устройств за %.1fs\n"
+#: src/cli/main.cpp
+msgid ""
+"The daemon is not running, and could not be started. Check the log in "
+"$XDG_STATE_HOME/tether, or start it with 'systemctl --user start "
+"tetherd.service'.\n"
+msgstr ""
+"Демон не запущен, и запустить его не удалось. Проверьте журнал в "
+"$XDG_STATE_HOME/tether или запустите его командой 'systemctl --user start "
+"tetherd.service'.\n"
+
+#: src/cli/main.cpp
+#, c++-format
+msgid "No daemon answered at {}:{}.\n"
+msgstr "На {}:{} не ответил ни один демон.\n"
+
#: src/cli/main.cpp
msgid ""
"Explicit framework connection locally rejected! Did you target explicitly "
diff --git a/po/sv.po b/po/sv.po
index 7a329ed..b80d170 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-10 09:25-0700\n"
+"POT-Creation-Date: 2026-09-10 09:49-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Swedish\n"
@@ -853,8 +853,8 @@ msgid ""
"it on demand.\n"
msgstr ""
"Den här maskinen har inte systemd, så det finns ingen användartjänst att "
-"hantera. Starta tetherd med det som systemet använder för tjänster, eller låt "
-"en klient starta den vid behov.\n"
+"hantera. Starta tetherd med det som systemet använder för tjänster, eller "
+"låt en klient starta den vid behov.\n"
#: src/cli/main.cpp
#, c-format
@@ -931,6 +931,21 @@ msgid_plural "Found %zu devices in %.1fs\n"
msgstr[0] "Hittade %zu enhet på %.1fs\n"
msgstr[1] "Hittade %zu enheter på %.1fs\n"
+#: src/cli/main.cpp
+msgid ""
+"The daemon is not running, and could not be started. Check the log in "
+"$XDG_STATE_HOME/tether, or start it with 'systemctl --user start "
+"tetherd.service'.\n"
+msgstr ""
+"Demonen körs inte och gick inte att starta. Se loggen i "
+"$XDG_STATE_HOME/tether, eller starta den med 'systemctl --user start "
+"tetherd.service'.\n"
+
+#: src/cli/main.cpp
+#, c++-format
+msgid "No daemon answered at {}:{}.\n"
+msgstr "Ingen demon svarade på {}:{}.\n"
+
#: src/cli/main.cpp
msgid ""
"Explicit framework connection locally rejected! Did you target explicitly "
diff --git a/po/tether.pot b/po/tether.pot
index 3d9f6c8..84c6408 100644
--- a/po/tether.pot
+++ b/po/tether.pot
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: tether 0.2.29\n"
"Report-Msgid-Bugs-To: [email protected]\n"
-"POT-Creation-Date: 2026-09-10 09:25-0700\n"
+"POT-Creation-Date: 2026-09-10 09:49-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"
@@ -851,6 +851,18 @@ msgid_plural "Found %zu devices in %.1fs\n"
msgstr[0] ""
msgstr[1] ""
+#: src/cli/main.cpp
+msgid ""
+"The daemon is not running, and could not be started. Check the log in "
+"$XDG_STATE_HOME/tether, or start it with 'systemctl --user start "
+"tetherd.service'.\n"
+msgstr ""
+
+#: src/cli/main.cpp
+#, c++-format
+msgid "No daemon answered at {}:{}.\n"
+msgstr ""
+
#: src/cli/main.cpp
msgid ""
"Explicit framework connection locally rejected! Did you target explicitly "
diff --git a/po/tr.po b/po/tr.po
index ad66e40..ff96256 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-10 09:25-0700\n"
+"POT-Creation-Date: 2026-09-10 09:49-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Turkish\n"
@@ -851,9 +851,9 @@ msgid ""
"tetherd from whatever this system uses for services, or let a client start "
"it on demand.\n"
msgstr ""
-"Bu makinede systemd yok, dolayısıyla yönetilecek bir kullanıcı servisi de yok. "
-"tetherd'i bu sistemin servisler için kullandığı şeyle başlatın ya da bir "
-"istemcinin gerektiğinde başlatmasına izin verin.\n"
+"Bu makinede systemd yok, dolayısıyla yönetilecek bir kullanıcı servisi de "
+"yok. tetherd'i bu sistemin servisler için kullandığı şeyle başlatın ya da "
+"bir istemcinin gerektiğinde başlatmasına izin verin.\n"
#: src/cli/main.cpp
#, c-format
@@ -930,6 +930,21 @@ msgid_plural "Found %zu devices in %.1fs\n"
msgstr[0] "%2$.1fs içinde %1$zu aygıt bulundu\n"
msgstr[1] "%2$.1fs içinde %1$zu aygıt bulundu\n"
+#: src/cli/main.cpp
+msgid ""
+"The daemon is not running, and could not be started. Check the log in "
+"$XDG_STATE_HOME/tether, or start it with 'systemctl --user start "
+"tetherd.service'.\n"
+msgstr ""
+"Arka plan süreci çalışmıyor ve başlatılamadı. $XDG_STATE_HOME/tether "
+"içindeki günlüğe bakın ya da 'systemctl --user start tetherd.service' ile "
+"başlatın.\n"
+
+#: src/cli/main.cpp
+#, c++-format
+msgid "No daemon answered at {}:{}.\n"
+msgstr "{}:{} adresinde yanıt veren bir süreç yok.\n"
+
#: src/cli/main.cpp
msgid ""
"Explicit framework connection locally rejected! Did you target explicitly "
diff --git a/po/uk.po b/po/uk.po
index 9a41a50..8b15f82 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-10 09:25-0700\n"
+"POT-Creation-Date: 2026-09-10 09:49-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Ukrainian\n"
@@ -939,6 +939,21 @@ msgstr[0] "Знайдено %zu пристрій за %.1fs\n"
msgstr[1] "Знайдено %zu пристрої за %.1fs\n"
msgstr[2] "Знайдено %zu пристроїв за %.1fs\n"
+#: src/cli/main.cpp
+msgid ""
+"The daemon is not running, and could not be started. Check the log in "
+"$XDG_STATE_HOME/tether, or start it with 'systemctl --user start "
+"tetherd.service'.\n"
+msgstr ""
+"Демон не запущено, і запустити його не вдалося. Перевірте журнал у "
+"$XDG_STATE_HOME/tether або запустіть його командою 'systemctl --user start "
+"tetherd.service'.\n"
+
+#: src/cli/main.cpp
+#, c++-format
+msgid "No daemon answered at {}:{}.\n"
+msgstr "На {}:{} не відповів жоден демон.\n"
+
#: src/cli/main.cpp
msgid ""
"Explicit framework connection locally rejected! Did you target explicitly "
diff --git a/po/zh_CN.po b/po/zh_CN.po
index 113a010..1559e88 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-10 09:25-0700\n"
+"POT-Creation-Date: 2026-09-10 09:49-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Simplified Chinese\n"
@@ -900,6 +900,20 @@ msgid "Found %zu device in %.1fs\n"
msgid_plural "Found %zu devices in %.1fs\n"
msgstr[0] "在 %2$.1f 秒内找到 %1$zu 台设备\n"
+#: src/cli/main.cpp
+msgid ""
+"The daemon is not running, and could not be started. Check the log in "
+"$XDG_STATE_HOME/tether, or start it with 'systemctl --user start "
+"tetherd.service'.\n"
+msgstr ""
+"守护进程未运行,且无法启动。请查看 $XDG_STATE_HOME/tether 中的日志,或用 "
+"'systemctl --user start tetherd.service' 启动它。\n"
+
+#: src/cli/main.cpp
+#, c++-format
+msgid "No daemon answered at {}:{}.\n"
+msgstr "{}:{} 上没有守护进程响应。\n"
+
#: src/cli/main.cpp
msgid ""
"Explicit framework connection locally rejected! Did you target explicitly "
diff --git a/src/cli/main.cpp b/src/cli/main.cpp
index 0faecb3..b681941 100644
--- a/src/cli/main.cpp
+++ b/src/cli/main.cpp
@@ -1490,6 +1490,17 @@ int main(int argc, char* argv[]) {
// Bind network abstraction natively
if (!client.connect(host, port)) {
+ // status and pending are what someone runs to find out whether the daemon is up
+ if (action == "status" || action == "pending") {
+ if (host.empty())
+ debug::log(ERR,
+ _("The daemon is not running, and could not be started. Check the log in "
+ "$XDG_STATE_HOME/tether, or start it with 'systemctl --user start "
+ "tetherd.service'.\n"));
+ else
+ debug::log(ERR, _("No daemon answered at {}:{}.\n"), host, port);
+ return 1;
+ }
debug::log(
ERR,
_("Explicit framework connection locally rejected! Did you target explicitly invalid TLS or is daemon "