~/ai/product
docs ready

SMS-TTS-Notify

product overview · raw txt · 2026-03-19
💡 AI Assist

Paste this into ChatGPT, Copilot, or Claude to discuss:
https://sms-tts-notify.com/ai/product.txt

What it does

An Android app that reads incoming SMS aloud through a connected headset using TTS. Built for industrial environments where workers cannot check their phones.

Every SMS is classified ALARM WARNING INFO and delivered exclusively through the headset — never the speaker.

Core behavior

Offline

100% offline. No internet. No mobile data. No Wi-Fi. GSM signal only.

On Android 14+, the service uses remoteMessaging foreground service type — no 18-minute silent window. Android 10-13 uses dataSync fallback with equivalent behavior.

Audio — headset only

EXCLUSIVELY through headset. NEVER through speaker. Hardware-enforced via AudioDeviceCallback.

ScenarioResult
Headset + SMS✓ read through headset
No headsetSilent. Logged only.
Disconnect mid-messageStops instantly. Zero fallback.
Force speaker outputImpossible. By design.

Open-ear headsets

Bone-conduction recommended — hear TTS + surroundings simultaneously. Compatible with hearing protection and helmets.

Priority routing

LevelWhat happens
ALARMQueue jump. Read before everything else.
WARNINGMedium. Ordered within tier.
INFODefault. Non-matching messages.

7-step filter pipeline

#FilterAction
1Whitelist (if enabled)PASS / BLOCKED
2BlacklistBLOCKED
3Empty checkSKIPPED
4Anti-spamBLOCKED
5Alarm WordsALARM + queue jump
6Warning WordsWARNING
7DefaultINFO

Sender matching

Whitelist and Blacklist match against both message body AND sender. Phone numbers: last-9-digit suffix matching. Alphanumeric sender IDs (e.g. "SCADA-1"): case-insensitive substring.

Message Language

User-selectable TTS language for message bodies. Settings → Status Card → Message Language → CHANGE.

SmartSummary

Spoken catch-up on return. Triggers: service start · unmute · headset reconnect · call ends (~1.5s delay)

Controls

ControlHowEffect
MutetapPauses TTS. Service keeps running.
WidgettapSame. No app launch needed.
ShakeItshakeStop current + clear queue. Sensitivity 1–5.
Headset btnpressStop current message only.
Call detectionautoPause. SmartSummary after call.

OEM battery setup

Samsung, Xiaomi, Huawei, OPPO, OnePlus, Vivo, Realme users see a mandatory 3-step battery exemption wizard on first launch. Prevents the "ghost green" problem — service appears active but SMS listener is killed by OEM battery manager.

TierManufacturersAction
CRITICALSamsung, Xiaomi/Redmi/POCO, Huawei, HonorWizard required
HIGHOPPO, Realme, Vivo, OnePlusWizard required
MINIMALGoogle Pixel, Nokia, MotorolaWizard skipped

NLS Health Watchdog: 3-layer monitoring detects if SMS listener is killed while service runs. Attempts recovery. Posts audible notification if recovery fails (~12 min detection).

Privacy

Reliability

Requirements

SpecValue
PlatformAndroid 9+
HeadsetBluetooth A2DP · wired · USB
InternetNot needed
Size~4.8 MB
PriceFree
Shift8–12h continuous

Why SMS only

Universal industrial channel. MES, SCADA, PLC, WMS, CMMS — all send SMS. No internet needed. By reading only SMS, every message matters. Zero notification fatigue. Group summary notifications ("View messages") are silently discarded.

Setup

Install → accept Terms → OEM battery wizard (if needed) → grant Notification Access → connect headset → tap ON. No account. No config required. See setup guide for detailed steps.

Notice: SMS-TTS-Notify is supplementary. It does not replace the native SMS app. Do not rely solely on it for safety-critical notifications.