Skip to content

Linux + iPhone Continuity / iMessage / SMS

feat: disable clipboard auto-send

Zack Bartelf10fe09ea423
diff --git a/README.md b/README.md
index f9622a2..5a18223 100644
--- a/README.md
+++ b/README.md
@@ -41,6 +41,8 @@
### Clipboard Sync
Text copied on your Linux desktop appears instantly on your iPhone, and vice versa.
+To share only on demand, turn off **Share the clipboard automatically** in Settings and bind `tether share` to a key, e.g. Hyprland: `bind = SUPER SHIFT, C, exec, tether share`.
+
### File Transfer
Drag and drop files from Linux directly into the iPhone app, or receive files automatically to your `$XDG_DOWNLOAD_DIR` (~/Downloads).
diff --git a/docs/PROTOCOL.md b/docs/PROTOCOL.md
index ad12abc..689c42c 100644
--- a/docs/PROTOCOL.md
+++ b/docs/PROTOCOL.md
@@ -92,7 +92,7 @@ The clipboard capabilities allow seamless copying and pasting between the Host (
}
```
-**Daemon Behavior**: Fired asynchronously whenever the `wlr_data_control_device` `setDataOffer` informs the daemon that the primary clipboard selection has rotated.
+**Daemon Behavior**: Fired asynchronously whenever the `wlr_data_control_device` `setDataOffer` informs the daemon that the primary clipboard selection has rotated. Not sent when `clipboard_auto_share` is off; then only `clipboard_send` shares the Host clipboard.
---
@@ -100,6 +100,10 @@ The clipboard capabilities allow seamless copying and pasting between the Host (
**Description**: Local socket only. Broadcasts the current Host clipboard to clients as `clipboard_updated`, and replies with `clipboard_content`. Nothing is broadcast when the clipboard is empty.
+### `set_clipboard_auto_share` (Local client -> Daemon)
+
+**Description**: Local socket only. `{"enabled": false}` stops pushing local copies to clients. Saved to the config and reported as `clipboard_auto_share` in `bt_status`.
+
---
### Clipboard images (both directions)
diff --git a/po/cs.po b/po/cs.po
index 3d26cd0..c9615f3 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-11-02 18:54-0800\n"
+"POT-Creation-Date: 2026-11-03 18:33-0800\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Czech\n"
@@ -42,6 +42,10 @@ msgstr "Získat aktuální text ze schránky Waylandu."
msgid "Take string input and copy it to the local Wayland clipboard."
msgstr "Načíst text ze vstupu a zkopírovat jej do místní schránky Waylandu."
+#: src/cli/main.cpp
+msgid "Send the current Wayland clipboard to connected devices."
+msgstr "Odeslat aktuální obsah schránky Wayland do připojených zařízení."
+
#: src/cli/main.cpp
msgid "Send a file through tether."
msgstr "Odeslat soubor přes tether."
@@ -2942,6 +2946,14 @@ msgstr ""
"Zamkne asi půl minuty po vypršení spojení. Vypnutí Bluetooth na iPhonu "
"nezamkne, stejně jako uspání tohoto počítače."
+#: src/gtk/settings_view.cpp src/tui/settings.cpp
+msgid "Share the clipboard automatically"
+msgstr "Sdílet schránku automaticky"
+
+#: src/gtk/settings_view.cpp src/tui/settings.cpp
+msgid "Off sends it only from Send Clipboard or tether share."
+msgstr "Vypnuto ji odesílá jen přes Odeslat schránku nebo tether share."
+
#: src/gtk/settings_view.cpp
msgid "SMS and iMessage conversations synced over Bluetooth."
msgstr "SMS a konverzace iMessage synchronizované přes Bluetooth."
diff --git a/po/de.po b/po/de.po
index 553ed39..17a31ef 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-11-02 18:54-0800\n"
+"POT-Creation-Date: 2026-11-03 18:33-0800\n"
"PO-Revision-Date: 2026-08-22\n"
"Last-Translator: Tether project\n"
"Language-Team: German\n"
@@ -43,6 +43,10 @@ msgid "Take string input and copy it to the local Wayland clipboard."
msgstr ""
"Text von der Eingabe lesen und in die lokale Wayland-Zwischenablage kopieren."
+#: src/cli/main.cpp
+msgid "Send the current Wayland clipboard to connected devices."
+msgstr "Die aktuelle Wayland-Zwischenablage an verbundene Geräte senden."
+
#: src/cli/main.cpp
msgid "Send a file through tether."
msgstr "Eine Datei über tether senden."
@@ -3008,6 +3012,14 @@ msgstr ""
"Bluetooth am iPhone auszuschalten sperrt nicht, und diese Maschine in den "
"Ruhezustand zu versetzen ebenso wenig."
+#: src/gtk/settings_view.cpp src/tui/settings.cpp
+msgid "Share the clipboard automatically"
+msgstr "Zwischenablage automatisch teilen"
+
+#: src/gtk/settings_view.cpp src/tui/settings.cpp
+msgid "Off sends it only from Send Clipboard or tether share."
+msgstr "Aus sendet sie nur über „Zwischenablage senden“ oder tether share."
+
#: src/gtk/settings_view.cpp
msgid "SMS and iMessage conversations synced over Bluetooth."
msgstr ""
diff --git a/po/es.po b/po/es.po
index 4425284..0bbd02f 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-11-02 18:54-0800\n"
+"POT-Creation-Date: 2026-11-03 18:33-0800\n"
"PO-Revision-Date: 2026-08-22\n"
"Last-Translator: Tether project\n"
"Language-Team: Spanish\n"
@@ -42,6 +42,10 @@ msgstr "Obtener el texto actual del portapapeles de Wayland."
msgid "Take string input and copy it to the local Wayland clipboard."
msgstr "Leer texto de la entrada y copiarlo al portapapeles local de Wayland."
+#: src/cli/main.cpp
+msgid "Send the current Wayland clipboard to connected devices."
+msgstr "Enviar el portapapeles actual de Wayland a los dispositivos conectados."
+
#: src/cli/main.cpp
msgid "Send a file through tether."
msgstr "Enviar un archivo a través de tether."
@@ -2986,6 +2990,14 @@ msgstr ""
"Bloquea alrededor de medio minuto después de que el enlace expire. Apagar el "
"Bluetooth en el iPhone no bloquea, y suspender esta máquina tampoco."
+#: src/gtk/settings_view.cpp src/tui/settings.cpp
+msgid "Share the clipboard automatically"
+msgstr "Compartir el portapapeles automáticamente"
+
+#: src/gtk/settings_view.cpp src/tui/settings.cpp
+msgid "Off sends it only from Send Clipboard or tether share."
+msgstr "Desactivado, solo se envía con Enviar portapapeles o tether share."
+
#: src/gtk/settings_view.cpp
msgid "SMS and iMessage conversations synced over Bluetooth."
msgstr "Conversaciones de SMS e iMessage sincronizadas por Bluetooth."
diff --git a/po/fr.po b/po/fr.po
index 1157dec..e75ccf6 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-11-02 18:54-0800\n"
+"POT-Creation-Date: 2026-11-03 18:33-0800\n"
"PO-Revision-Date: 2026-08-22\n"
"Last-Translator: Tether project\n"
"Language-Team: French\n"
@@ -43,6 +43,10 @@ msgid "Take string input and copy it to the local Wayland clipboard."
msgstr ""
"Lire du texte sur l'entrée et le copier dans le presse-papiers Wayland local."
+#: src/cli/main.cpp
+msgid "Send the current Wayland clipboard to connected devices."
+msgstr "Envoyer le presse-papiers Wayland actuel aux appareils connectés."
+
#: src/cli/main.cpp
msgid "Send a file through tether."
msgstr "Envoyer un fichier via tether."
@@ -2995,6 +2999,14 @@ msgstr ""
"Bluetooth sur l'iPhone ne verrouille pas, et mettre cette machine en veille "
"non plus."
+#: src/gtk/settings_view.cpp src/tui/settings.cpp
+msgid "Share the clipboard automatically"
+msgstr "Partager le presse-papiers automatiquement"
+
+#: src/gtk/settings_view.cpp src/tui/settings.cpp
+msgid "Off sends it only from Send Clipboard or tether share."
+msgstr "Désactivé, il n’est envoyé que via Envoyer le presse-papiers ou tether share."
+
#: src/gtk/settings_view.cpp
msgid "SMS and iMessage conversations synced over Bluetooth."
msgstr "Conversations SMS et iMessage synchronisées par Bluetooth."
diff --git a/po/it.po b/po/it.po
index 278ef10..92823e2 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-11-02 18:54-0800\n"
+"POT-Creation-Date: 2026-11-03 18:33-0800\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Italian\n"
@@ -43,6 +43,10 @@ msgid "Take string input and copy it to the local Wayland clipboard."
msgstr ""
"Legge il testo dall'ingresso e lo copia negli appunti locali di Wayland."
+#: src/cli/main.cpp
+msgid "Send the current Wayland clipboard to connected devices."
+msgstr "Invia gli appunti Wayland correnti ai dispositivi connessi."
+
#: src/cli/main.cpp
msgid "Send a file through tether."
msgstr "Invia un file tramite tether."
@@ -2981,6 +2985,14 @@ msgstr ""
"Blocca circa mezzo minuto dopo la scadenza del collegamento. Disattivare il "
"Bluetooth sull'iPhone non blocca, e nemmeno sospendere questa macchina."
+#: src/gtk/settings_view.cpp src/tui/settings.cpp
+msgid "Share the clipboard automatically"
+msgstr "Condividi gli appunti automaticamente"
+
+#: src/gtk/settings_view.cpp src/tui/settings.cpp
+msgid "Off sends it only from Send Clipboard or tether share."
+msgstr "Se disattivato, li invia solo con Invia appunti o tether share."
+
#: src/gtk/settings_view.cpp
msgid "SMS and iMessage conversations synced over Bluetooth."
msgstr "Conversazioni SMS e iMessage sincronizzate via Bluetooth."
diff --git a/po/ja.po b/po/ja.po
index eef10a9..ba02578 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-11-02 18:54-0800\n"
+"POT-Creation-Date: 2026-11-03 18:33-0800\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Japanese\n"
@@ -43,6 +43,10 @@ msgid "Take string input and copy it to the local Wayland clipboard."
msgstr ""
"入力からテキストを読み取り、ローカルの Wayland クリップボードにコピーします。"
+#: src/cli/main.cpp
+msgid "Send the current Wayland clipboard to connected devices."
+msgstr "現在の Wayland クリップボードを接続中のデバイスに送信します。"
+
#: src/cli/main.cpp
msgid "Send a file through tether."
msgstr "tether 経由でファイルを送信します。"
@@ -2943,6 +2947,14 @@ msgstr ""
"リンクがタイムアウトしてから約 30 秒後にロックします。iPhone 側で Bluetooth "
"を切ってもロックせず、このマシンをサスペンドしてもロックしません。"
+#: src/gtk/settings_view.cpp src/tui/settings.cpp
+msgid "Share the clipboard automatically"
+msgstr "クリップボードを自動的に共有"
+
+#: src/gtk/settings_view.cpp src/tui/settings.cpp
+msgid "Off sends it only from Send Clipboard or tether share."
+msgstr "オフにすると「クリップボードを送信」または tether share でのみ送信します。"
+
#: src/gtk/settings_view.cpp
msgid "SMS and iMessage conversations synced over Bluetooth."
msgstr "Bluetooth 経由で同期される SMS と iMessage の会話です。"
diff --git a/po/ko.po b/po/ko.po
index f50505f..c4d6d06 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-11-02 18:54-0800\n"
+"POT-Creation-Date: 2026-11-03 18:33-0800\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Korean\n"
@@ -42,6 +42,10 @@ msgstr "Wayland 클립보드의 현재 텍스트를 가져옵니다."
msgid "Take string input and copy it to the local Wayland clipboard."
msgstr "입력에서 텍스트를 읽어 로컬 Wayland 클립보드에 복사합니다."
+#: src/cli/main.cpp
+msgid "Send the current Wayland clipboard to connected devices."
+msgstr "현재 Wayland 클립보드를 연결된 기기로 보냅니다."
+
#: src/cli/main.cpp
msgid "Send a file through tether."
msgstr "tether를 통해 파일을 보냅니다."
@@ -2900,6 +2904,14 @@ msgstr ""
"링크가 시간 초과된 뒤 약 30초 후에 잠급니다. iPhone에서 Bluetooth를 꺼도 잠기"
"지 않으며, 이 기기를 절전 모드로 두어도 잠기지 않습니다."
+#: src/gtk/settings_view.cpp src/tui/settings.cpp
+msgid "Share the clipboard automatically"
+msgstr "클립보드 자동 공유"
+
+#: src/gtk/settings_view.cpp src/tui/settings.cpp
+msgid "Off sends it only from Send Clipboard or tether share."
+msgstr "끄면 클립보드 보내기 또는 tether share로만 보냅니다."
+
#: src/gtk/settings_view.cpp
msgid "SMS and iMessage conversations synced over Bluetooth."
msgstr "Bluetooth로 동기화되는 SMS 및 iMessage 대화입니다."
diff --git a/po/nl.po b/po/nl.po
index daf6d80..57e6da5 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-11-02 18:54-0800\n"
+"POT-Creation-Date: 2026-11-03 18:33-0800\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Dutch\n"
@@ -43,6 +43,10 @@ msgid "Take string input and copy it to the local Wayland clipboard."
msgstr ""
"Tekst van de invoer lezen en naar het lokale Wayland-klembord kopiëren."
+#: src/cli/main.cpp
+msgid "Send the current Wayland clipboard to connected devices."
+msgstr "Het huidige Wayland-klembord naar verbonden apparaten versturen."
+
#: src/cli/main.cpp
msgid "Send a file through tether."
msgstr "Een bestand via tether versturen."
@@ -2973,6 +2977,14 @@ msgstr ""
"Bluetooth uitzetten op de iPhone vergrendelt niet, en deze machine in "
"slaapstand zetten evenmin."
+#: src/gtk/settings_view.cpp src/tui/settings.cpp
+msgid "Share the clipboard automatically"
+msgstr "Klembord automatisch delen"
+
+#: src/gtk/settings_view.cpp src/tui/settings.cpp
+msgid "Off sends it only from Send Clipboard or tether share."
+msgstr "Uit verstuurt het alleen via Klembord versturen of tether share."
+
#: src/gtk/settings_view.cpp
msgid "SMS and iMessage conversations synced over Bluetooth."
msgstr "Sms- en iMessage-gesprekken die via Bluetooth worden gesynchroniseerd."
diff --git a/po/pl.po b/po/pl.po
index 83125f8..30c3d70 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-11-02 18:54-0800\n"
+"POT-Creation-Date: 2026-11-03 18:33-0800\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Polish\n"
@@ -43,6 +43,10 @@ msgstr "Pobierz bieżący tekst ze schowka Waylanda."
msgid "Take string input and copy it to the local Wayland clipboard."
msgstr "Wczytaj tekst z wejścia i skopiuj go do lokalnego schowka Waylanda."
+#: src/cli/main.cpp
+msgid "Send the current Wayland clipboard to connected devices."
+msgstr "Wyślij bieżący schowek Wayland do połączonych urządzeń."
+
#: src/cli/main.cpp
msgid "Send a file through tether."
msgstr "Wyślij plik przez tether."
@@ -2969,6 +2973,14 @@ msgstr ""
"Blokuje około pół minuty po wygaśnięciu połączenia. Wyłączenie Bluetootha w "
"iPhonie nie blokuje, podobnie jak uśpienie tego komputera."
+#: src/gtk/settings_view.cpp src/tui/settings.cpp
+msgid "Share the clipboard automatically"
+msgstr "Udostępniaj schowek automatycznie"
+
+#: src/gtk/settings_view.cpp src/tui/settings.cpp
+msgid "Off sends it only from Send Clipboard or tether share."
+msgstr "Wyłączone wysyła go tylko przez Wyślij schowek lub tether share."
+
#: src/gtk/settings_view.cpp
msgid "SMS and iMessage conversations synced over Bluetooth."
msgstr "Rozmowy SMS i iMessage synchronizowane przez Bluetooth."
diff --git a/po/pt_BR.po b/po/pt_BR.po
index a301783..2f05e9e 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-11-02 18:54-0800\n"
+"POT-Creation-Date: 2026-11-03 18:33-0800\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Brazilian Portuguese\n"
@@ -44,6 +44,10 @@ msgstr ""
"Ler texto da entrada e copiá-lo para a área de transferência local do "
"Wayland."
+#: src/cli/main.cpp
+msgid "Send the current Wayland clipboard to connected devices."
+msgstr "Enviar a área de transferência atual do Wayland aos dispositivos conectados."
+
#: src/cli/main.cpp
msgid "Send a file through tether."
msgstr "Enviar um arquivo pelo tether."
@@ -2971,6 +2975,14 @@ msgstr ""
"Bloqueia cerca de meio minuto após o enlace expirar. Desligar o Bluetooth no "
"iPhone não bloqueia, e suspender esta máquina também não."
+#: src/gtk/settings_view.cpp src/tui/settings.cpp
+msgid "Share the clipboard automatically"
+msgstr "Compartilhar a área de transferência automaticamente"
+
+#: src/gtk/settings_view.cpp src/tui/settings.cpp
+msgid "Off sends it only from Send Clipboard or tether share."
+msgstr "Desligado, só envia por Enviar área de transferência ou tether share."
+
#: src/gtk/settings_view.cpp
msgid "SMS and iMessage conversations synced over Bluetooth."
msgstr "Conversas de SMS e iMessage sincronizadas por Bluetooth."
diff --git a/po/ru.po b/po/ru.po
index f5b5ba9..6a218d8 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-11-02 18:54-0800\n"
+"POT-Creation-Date: 2026-11-03 18:33-0800\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Russian\n"
@@ -44,6 +44,10 @@ msgid "Take string input and copy it to the local Wayland clipboard."
msgstr ""
"Прочитать текст со входа и скопировать его в локальный буфер обмена Wayland."
+#: src/cli/main.cpp
+msgid "Send the current Wayland clipboard to connected devices."
+msgstr "Отправить текущий буфер обмена Wayland на подключённые устройства."
+
#: src/cli/main.cpp
msgid "Send a file through tether."
msgstr "Отправить файл через tether."
@@ -2971,6 +2975,14 @@ msgstr ""
"Выключение Bluetooth на iPhone не блокирует, как и переход этой машины в "
"спящий режим."
+#: src/gtk/settings_view.cpp src/tui/settings.cpp
+msgid "Share the clipboard automatically"
+msgstr "Автоматически делиться буфером обмена"
+
+#: src/gtk/settings_view.cpp src/tui/settings.cpp
+msgid "Off sends it only from Send Clipboard or tether share."
+msgstr "Если выключено, буфер отправляется только кнопкой «Отправить буфер обмена» или командой tether share."
+
#: src/gtk/settings_view.cpp
msgid "SMS and iMessage conversations synced over Bluetooth."
msgstr "Переписка SMS и iMessage, синхронизируемая по Bluetooth."
diff --git a/po/sv.po b/po/sv.po
index 515f3a2..1dad360 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-11-02 18:54-0800\n"
+"POT-Creation-Date: 2026-11-03 18:33-0800\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Swedish\n"
@@ -43,6 +43,10 @@ msgid "Take string input and copy it to the local Wayland clipboard."
msgstr ""
"Läs text från indata och kopiera den till det lokala Wayland-urklippet."
+#: src/cli/main.cpp
+msgid "Send the current Wayland clipboard to connected devices."
+msgstr "Skicka aktuellt Wayland-urklipp till anslutna enheter."
+
#: src/cli/main.cpp
msgid "Send a file through tether."
msgstr "Skicka en fil via tether."
@@ -2944,6 +2948,14 @@ msgstr ""
"Bluetooth på iPhonen låser inte, och inte heller att försätta den här "
"maskinen i vila."
+#: src/gtk/settings_view.cpp src/tui/settings.cpp
+msgid "Share the clipboard automatically"
+msgstr "Dela urklipp automatiskt"
+
+#: src/gtk/settings_view.cpp src/tui/settings.cpp
+msgid "Off sends it only from Send Clipboard or tether share."
+msgstr "Av skickar det bara via Skicka urklipp eller tether share."
+
#: src/gtk/settings_view.cpp
msgid "SMS and iMessage conversations synced over Bluetooth."
msgstr "SMS- och iMessage-konversationer som synkas via Bluetooth."
diff --git a/po/tether.pot b/po/tether.pot
index 99157d4..7c61519 100644
--- a/po/tether.pot
+++ b/po/tether.pot
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: tether 0.3.2\n"
"Report-Msgid-Bugs-To: [email protected]\n"
-"POT-Creation-Date: 2026-11-02 18:54-0800\n"
+"POT-Creation-Date: 2026-11-03 18:33-0800\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <[email protected]>\n"
@@ -42,6 +42,10 @@ msgstr ""
msgid "Take string input and copy it to the local Wayland clipboard."
msgstr ""
+#: src/cli/main.cpp
+msgid "Send the current Wayland clipboard to connected devices."
+msgstr ""
+
#: src/cli/main.cpp
msgid "Send a file through tether."
msgstr ""
@@ -2674,6 +2678,14 @@ msgid ""
"on the iPhone does not lock, and neither does suspending this machine."
msgstr ""
+#: src/gtk/settings_view.cpp src/tui/settings.cpp
+msgid "Share the clipboard automatically"
+msgstr ""
+
+#: src/gtk/settings_view.cpp src/tui/settings.cpp
+msgid "Off sends it only from Send Clipboard or tether share."
+msgstr ""
+
#: src/gtk/settings_view.cpp
msgid "SMS and iMessage conversations synced over Bluetooth."
msgstr ""
diff --git a/po/tr.po b/po/tr.po
index 9623ac5..2cb3bc4 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-11-02 18:54-0800\n"
+"POT-Creation-Date: 2026-11-03 18:33-0800\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Turkish\n"
@@ -42,6 +42,10 @@ msgstr "Wayland panosundaki güncel metni al."
msgid "Take string input and copy it to the local Wayland clipboard."
msgstr "Girişten metin oku ve yerel Wayland panosuna kopyala."
+#: src/cli/main.cpp
+msgid "Send the current Wayland clipboard to connected devices."
+msgstr "Geçerli Wayland panosunu bağlı cihazlara gönder."
+
#: src/cli/main.cpp
msgid "Send a file through tether."
msgstr "tether üzerinden bir dosya gönder."
@@ -2938,6 +2942,14 @@ msgstr ""
"iPhone'da Bluetooth'u kapatmak kilitlemez, bu makineyi uyku moduna almak da "
"kilitlemez."
+#: src/gtk/settings_view.cpp src/tui/settings.cpp
+msgid "Share the clipboard automatically"
+msgstr "Panoyu otomatik paylaş"
+
+#: src/gtk/settings_view.cpp src/tui/settings.cpp
+msgid "Off sends it only from Send Clipboard or tether share."
+msgstr "Kapalıyken yalnızca Panoyu gönder veya tether share ile gönderilir."
+
#: src/gtk/settings_view.cpp
msgid "SMS and iMessage conversations synced over Bluetooth."
msgstr "Bluetooth üzerinden eşitlenen SMS ve iMessage konuşmaları."
diff --git a/po/uk.po b/po/uk.po
index a15a58f..14e54ed 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-11-02 18:54-0800\n"
+"POT-Creation-Date: 2026-11-03 18:33-0800\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Ukrainian\n"
@@ -45,6 +45,10 @@ msgstr ""
"Прочитати текст із входу та скопіювати його до локального буфера обміну "
"Wayland."
+#: src/cli/main.cpp
+msgid "Send the current Wayland clipboard to connected devices."
+msgstr "Надіслати поточний буфер обміну Wayland на під’єднані пристрої."
+
#: src/cli/main.cpp
msgid "Send a file through tether."
msgstr "Надіслати файл через tether."
@@ -2968,6 +2972,14 @@ msgstr ""
"Блокує приблизно за півхвилини після того, як з'єднання завершиться за "
"часом. Вимкнення Bluetooth на iPhone не блокує, як і присипляння цієї машини."
+#: src/gtk/settings_view.cpp src/tui/settings.cpp
+msgid "Share the clipboard automatically"
+msgstr "Автоматично ділитися буфером обміну"
+
+#: src/gtk/settings_view.cpp src/tui/settings.cpp
+msgid "Off sends it only from Send Clipboard or tether share."
+msgstr "Якщо вимкнено, буфер надсилається лише кнопкою «Надіслати буфер обміну» або командою tether share."
+
#: src/gtk/settings_view.cpp
msgid "SMS and iMessage conversations synced over Bluetooth."
msgstr "Розмови SMS та iMessage, синхронізовані через Bluetooth."
diff --git a/po/zh_CN.po b/po/zh_CN.po
index e9cb8ae..5ed95ea 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-11-02 18:54-0800\n"
+"POT-Creation-Date: 2026-11-03 18:33-0800\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Simplified Chinese\n"
@@ -42,6 +42,10 @@ msgstr "获取 Wayland 剪贴板中的当前文本。"
msgid "Take string input and copy it to the local Wayland clipboard."
msgstr "从输入读取文本并复制到本地 Wayland 剪贴板。"
+#: src/cli/main.cpp
+msgid "Send the current Wayland clipboard to connected devices."
+msgstr "将当前 Wayland 剪贴板发送到已连接的设备。"
+
#: src/cli/main.cpp
msgid "Send a file through tether."
msgstr "通过 tether 发送文件。"
@@ -2831,6 +2835,14 @@ msgid ""
msgstr ""
"在链路超时约半分钟后锁定。在 iPhone 上关闭蓝牙不会锁定,将本机挂起也不会。"
+#: src/gtk/settings_view.cpp src/tui/settings.cpp
+msgid "Share the clipboard automatically"
+msgstr "自动共享剪贴板"
+
+#: src/gtk/settings_view.cpp src/tui/settings.cpp
+msgid "Off sends it only from Send Clipboard or tether share."
+msgstr "关闭后仅通过“发送剪贴板”或 tether share 发送。"
+
#: src/gtk/settings_view.cpp
msgid "SMS and iMessage conversations synced over Bluetooth."
msgstr "通过蓝牙同步的短信和 iMessage 会话。"
diff --git a/src/cli/main.cpp b/src/cli/main.cpp
index aceb8f9..f034f78 100644
--- a/src/cli/main.cpp
+++ b/src/cli/main.cpp
@@ -184,6 +184,7 @@ static const Opt kOptions[] = {
{"-v, --version", N_("Print the tether version.")},
{"-g, --get-clipboard", N_("Retrieve the current Wayland clipboard text.")},
{"-s, --set-clipboard", N_("Take string input and copy it to the local Wayland clipboard.")},
+ {"--share-clipboard", N_("Send the current Wayland clipboard to connected devices.")},
{"-f, --send-file", N_("Send a file through tether.")},
{"--to <name>", N_("With --send-file, send to one connected device (name or fingerprint).")},
{"-n, --native-host", N_("Start the browser Native Messaging Host proxy loop.")},
@@ -1380,6 +1381,8 @@ int main(int argc, char* argv[]) {
return 0;
} else if (arg == "-g" || arg == "--get-clipboard") {
action = "get";
+ } else if (arg == "--share-clipboard") {
+ action = "share";
} else if (arg == "-d" || arg == "--discover") {
action = "discover";
} else if (arg == "--list-devices") {
@@ -1675,6 +1678,9 @@ int main(int argc, char* argv[]) {
return 1;
}
debug::log(INFO, "{}", clip);
+ } else if (action == "share") {
+ // clipboard_send is local-socket only
+ client.send_and_wait("{\"command\":\"clipboard_send\"}\n");
} else if (action == "set") {
if (!client.set_clipboard(arg_val, err)) {
debug::log(ERR, "{}", err);
diff --git a/src/cli/verbs.cpp b/src/cli/verbs.cpp
index 84f3f8a..ca96c66 100644
--- a/src/cli/verbs.cpp
+++ b/src/cli/verbs.cpp
@@ -13,6 +13,7 @@ namespace tether::cli {
{"send", "--send-file", "tether send <path>"},
{"copy", "--set-clipboard", "tether copy [text]"},
{"paste", "--get-clipboard", "tether paste"},
+ {"share", "--share-clipboard", "tether share"},
{"service", "--install-service", "tether service"},
{"version", "--version", "tether version"},
{"help", "--help", "tether help"},
diff --git a/src/core/include/tether/bluetooth/config.hpp b/src/core/include/tether/bluetooth/config.hpp
index 90b376e..73d30e3 100644
--- a/src/core/include/tether/bluetooth/config.hpp
+++ b/src/core/include/tether/bluetooth/config.hpp
@@ -61,6 +61,8 @@ namespace tether::bluetooth {
bool desktop_popups_enabled = true;
// Whether popups include the message text. Off shows only the sender.
bool popup_previews_enabled = true;
+ // Whether a local copy is pushed to paired devices. Off shares only on clipboard_send.
+ bool clipboard_auto_share = true;
// Whether threads from senders who are not contacts are hidden. Codes still pop up and autofill.
bool hide_unknown_senders = false;
// Whether Tether manages AirPods at all. Off until asked.
diff --git a/src/core/include/tether/net.hpp b/src/core/include/tether/net.hpp
index 57058d9..79ea26e 100644
--- a/src/core/include/tether/net.hpp
+++ b/src/core/include/tether/net.hpp
@@ -108,6 +108,10 @@ namespace tether {
void set_popup_previews_enabled(bool enabled);
bool popup_previews_enabled();
+ // Whether a local copy is pushed to paired devices. Off shares only on clipboard_send.
+ void set_clipboard_auto_share(bool enabled);
+ bool clipboard_auto_share();
+
void set_mdns_available(bool available);
bool mdns_available();
nlohmann::json build_mdns_status();
diff --git a/src/core/src/bluetooth/config.cpp b/src/core/src/bluetooth/config.cpp
index 5e327b6..1db4feb 100644
--- a/src/core/src/bluetooth/config.cpp
+++ b/src/core/src/bluetooth/config.cpp
@@ -85,6 +85,7 @@ namespace tether::bluetooth {
j["retention"] = to_string(config.retention);
j["desktop_popups_enabled"] = config.desktop_popups_enabled;
j["popup_previews_enabled"] = config.popup_previews_enabled;
+ j["clipboard_auto_share"] = config.clipboard_auto_share;
j["hide_unknown_senders"] = config.hide_unknown_senders;
j["airpods_enabled"] = config.airpods_enabled;
j["airpods_pause"] = to_string(config.airpods_pause);
@@ -117,6 +118,7 @@ namespace tether::bluetooth {
config.retention = retention_from_string(j.value("retention", "encrypted"));
config.desktop_popups_enabled = j.value("desktop_popups_enabled", true);
config.popup_previews_enabled = j.value("popup_previews_enabled", true);
+ config.clipboard_auto_share = j.value("clipboard_auto_share", true);
config.hide_unknown_senders = j.value("hide_unknown_senders", false);
config.airpods_enabled = j.value("airpods_enabled", false);
config.airpods_pause = pause_mode_from_string(j.value("airpods_pause", ""));
diff --git a/src/core/src/net.cpp b/src/core/src/net.cpp
index 67bdfd0..827210f 100644
--- a/src/core/src/net.cpp
+++ b/src/core/src/net.cpp
@@ -430,6 +430,7 @@ namespace tether {
status["retention_ready"] = secret::have_key();
status["desktop_popups_enabled"] = config.desktop_popups_enabled;
status["popup_previews_enabled"] = config.popup_previews_enabled;
+ status["clipboard_auto_share"] = config.clipboard_auto_share;
status["hide_unknown_senders"] = config.hide_unknown_senders;
status["airpods_enabled"] = config.airpods_enabled;
status["airpods_pause"] = to_string(config.airpods_pause);
@@ -476,6 +477,12 @@ namespace tether {
void set_popup_previews_enabled(bool enabled) { g_popup_previews_enabled.store(enabled); }
+ static std::atomic<bool> g_clipboard_auto_share{true};
+
+ bool clipboard_auto_share() { return g_clipboard_auto_share.load(); }
+
+ void set_clipboard_auto_share(bool enabled) { g_clipboard_auto_share.store(enabled); }
+
static std::atomic<bool> g_mdns_available{false};
bool mdns_available() { return g_mdns_available.load(); }
@@ -1564,6 +1571,12 @@ namespace tether {
bluetooth::save_config(config);
set_popup_previews_enabled(config.popup_previews_enabled);
broadcast_local_event(build_bt_status().dump());
+ } else if (j.contains("command") && j["command"] == "set_clipboard_auto_share") {
+ auto config = bluetooth::load_config();
+ config.clipboard_auto_share = j.value("enabled", true);
+ bluetooth::save_config(config);
+ set_clipboard_auto_share(config.clipboard_auto_share);
+ broadcast_local_event(build_bt_status().dump());
} else if (j.contains("command") && j["command"] == "set_hide_unknown_senders") {
auto config = bluetooth::load_config();
config.hide_unknown_senders = j.value("enabled", false);
diff --git a/src/daemon/main.cpp b/src/daemon/main.cpp
index 011d8b6..94b159b 100644
--- a/src/daemon/main.cpp
+++ b/src/daemon/main.cpp
@@ -185,6 +185,8 @@ int main(int argc, char** argv) {
tether::WaylandContext wayland_srv(loop);
tether::g_wayland = &wayland_srv;
wayland_srv.set_clipboard_callback([](const std::string& text) {
+ if (!tether::clipboard_auto_share())
+ return;
nlohmann::json j;
j["command"] = "clipboard_updated";
j["content"] = text;
@@ -192,7 +194,10 @@ int main(int argc, char** argv) {
// app can still mislabel binary as text/plain. Don't abort the daemon.
tether::broadcast_message(j.dump(-1, ' ', false, nlohmann::json::error_handler_t::replace));
});
- wayland_srv.set_clipboard_image_callback([](const std::string& png) { tether::broadcast_clipboard_image(png); });
+ wayland_srv.set_clipboard_image_callback([](const std::string& png) {
+ if (tether::clipboard_auto_share())
+ tether::broadcast_clipboard_image(png);
+ });
wayland_srv.init();
tether::FileReceiveManager file_mgr;
@@ -323,6 +328,7 @@ int main(int argc, char** argv) {
tether::secret::set_retention(bt_config.retention);
tether::set_desktop_popups_enabled(bt_config.desktop_popups_enabled);
tether::set_popup_previews_enabled(bt_config.popup_previews_enabled);
+ tether::set_clipboard_auto_share(bt_config.clipboard_auto_share);
// Pick the controller before the first capability, a second adapter never comes up bound to the wrong one.
bluez.set_preferred_adapter(bt_config.adapter);
diff --git a/src/gtk/settings_view.cpp b/src/gtk/settings_view.cpp
index 0c119bf..47fb890 100644
--- a/src/gtk/settings_view.cpp
+++ b/src/gtk/settings_view.cpp
@@ -42,6 +42,7 @@ namespace tether::ui {
GtkWidget* sw_phone_audio = nullptr;
GtkWidget* sw_lock_away = nullptr;
+ GtkWidget* sw_clipboard_share = nullptr;
nlohmann::json bt_status = nlohmann::json::object();
};
@@ -143,6 +144,10 @@ namespace tether::ui {
daemon_send({{"command", "set_popup_previews"}, {"enabled", gtk_switch_get_active(widget) == TRUE}});
}
+ void on_clipboard_share_toggled(GtkSwitch* widget, GParamSpec*, gpointer) {
+ daemon_send({{"command", "set_clipboard_auto_share"}, {"enabled", gtk_switch_get_active(widget) == TRUE}});
+ }
+
void on_hide_unknown_toggled(GtkSwitch* widget, GParamSpec*, gpointer) {
daemon_send({{"command", "set_hide_unknown_senders"}, {"enabled", gtk_switch_get_active(widget) == TRUE}});
}
@@ -224,6 +229,9 @@ namespace tether::ui {
set_switch(g_settings.sw_lock_away,
reinterpret_cast<gpointer>(on_lock_away_toggled),
status.value("lock_on_away", false));
+ set_switch(g_settings.sw_clipboard_share,
+ reinterpret_cast<gpointer>(on_clipboard_share_toggled),
+ status.value("clipboard_auto_share", true));
set_switch(g_settings.sw_hide_unknown,
reinterpret_cast<gpointer>(on_hide_unknown_toggled),
@@ -356,6 +364,14 @@ namespace tether::ui {
"iPhone does not lock, and neither does suspending this machine."),
g_settings.sw_lock_away);
+ g_settings.sw_clipboard_share = new_switch();
+ g_signal_connect(
+ g_settings.sw_clipboard_share, "notify::active", G_CALLBACK(on_clipboard_share_toggled), nullptr);
+ add_row(security,
+ _("Share the clipboard automatically"),
+ _("Off sends it only from Send Clipboard or tether share."),
+ g_settings.sw_clipboard_share);
+
// Messages
GtkWidget* messages =
add_group(column, _("Messages"), _("SMS and iMessage conversations synced over Bluetooth."));
diff --git a/src/tui/settings.cpp b/src/tui/settings.cpp
index 8fba35e..1465a1d 100644
--- a/src/tui/settings.cpp
+++ b/src/tui/settings.cpp
@@ -54,6 +54,13 @@ namespace tether::tui {
"bt_set_lock_on_away",
"lock_on_away",
false},
+ {"clipboard",
+ N_("Security"),
+ N_("Share the clipboard automatically"),
+ N_("Off sends it only from Send Clipboard or tether share."),
+ "set_clipboard_auto_share",
+ "clipboard_auto_share",
+ true},
{"retention",
N_("Messages"),
N_("Keep message history"),
diff --git a/test/test_bluetooth_pairing.cpp b/test/test_bluetooth_pairing.cpp
index eb26741..8e72811 100644
--- a/test/test_bluetooth_pairing.cpp
+++ b/test/test_bluetooth_pairing.cpp
@@ -89,6 +89,7 @@ TEST(BluetoothConfig, RoundTrips) {
config.calls_enabled = true;
config.desktop_popups_enabled = false;
config.popup_previews_enabled = false;
+ config.clipboard_auto_share = false;
config.lock_on_away = true;
config.lock_away_seconds = 45;
config.lock_command = "hyprlock";
@@ -111,6 +112,7 @@ TEST(BluetoothConfig, DefaultsToConnectFirstAndAncsEnabled) {
// A config written before the switch existed keeps showing popups.
EXPECT_TRUE(config.desktop_popups_enabled);
EXPECT_TRUE(config.popup_previews_enabled);
+ EXPECT_TRUE(config.clipboard_auto_share);
// AirPods are not managed until asked: the channel takes one client per machine.
EXPECT_FALSE(config.airpods_enabled);
// Locking the screen is never assumed; logind performs it once switched on.
diff --git a/test/test_verbs.cpp b/test/test_verbs.cpp
index 0b26941..0ea07cd 100644
--- a/test/test_verbs.cpp
+++ b/test/test_verbs.cpp
@@ -15,6 +15,7 @@ TEST(Verbs, RewritesASubcommandIntoItsFlag) {
EXPECT_EQ(expand({"tether", "devices"}), (std::vector<std::string>{"tether", "--list-devices"}));
EXPECT_EQ(expand({"tether", "paste"}), (std::vector<std::string>{"tether", "--get-clipboard"}));
EXPECT_EQ(expand({"tether", "discover"}), (std::vector<std::string>{"tether", "--discover"}));
+ EXPECT_EQ(expand({"tether", "share"}), (std::vector<std::string>{"tether", "--share-clipboard"}));
}
TEST(Verbs, KeepsTheArgumentsThatFollow) {