Skip to content

Linux + iPhone Continuity / iMessage / SMS

fix(a11y): notification and extension accessibility

Zack Bartelb4fc8bdbc292
diff --git a/README.md b/README.md
index 48ac059..a3e274a 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-![tether](docs/img/tether_header.png)
+![Tether: an iPhone linked to the tetherd Linux daemon over Wi-Fi and Bluetooth LE, providing file transfer, clipboard sync, messages, contacts, and notifications](docs/img/tether_header.png)
# Tether
@@ -19,7 +19,7 @@
[![Debian](https://github.com/zackb/tether/actions/workflows/debian.yml/badge.svg?branch=main)](https://github.com/zackb/tether/actions/workflows/debian.yml)
[![Ubuntu](https://github.com/zackb/tether/actions/workflows/ubuntu.yml/badge.svg?branch=main)](https://github.com/zackb/tether/actions/workflows/ubuntu.yml)
-![tether](docs/img/messages.webp)
+![The Tether desktop app's Messages view: a conversation list on the left and an open conversation with sent and received messages on the right](docs/img/messages.webp)
## Features
@@ -379,6 +379,26 @@ Messages and notifications need one-time system setup. See [docs/BLUETOOTH.md](d
tether bt setup
```
+## Accessibility
+
+Tether should work for everyone. The desktop app is built to work with the Orca screen reader, keyboard-only use, and the system's text scaling. The iOS app is built to work with VoiceOver and Reduce Motion.
+
+Keyboard shortcuts in the desktop app:
+
+| Shortcut | Action |
+|----------|--------|
+| Ctrl+1 … Ctrl+5 | Devices, Messages, Notifications, Contacts, Calls |
+| Ctrl+N | New message |
+| Ctrl+F | Search conversations |
+| Ctrl+, | Settings |
+| Escape | Close Settings, leave search |
+| Ctrl+W | Close window |
+| Ctrl+Q | Quit |
+
+If something can't be reached with the keyboard, is read wrongly by a screen reader, or is hard to see, please [open an issue](https://github.com/zackb/tether/issues). Those reports are bugs.
+
+The manual checks run before a release are in [docs/ACCESSIBILITY.md](docs/ACCESSIBILITY.md).
+
## Security
Report security findings privately through
diff --git a/docs/ACCESSIBILITY.md b/docs/ACCESSIBILITY.md
new file mode 100644
index 0000000..5e6c914
--- /dev/null
+++ b/docs/ACCESSIBILITY.md
@@ -0,0 +1,81 @@
+# Accessibility checks
+
+Automated tests can't hear a screen reader, so run these by hand before a release
+and after any UI change. Each check lists what should happen. Anything else is a
+bug.
+
+## Desktop app
+
+Start it from a build with `./build/tether-gtk`.
+
+### Keyboard only
+
+Put the mouse away.
+
+- [ ] Tab and Shift+Tab reach every button, switch, entry and list on every page.
+ Focus is always visible.
+- [ ] Ctrl+1 to Ctrl+5, Ctrl+N, Ctrl+F, Ctrl+, and Ctrl+Q do what the README table
+ says. The main menu shows the shortcuts next to Settings and Quit.
+- [ ] In the message box, Tab moves to Send. It does not type a tab.
+- [ ] Escape and Ctrl+W close Settings.
+- [ ] Arrow keys move through the device list and skip the WI-FI and BLUETOOTH
+ headings.
+- [ ] When Wi-Fi is down, the reason and the command that fixes it can be read and
+ selected on the Devices welcome page.
+
+### Pairing dialog
+
+```sh
+./build/tether-dialog --title "Pair?" --body "Test" --accept Accept --reject Reject; echo $?
+```
+
+- [ ] Reject has focus when the dialog opens. Enter prints `1`.
+- [ ] Tab to Accept, then Enter prints `0`.
+- [ ] Escape prints `1`.
+
+### Orca
+
+Start Orca with `orca`, or Super+Alt+S on GNOME.
+
+- [ ] The header buttons are read as "Main menu" and "Look for devices".
+- [ ] Each Settings switch and dropdown is read with its row title.
+- [ ] The search boxes, the message box, "To:" and "Number to call" are read by name.
+- [ ] Message bubbles start with "Sent:" or "Received:". Unread badges say
+ "N unread messages".
+- [ ] AirPods battery is read as "Left earbud 82%", not "L 82%". Call signal is read
+ as "signal 3 of 5", not as block characters.
+- [ ] Copy, Message and Dismiss buttons name the address or app they act on.
+- [ ] The pairing dialog is announced with its title and body.
+
+[Accerciser](https://gitlab.gnome.org/GNOME/accerciser) lists the accessibility tree.
+No push button, toggle button or entry should have an empty name.
+
+### Vision
+
+- [ ] `GTK_THEME=HighContrast ./build/tether-gtk`: all text and focus outlines are
+ readable.
+- [ ] `gsettings set org.gnome.desktop.interface text-scaling-factor 1.5`: nothing is
+ clipped or overlapping. Undo with `gsettings reset org.gnome.desktop.interface
+ text-scaling-factor`.
+- [ ] Secondary grey text is readable in both light and dark styles.
+
+## iOS app
+
+- [ ] Run `testIconButtonsHaveAccessibilityLabels` in `TetherUITests`.
+- [ ] Xcode, then Open Developer Tool, then Accessibility Inspector: run Audit on
+ each tab and on the share sheet.
+- [ ] VoiceOver: every toolbar button has a name, chevrons and decorative icons are
+ skipped, and each transfer and paired device reads as one item.
+- [ ] Share a link from Safari with VoiceOver on. The result is spoken before the
+ sheet closes.
+- [ ] Settings, Accessibility, Motion, Reduce Motion: the status dot, the pairing ring
+ and the share result icon do not animate.
+- [ ] Settings, Accessibility, Display & Text Size, Larger Text at the largest size:
+ text wraps and nothing is cut off.
+
+## Browser extension
+
+- [ ] On a page with a one-time code field, an autofilled code leaves focus in that
+ field, and a screen reader reads the code.
+- [ ] If you are typing in a different field when the code arrives, focus stays in
+ that field.
diff --git a/extension/src/content/autofill.js b/extension/src/content/autofill.js
index b76b86c..4845994 100644
--- a/extension/src/content/autofill.js
+++ b/extension/src/content/autofill.js
@@ -107,6 +107,14 @@ function fireInputEvents(el) {
el.dispatchEvent(new Ev('change', { bubbles: true }));
}
+// Put focus on the filled field so screen readers announce the code and Enter
+// submits it. Focus is never pulled away from a field the user is typing in.
+function focusFilled(doc, target, fields) {
+ const active = doc.activeElement;
+ if (active && active !== doc.body && !fields.includes(active)) return;
+ target.focus?.();
+}
+
// A field is only eligible for filling if it is actually rendered. This stops a
// malicious page from planting a hidden "OTP" input to siphon a real code.
export function isFieldVisible(el) {
@@ -159,6 +167,7 @@ export function handleFillOtp(doc, msg, io = {}) {
// dispatch events so react/vue/angular crap pick up the change
fireInputEvents(splitFields[i]);
}
+ focusFilled(doc, splitFields[Math.min(otp.length, splitFields.length) - 1], splitFields);
if (id) filledOtpIds.add(id);
io.onFilled?.(id);
return { filled: true };
@@ -169,6 +178,7 @@ export function handleFillOtp(doc, msg, io = {}) {
if (regularFields.length > 0 && regularFields[0].value !== otp) {
setNativeValue(regularFields[0], otp);
fireInputEvents(regularFields[0]);
+ focusFilled(doc, regularFields[0], regularFields);
if (id) filledOtpIds.add(id);
io.onFilled?.(id);
return { filled: true };
diff --git a/extension/test/otp-consume.test.js b/extension/test/otp-consume.test.js
index 2cde438..aeac0d7 100644
--- a/extension/test/otp-consume.test.js
+++ b/extension/test/otp-consume.test.js
@@ -199,6 +199,22 @@ describe('handleFillOtp', () => {
expect(inputs.slice(0, 6).map((i) => i.value).join('')).toBe('123456');
});
+ it('focuses the filled field so screen readers announce it', () => {
+ const doc = loadFixture('std-autocomplete.html');
+ handleFillOtp(doc, { otp: '123456', otp_id: 1 });
+ expect(doc.activeElement).toBe(doc.querySelector('input'));
+ });
+
+ it('does not pull focus from a field the user is typing in', () => {
+ const doc = new JSDOM(
+ '<input name="note"><input autocomplete="one-time-code">'
+ ).window.document;
+ const note = doc.querySelector('input[name="note"]');
+ note.focus();
+ expect(handleFillOtp(doc, { otp: '123456', otp_id: 1 }).filled).toBe(true);
+ expect(doc.activeElement).toBe(note);
+ });
+
it('refuses to fill the same otp_id twice', () => {
const doc = loadFixture('std-autocomplete.html');
expect(handleFillOtp(doc, { otp: '123456', otp_id: 5 }).filled).toBe(true);
diff --git a/po/cs.po b/po/cs.po
index 6c2ce1e..69f8640 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-14 21:48-0700\n"
+"POT-Creation-Date: 2026-09-14 21:59-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Czech\n"
@@ -2763,6 +2763,10 @@ msgstr "Synchronizace zařízení"
msgid "Pair devices and synchronize clipboard across the network"
msgstr "Spárujte zařízení a synchronizujte schránku po síti"
+#: src/gtk/tether-gtk.desktop.in
+msgid "iPhone;iOS;SMS;Messages;Clipboard;Files;Notifications;Calls;AirPods;"
+msgstr "iPhone;iOS;SMS;Zprávy;Schránka;Soubory;Oznámení;Hovory;AirPods;"
+
#~ msgid ""
#~ "Where messages and contacts are stored on this computer. Encrypted keeps "
#~ "them with a key in your desktop keyring. Do not keep deletes what is "
diff --git a/po/de.po b/po/de.po
index 8382e78..227b220 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-14 21:48-0700\n"
+"POT-Creation-Date: 2026-09-14 21:59-0700\n"
"PO-Revision-Date: 2026-08-22\n"
"Last-Translator: Tether project\n"
"Language-Team: German\n"
@@ -2824,6 +2824,10 @@ msgid "Pair devices and synchronize clipboard across the network"
msgstr ""
"Geräte koppeln und die Zwischenablage über das Netzwerk synchronisieren"
+#: src/gtk/tether-gtk.desktop.in
+msgid "iPhone;iOS;SMS;Messages;Clipboard;Files;Notifications;Calls;AirPods;"
+msgstr "iPhone;iOS;SMS;Nachrichten;Zwischenablage;Dateien;Mitteilungen;Anrufe;AirPods;"
+
#~ msgid ""
#~ "Where messages and contacts are stored on this computer. Encrypted keeps "
#~ "them with a key in your desktop keyring. Do not keep deletes what is "
diff --git a/po/es.po b/po/es.po
index f5ab6c8..b8b95b8 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-14 21:48-0700\n"
+"POT-Creation-Date: 2026-09-14 21:59-0700\n"
"PO-Revision-Date: 2026-08-22\n"
"Last-Translator: Tether project\n"
"Language-Team: Spanish\n"
@@ -2806,6 +2806,10 @@ msgstr "Sincronización de dispositivos"
msgid "Pair devices and synchronize clipboard across the network"
msgstr "Empareje dispositivos y sincronice el portapapeles a través de la red"
+#: src/gtk/tether-gtk.desktop.in
+msgid "iPhone;iOS;SMS;Messages;Clipboard;Files;Notifications;Calls;AirPods;"
+msgstr "iPhone;iOS;SMS;Mensajes;Portapapeles;Archivos;Notificaciones;Llamadas;AirPods;"
+
#~ msgid ""
#~ "Where messages and contacts are stored on this computer. Encrypted keeps "
#~ "them with a key in your desktop keyring. Do not keep deletes what is "
diff --git a/po/fr.po b/po/fr.po
index 9bfe804..39aa8a8 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-14 21:48-0700\n"
+"POT-Creation-Date: 2026-09-14 21:59-0700\n"
"PO-Revision-Date: 2026-08-22\n"
"Last-Translator: Tether project\n"
"Language-Team: French\n"
@@ -2813,6 +2813,10 @@ msgstr "Synchronisation d'appareils"
msgid "Pair devices and synchronize clipboard across the network"
msgstr "Appairez des appareils et synchronisez le presse-papiers sur le réseau"
+#: src/gtk/tether-gtk.desktop.in
+msgid "iPhone;iOS;SMS;Messages;Clipboard;Files;Notifications;Calls;AirPods;"
+msgstr "iPhone;iOS;SMS;Messages;Presse-papiers;Fichiers;Notifications;Appels;AirPods;"
+
#~ msgid ""
#~ "Where messages and contacts are stored on this computer. Encrypted keeps "
#~ "them with a key in your desktop keyring. Do not keep deletes what is "
diff --git a/po/it.po b/po/it.po
index 166c433..778295c 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-14 21:48-0700\n"
+"POT-Creation-Date: 2026-09-14 21:59-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Italian\n"
@@ -2804,6 +2804,10 @@ msgstr "Sincronizzazione dispositivi"
msgid "Pair devices and synchronize clipboard across the network"
msgstr "Accoppia dispositivi e sincronizza gli appunti sulla rete"
+#: src/gtk/tether-gtk.desktop.in
+msgid "iPhone;iOS;SMS;Messages;Clipboard;Files;Notifications;Calls;AirPods;"
+msgstr "iPhone;iOS;SMS;Messaggi;Appunti;File;Notifiche;Chiamate;AirPods;"
+
#~ msgid ""
#~ "Where messages and contacts are stored on this computer. Encrypted keeps "
#~ "them with a key in your desktop keyring. Do not keep deletes what is "
diff --git a/po/ja.po b/po/ja.po
index 2d33f9e..2c49e13 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-14 21:48-0700\n"
+"POT-Creation-Date: 2026-09-14 21:59-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Japanese\n"
@@ -2761,6 +2761,10 @@ msgstr "デバイスの同期"
msgid "Pair devices and synchronize clipboard across the network"
msgstr "デバイスをペアリングし、ネットワーク越しにクリップボードを同期します"
+#: src/gtk/tether-gtk.desktop.in
+msgid "iPhone;iOS;SMS;Messages;Clipboard;Files;Notifications;Calls;AirPods;"
+msgstr "iPhone;iOS;SMS;メッセージ;クリップボード;ファイル;通知;通話;AirPods;"
+
#~ msgid ""
#~ "Where messages and contacts are stored on this computer. Encrypted keeps "
#~ "them with a key in your desktop keyring. Do not keep deletes what is "
diff --git a/po/ko.po b/po/ko.po
index 174567f..76a87ad 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-14 21:48-0700\n"
+"POT-Creation-Date: 2026-09-14 21:59-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Korean\n"
@@ -2728,6 +2728,10 @@ msgstr "기기 동기화"
msgid "Pair devices and synchronize clipboard across the network"
msgstr "기기를 페어링하고 네트워크를 통해 클립보드를 동기화합니다"
+#: src/gtk/tether-gtk.desktop.in
+msgid "iPhone;iOS;SMS;Messages;Clipboard;Files;Notifications;Calls;AirPods;"
+msgstr "iPhone;iOS;SMS;메시지;클립보드;파일;알림;통화;AirPods;"
+
#~ msgid ""
#~ "Where messages and contacts are stored on this computer. Encrypted keeps "
#~ "them with a key in your desktop keyring. Do not keep deletes what is "
diff --git a/po/nl.po b/po/nl.po
index 0afedf2..29d0d1f 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-14 21:48-0700\n"
+"POT-Creation-Date: 2026-09-14 21:59-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Dutch\n"
@@ -2788,6 +2788,10 @@ msgstr "Apparaatsynchronisatie"
msgid "Pair devices and synchronize clipboard across the network"
msgstr "Apparaten koppelen en het klembord over het netwerk synchroniseren"
+#: src/gtk/tether-gtk.desktop.in
+msgid "iPhone;iOS;SMS;Messages;Clipboard;Files;Notifications;Calls;AirPods;"
+msgstr "iPhone;iOS;SMS;Berichten;Klembord;Bestanden;Meldingen;Gesprekken;AirPods;"
+
#~ msgid ""
#~ "Where messages and contacts are stored on this computer. Encrypted keeps "
#~ "them with a key in your desktop keyring. Do not keep deletes what is "
diff --git a/po/pl.po b/po/pl.po
index a2abaad..8604844 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-14 21:48-0700\n"
+"POT-Creation-Date: 2026-09-14 21:59-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Polish\n"
@@ -2788,6 +2788,10 @@ msgstr "Synchronizacja urządzeń"
msgid "Pair devices and synchronize clipboard across the network"
msgstr "Sparuj urządzenia i synchronizuj schowek przez sieć"
+#: src/gtk/tether-gtk.desktop.in
+msgid "iPhone;iOS;SMS;Messages;Clipboard;Files;Notifications;Calls;AirPods;"
+msgstr "iPhone;iOS;SMS;Wiadomości;Schowek;Pliki;Powiadomienia;Połączenia;AirPods;"
+
#~ msgid ""
#~ "Where messages and contacts are stored on this computer. Encrypted keeps "
#~ "them with a key in your desktop keyring. Do not keep deletes what is "
diff --git a/po/pt_BR.po b/po/pt_BR.po
index fb06f75..91cd33d 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-14 21:48-0700\n"
+"POT-Creation-Date: 2026-09-14 21:59-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Brazilian Portuguese\n"
@@ -2786,6 +2786,10 @@ msgstr "Sincronização de dispositivos"
msgid "Pair devices and synchronize clipboard across the network"
msgstr "Pareie dispositivos e sincronize a área de transferência pela rede"
+#: src/gtk/tether-gtk.desktop.in
+msgid "iPhone;iOS;SMS;Messages;Clipboard;Files;Notifications;Calls;AirPods;"
+msgstr "iPhone;iOS;SMS;Mensagens;Área de transferência;Arquivos;Notificações;Chamadas;AirPods;"
+
#~ msgid ""
#~ "Where messages and contacts are stored on this computer. Encrypted keeps "
#~ "them with a key in your desktop keyring. Do not keep deletes what is "
diff --git a/po/ru.po b/po/ru.po
index 8acad9b..524a4a2 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-14 21:48-0700\n"
+"POT-Creation-Date: 2026-09-14 21:59-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Russian\n"
@@ -2791,6 +2791,10 @@ msgstr "Синхронизация устройств"
msgid "Pair devices and synchronize clipboard across the network"
msgstr "Создавайте пары устройств и синхронизируйте буфер обмена по сети"
+#: src/gtk/tether-gtk.desktop.in
+msgid "iPhone;iOS;SMS;Messages;Clipboard;Files;Notifications;Calls;AirPods;"
+msgstr "iPhone;iOS;SMS;Сообщения;Буфер обмена;Файлы;Уведомления;Звонки;AirPods;"
+
#~ msgid ""
#~ "Where messages and contacts are stored on this computer. Encrypted keeps "
#~ "them with a key in your desktop keyring. Do not keep deletes what is "
diff --git a/po/sv.po b/po/sv.po
index ad3f4b2..e17ea1d 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-14 21:48-0700\n"
+"POT-Creation-Date: 2026-09-14 21:59-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Swedish\n"
@@ -2767,6 +2767,10 @@ msgstr "Enhetssynkronisering"
msgid "Pair devices and synchronize clipboard across the network"
msgstr "Parkoppla enheter och synkronisera urklipp över nätverket"
+#: src/gtk/tether-gtk.desktop.in
+msgid "iPhone;iOS;SMS;Messages;Clipboard;Files;Notifications;Calls;AirPods;"
+msgstr "iPhone;iOS;SMS;Meddelanden;Urklipp;Filer;Notiser;Samtal;AirPods;"
+
#~ msgid ""
#~ "Where messages and contacts are stored on this computer. Encrypted keeps "
#~ "them with a key in your desktop keyring. Do not keep deletes what is "
diff --git a/po/tether.pot b/po/tether.pot
index 150a814..a7d4e65 100644
--- a/po/tether.pot
+++ b/po/tether.pot
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: tether 0.2.31\n"
"Report-Msgid-Bugs-To: [email protected]\n"
-"POT-Creation-Date: 2026-09-14 21:48-0700\n"
+"POT-Creation-Date: 2026-09-14 21:59-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"
@@ -2530,3 +2530,7 @@ msgstr ""
#: src/gtk/tether-gtk.desktop.in
msgid "Pair devices and synchronize clipboard across the network"
msgstr ""
+
+#: src/gtk/tether-gtk.desktop.in
+msgid "iPhone;iOS;SMS;Messages;Clipboard;Files;Notifications;Calls;AirPods;"
+msgstr ""
diff --git a/po/tr.po b/po/tr.po
index 0efdba8..c1c4d33 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-14 21:48-0700\n"
+"POT-Creation-Date: 2026-09-14 21:59-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Turkish\n"
@@ -2765,6 +2765,10 @@ msgstr "Aygıt eşzamanlaması"
msgid "Pair devices and synchronize clipboard across the network"
msgstr "Aygıtları eşleştirin ve panoyu ağ üzerinden eşzamanlayın"
+#: src/gtk/tether-gtk.desktop.in
+msgid "iPhone;iOS;SMS;Messages;Clipboard;Files;Notifications;Calls;AirPods;"
+msgstr "iPhone;iOS;SMS;Mesajlar;Pano;Dosyalar;Bildirimler;Aramalar;AirPods;"
+
#~ msgid ""
#~ "Where messages and contacts are stored on this computer. Encrypted keeps "
#~ "them with a key in your desktop keyring. Do not keep deletes what is "
diff --git a/po/uk.po b/po/uk.po
index 5a25bc4..b33c457 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-14 21:48-0700\n"
+"POT-Creation-Date: 2026-09-14 21:59-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Ukrainian\n"
@@ -2786,6 +2786,10 @@ msgstr "Синхронізація пристроїв"
msgid "Pair devices and synchronize clipboard across the network"
msgstr "Створюйте пари пристроїв і синхронізуйте буфер обміну через мережу"
+#: src/gtk/tether-gtk.desktop.in
+msgid "iPhone;iOS;SMS;Messages;Clipboard;Files;Notifications;Calls;AirPods;"
+msgstr "iPhone;iOS;SMS;Повідомлення;Буфер обміну;Файли;Сповіщення;Дзвінки;AirPods;"
+
#~ msgid ""
#~ "Where messages and contacts are stored on this computer. Encrypted keeps "
#~ "them with a key in your desktop keyring. Do not keep deletes what is "
diff --git a/po/zh_CN.po b/po/zh_CN.po
index 3323f7e..2413369 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-14 21:48-0700\n"
+"POT-Creation-Date: 2026-09-14 21:59-0700\n"
"PO-Revision-Date: 2026-08-23\n"
"Last-Translator: Tether project\n"
"Language-Team: Simplified Chinese\n"
@@ -2671,6 +2671,10 @@ msgstr "设备同步"
msgid "Pair devices and synchronize clipboard across the network"
msgstr "配对设备并通过网络同步剪贴板"
+#: src/gtk/tether-gtk.desktop.in
+msgid "iPhone;iOS;SMS;Messages;Clipboard;Files;Notifications;Calls;AirPods;"
+msgstr "iPhone;iOS;SMS;信息;剪贴板;文件;通知;通话;AirPods;"
+
#~ msgid ""
#~ "Where messages and contacts are stored on this computer. Encrypted keeps "
#~ "them with a key in your desktop keyring. Do not keep deletes what is "
diff --git a/src/daemon/notification.cpp b/src/daemon/notification.cpp
index 9d0cdb9..906ac1d 100644
--- a/src/daemon/notification.cpp
+++ b/src/daemon/notification.cpp
@@ -256,7 +256,7 @@ namespace tether {
set_identity(notification, "");
notify_notification_set_hint(notification, "resident", g_variant_new_boolean(TRUE));
- notify_notification_set_timeout(notification, 15000);
+ notify_notification_set_timeout(notification, NOTIFY_EXPIRES_DEFAULT);
auto* open_file = new NotificationActionData{file_uri};
auto* open_folder = new NotificationActionData{folder_uri};
diff --git a/src/gtk/CMakeLists.txt b/src/gtk/CMakeLists.txt
index a76e589..87c0866 100644
--- a/src/gtk/CMakeLists.txt
+++ b/src/gtk/CMakeLists.txt
@@ -52,6 +52,10 @@ endif()
install(FILES ${CMAKE_CURRENT_BINARY_DIR}/tether-gtk.desktop
DESTINATION ${CMAKE_INSTALL_DATADIR}/applications)
+# Software centers (GNOME Software, Discover, Flathub) read this listing.
+install(FILES com.tether.desktop.metainfo.xml
+ DESTINATION ${CMAKE_INSTALL_DATADIR}/metainfo)
+
foreach(SIZE 16 32 48 64 128 256 512 1024)
install(FILES icons/${SIZE}x${SIZE}/tether.png
icons/${SIZE}x${SIZE}/tether-offline.png
diff --git a/src/gtk/com.tether.desktop.metainfo.xml b/src/gtk/com.tether.desktop.metainfo.xml
new file mode 100644
index 0000000..27b5266
--- /dev/null
+++ b/src/gtk/com.tether.desktop.metainfo.xml
@@ -0,0 +1,37 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<component type="desktop-application">
+ <id>com.tether.desktop</id>
+ <metadata_license>CC0-1.0</metadata_license>
+ <project_license>MIT</project_license>
+ <name>Tether</name>
+ <summary>Bridge your iPhone to the Linux desktop</summary>
+ <developer id="com.tether">
+ <name>Zack Bartel</name>
+ </developer>
+ <description>
+ <p>
+ Tether brings iPhone continuity features to Linux: clipboard sync, file
+ transfer, messages, notification mirroring, phone calls, and AirPods.
+ </p>
+ </description>
+ <launchable type="desktop-id">tether-gtk.desktop</launchable>
+ <url type="homepage">https://github.com/zackb/tether</url>
+ <url type="bugtracker">https://github.com/zackb/tether/issues</url>
+ <url type="vcs-browser">https://github.com/zackb/tether</url>
+ <screenshots>
+ <screenshot type="default">
+ <caption>A conversation in the Messages view, with the conversation list beside it</caption>
+ <image>https://raw.githubusercontent.com/zackb/tether/main/docs/img/messages.webp</image>
+ </screenshot>
+ </screenshots>
+ <supports>
+ <control>keyboard</control>
+ <control>pointing</control>
+ </supports>
+ <content_rating type="oars-1.1">
+ <content_attribute id="social-chat">intense</content_attribute>
+ </content_rating>
+ <provides>
+ <binary>tether-gtk</binary>
+ </provides>
+</component>
diff --git a/src/gtk/tether-gtk.desktop.in b/src/gtk/tether-gtk.desktop.in
index 34fab75..9232a9e 100644
--- a/src/gtk/tether-gtk.desktop.in
+++ b/src/gtk/tether-gtk.desktop.in
@@ -7,3 +7,4 @@ Icon=tether
Terminal=false
Type=Application
Categories=Network;Utility;
+Keywords=iPhone;iOS;SMS;Messages;Clipboard;Files;Notifications;Calls;AirPods;