Linux + iPhone Continuity / iMessage / SMS
address mail extension feedback
Zack Bartelf725db305e57
diff --git a/README.md b/README.mdindex 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 Syncdiff --git a/docs/store-listing.md b/docs/store-listing.mdnew file mode 100644index 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.shindex 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_DIRnpx 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_Dnpx 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.jsonindex 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": {