How kushalvachar2006/shieldsms works
ShieldSMS is an Android SMS app that protects sensitive incoming message bodies while keeping ordinary messages visible. Its main flow is SMS delivery → keyword classification → encrypt sensitive content → local storage and privacy-safe notification; users open conversations, and biometric/device authentication gates decryption. The README also documents default-SMS onboarding and explicitly scoped-out MMS and sending stubs. Source excerpts establish receiver, persistence, listing, and unlock interactions; the manifest-defined Android dispatch and some UI routing are not excerpted.
Main entry points: UnlockActivity.java Authenticated reveal · SmsDeliverReceiver.java SMS receiver · MainActivity.java Message list · AppDatabase.java Local message database
Components 22
SMS entry
- SMS receiver
app/src/main/java/com/kva/shieldsms/receiver/SmsDeliverReceiver.java - Keyword detector
app/src/main/java/com/kva/shieldsms/detector/SensitiveKeywordDetector.java - MMS stub
app/src/main/java/com/kva/shieldsms/receiver/MmsReceiver.java - Quick-reply stub
app/src/main/java/com/kva/shieldsms/receiver/HeadlessSmsSendService.java
Secure message handling
- Message cryptography
app/src/main/java/com/kva/shieldsms/vault/CryptoHelper.java - Local message database
app/src/main/java/com/kva/shieldsms/data/AppDatabase.java - Message queries
app/src/main/java/com/kva/shieldsms/data/MessageDao.java - Message record
app/src/main/java/com/kva/shieldsms/data/MessageEntity.java - Contact lookup
app/src/main/java/com/kva/shieldsms/data/ContactHelper.java
Messaging experience
- Default SMS onboarding
app/src/main/java/com/kva/shieldsms/ui/OnboardingActivity.java - Message list
app/src/main/java/com/kva/shieldsms/ui/MainActivity.java - Message view model
app/src/main/java/com/kva/shieldsms/ui/MessageViewModel.java - Message list adapter
app/src/main/java/com/kva/shieldsms/ui/MessageAdapter.java - Conversation view
app/src/main/java/com/kva/shieldsms/ui/ConversationActivity.java - Authenticated reveal
app/src/main/java/com/kva/shieldsms/ui/UnlockActivity.java - Sending stub
app/src/main/java/com/kva/shieldsms/ui/ComposeActivity.java
Other components
- Android SMS system
- User
- Android Keystore
- Device authentication
- Android notifications
- Device contacts
Connections 27
- Android SMS system → SMS receiver: delivers SMS
README.md - SMS receiver → Keyword detector: classifies text
app/src/main/java/com/kva/shieldsms/receiver/SmsDeliverReceiver.java - SMS receiver → Message cryptography: encrypts sensitive
app/src/main/java/com/kva/shieldsms/receiver/SmsDeliverReceiver.java - SMS receiver → Local message database: stores message
app/src/main/java/com/kva/shieldsms/receiver/SmsDeliverReceiver.java - SMS receiver → Android notifications: posts preview
app/src/main/java/com/kva/shieldsms/receiver/SmsDeliverReceiver.java - SMS receiver → Contact lookup: resolves sender
app/src/main/java/com/kva/shieldsms/receiver/SmsDeliverReceiver.java - Message cryptography → Android Keystore: uses key
app/src/main/java/com/kva/shieldsms/vault/CryptoHelper.java - Local message database → Message queries: provides queries
app/src/main/java/com/kva/shieldsms/data/AppDatabase.java - Message queries → Message record: queries records
app/src/main/java/com/kva/shieldsms/data/MessageDao.java - Message list → Message view model: observes list
app/src/main/java/com/kva/shieldsms/ui/MainActivity.java - Message view model → Local message database: loads messages
app/src/main/java/com/kva/shieldsms/ui/MessageViewModel.java - Message list → Message list adapter: updates rows
app/src/main/java/com/kva/shieldsms/ui/MainActivity.java - Message list → Conversation view: opens thread
app/src/main/java/com/kva/shieldsms/ui/MainActivity.java - Conversation view → Message view model: loads thread
app/src/main/java/com/kva/shieldsms/ui/ConversationActivity.java - Conversation view → Authenticated reveal: opens protected
app/src/main/java/com/kva/shieldsms/ui/ConversationActivity.java - Message list → Authenticated reveal: opens protected
app/src/main/java/com/kva/shieldsms/ui/MainActivity.java - Authenticated reveal → Device authentication: requests authentication
app/src/main/java/com/kva/shieldsms/ui/UnlockActivity.java - Authenticated reveal → Local message database: loads ciphertext
app/src/main/java/com/kva/shieldsms/ui/UnlockActivity.java - Authenticated reveal → Message cryptography: decrypts after auth
app/src/main/java/com/kva/shieldsms/ui/UnlockActivity.java - Authenticated reveal → Contact lookup: resolves sender
app/src/main/java/com/kva/shieldsms/ui/UnlockActivity.java - Contact lookup → Device contacts: looks up name
app/src/main/java/com/kva/shieldsms/data/ContactHelper.java - Default SMS onboarding → Message list: proceeds on grant
app/src/main/java/com/kva/shieldsms/ui/OnboardingActivity.java - User → Default SMS onboarding: starts setup
- User → Authenticated reveal: opens message
- Sending stub → Android SMS system: sending out of scope
README.md - MMS stub → Android SMS system: MMS out of scope
README.md - Quick-reply stub → Android SMS system: reply stub
README.md