Skip to content

Linux + iPhone Continuity / iMessage / SMS

address mail extension feedback

Zack Bartelf725db305e57
diff --git a/README.md b/README.md
index 664cc2b..e5e0a3a 100644
--- a/README.md
+++ b/README.md
@@ -26,7 +26,7 @@
| **File Transfer** | ✅ Stable |
| **iOS App** | ✅ Stable |
| **Browser Extension** | ✅ Stable |
-| **Mail Extension** | 🔄 In Progress |
+| **Mail Extension** | ✅ Stable |
| **TOTP/OTP Vault** | 🗓️ Planning |
### Clipboard Sync
diff --git a/docs/store-listing.md b/docs/store-listing.md
new file mode 100644
index 0000000..5679467
--- /dev/null
+++ b/docs/store-listing.md
@@ -0,0 +1,85 @@
+# Tether Mail Extension — addons.thunderbird.net listing copy
+
+## Summary (short description)
+
+Automatically detects one-time passcodes (OTP / 2FA verification codes) in
+incoming email and hands them to the local Tether daemon, so codes can be synced
+to your phone or autofilled by the Tether browser extension.
+
+---
+
+## Description (full listing body)
+
+**Tether Mail Extension** is part of [Tether](https://github.com/zackb/tether),
+which bridges your iPhone to the Linux desktop. This add-on watches your inbox for
+verification / login / 2FA codes and forwards the detected code to the Tether
+daemon running on your machine.
+
+It works entirely in the background. Once the add-on is installed and the Tether daemon is running,
+OTP emails are captured automatically.
+
+### How it works / where to find it
+
+There is no UI surface to click. After installation the extension:
+
+1. Connects to the local Tether daemon over native messaging on startup.
+2. Watches your inbox for new mail using several mechanisms (polling every 15s for
+ IMAP, plus new-mail and message-display events).
+3. Pre-filters messages by subject (e.g. "verification", "your … code", "OTP",
+ "security code") and sender (e.g. `noreply`, `security`, `verify`).
+4. Extracts the most likely code from the matching email using a scoring heuristic
+ that ignores years, prices, zip codes, and order/tracking numbers.
+5. Sends the detected code to the Tether daemon, which can copy it to your
+ clipboard, sync it to your iPhone, or make it available to the Tether browser
+ extension for autofill.
+
+To confirm it's running, open Thunderbird's **Tools → Developer Tools → Error
+Console** (or the add-on's Browser Console) and look for the log line
+`Tether Mail Extractor loaded in Thunderbird/Betterbird`.
+
+### Required: the Tether native application
+
+⚠️ **This add-on does nothing on its own.** It requires the local **Tether
+daemon (`tetherd`)** to be installed and running. The add-on communicates with it
+via native messaging (native host `com.tether.extension`); without it, detected
+codes have nowhere to go.
+
+Install the native app on Linux using one of:
+
+- **Arch Linux (AUR):**
+ ```bash
+ yay -S tether
+ ```
+- **GitHub Releases** — download the `.deb`, `.rpm`, or `.tar.gz` for your distro
+ from <https://github.com/zackb/tether/releases>.
+- **Build from source:**
+ ```bash
+ git clone https://github.com/zackb/tether.git
+ cd tether
+ make release
+ sudo make install
+ ```
+ `make install` also registers the native messaging host with Thunderbird so the
+ add-on can reach the daemon.
+
+The daemon (`tetherd`), will start on-demand when needed. Full documentation and
+setup details are at <https://github.com/zackb/tether>.
+
+---
+
+## Screenshots to attach
+
+The extension is background-only, so screenshots should demonstrate the
+end-to-end flow rather than an in-app UI:
+
+1. **Add-on installed** — the Tether Mail Extension enabled in Thunderbird's
+ Add-ons Manager.
+2. **Example OTP email** — a verification / 2FA email open in Thunderbird (use a
+ redacted sample code).
+3. **Code captured by Tether** — the detected code arriving in Tether, e.g.
+ `tether` CLI output, the system clipboard, or the iPhone receiving it —
+ showing the captured-and-forwarded result.
+
+Branding assets available in the repo for the listing image/header:
+`docs/img/tether_header.png`, `docs/img/tether-dark.svg`,
+`docs/img/tether-light.svg`.
diff --git a/extension/build.sh b/extension/build.sh
index 6117df2..3c9ec3d 100755
--- a/extension/build.sh
+++ b/extension/build.sh
@@ -19,7 +19,6 @@ npx esbuild extension/src/background/background.js --bundle --outfile="$BROWSER_
npx esbuild extension/src/content/autofill.js --bundle --outfile="$BROWSER_DIR/src/content/autofill.js"
cp extension/manifest-browser.json "$BROWSER_DIR/manifest.json"
if [ -d "extension/icons" ]; then cp -R extension/icons "$BROWSER_DIR/"; fi
-if [ -d "extension/popup" ]; then cp -R extension/popup "$BROWSER_DIR/"; fi
(cd "$BROWSER_DIR" && zip -qr ../tether-browser-extension.zip .)
# Bundle Mail Extension
@@ -28,7 +27,6 @@ npx esbuild extension/src/background/background.js --bundle --outfile="$MAIL_DIR
npx esbuild extension/src/mail/extractor.js --bundle --outfile="$MAIL_DIR/src/mail/extractor.js"
cp extension/manifest-mail.json "$MAIL_DIR/manifest.json"
if [ -d "extension/icons" ]; then cp -R extension/icons "$MAIL_DIR/"; fi
-if [ -d "extension/popup" ]; then cp -R extension/popup "$MAIL_DIR/"; fi
(cd "$MAIL_DIR" && zip -qr ../tether-mail-extension.xpi .)
# Bundle Chromium Extension (Web Store upload)
@@ -37,7 +35,6 @@ npx esbuild extension/src/background/background.js --bundle --outfile="$CHROME_D
npx esbuild extension/src/content/autofill.js --bundle --outfile="$CHROME_DIR/src/content/autofill.js"
cp extension/manifest-browser.json "$CHROME_DIR/manifest.json"
if [ -d "extension/icons" ]; then cp -R extension/icons "$CHROME_DIR/"; fi
-if [ -d "extension/popup" ]; then cp -R extension/popup "$CHROME_DIR/"; fi
(cd "$CHROME_DIR" && zip -qr ../tether-chromium-extension.zip .)
echo "Extensions successfully built and packaged in $BUILD_DIR"
diff --git a/extension/manifest-mail.json b/extension/manifest-mail.json
index 5e85906..0ed639a 100644
--- a/extension/manifest-mail.json
+++ b/extension/manifest-mail.json
@@ -1,7 +1,7 @@
{
"manifest_version": 2,
"name": "Tether Mail Extension",
- "version": "1.0.1",
+ "version": "1.0.2",
"description": "Extracts OTPs from emails for Tether daemon",
"browser_specific_settings": {
"gecko": {
@@ -12,6 +12,7 @@
"permissions": [
"nativeMessaging",
"messagesRead",
+ "accountsRead",
"storage"
],
"background": {