aj3423/SpamBlocker
aj3423/SpamBlocker has 1,958 GitHub stars and 102 forks. GitHot measured +2 stars in 24 hours. Last checked 2026-11-08 00:13 UTC. Last push 2026-11-02.
Android Call/SMS blocker.
What you can do
- Contacts - From a contact?
- Contact Group - From a contact group?
- Contact Prefix - Matches prefix of an existing contact? Use case: save one clinic number xxxx22 to allow its full range xxxx11-xxxx99
- STIR/SHAKEN - Fails STIR/SHAKEN attestation?
Measured star growth
- in 24h
- +2
- in 7 days
- Collecting history
- in 15 days
- Collecting history
- in 1 month
- Collecting history
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
README.md
OriginalSpamBlocker
Android Call/SMS blocker. (Android 10+)
[!NOTE] There are unknown forks on Google play, this one is published under "atvari"
Table of Contents
- Screenshots
- How it works
- Features
- Limitations
- FAQ
- Permissions
- Privacy
- Language Support
- Contribution Wanted
- Some ideas
- Donate
Screenshots
| History | Settings | Notification |
|---|---|---|
How it works
It works without replacing your call/SMS app. You can kill the app after setup, it doesn't need to stay running in the background.
📞 For call:
It's a Caller ID app.
💬 For SMS:
The app takes over SMS notifications, you need to disable notifications from the SMS app to avoid duplicates.
| App | Send/Receive SMS | Show Notifications | Message Logs | The Point |
|---|---|---|---|---|
| SpamBlocker | ❌ | ✅️ Takes over notifications | Received messages only, no sent messages | Avoid interruptions |
| SMS apps | ✅️ | ❌ Must be manually disabled | All messages (remain undeleted, including spam texts) |
Messaging |
SMS Screening provider mode:
Similar to call screening, the app can work as a service. The SMS app asks it to check messages in real time, this app simply replies "block" or "allow". It only works with SMS apps that support this SMS screening protocol. Currently, this is not supported by any SMS app :)
Features:
| Filter | It checks |
|---|---|
| Contacts | From a contact? |
| Contact Group | From a contact group? |
| Contact Prefix | Matches prefix of an existing contact? Use case: save one clinic number xxxx22 to allow its full range xxxx11-xxxx99 |
| STIR/SHAKEN | Fails STIR/SHAKEN attestation? |
| Repeated Calls | Multiple calls from the same number in a short while? |
| Dialed Number | Have you dialed the number? |
| Answered Number | Allow previously answered numbers |
| Emergency | Allow calls for a while after dialing an emergency number(e.g. 911) |
| Push Alert | Allow calls after receiving notifications from other apps, e.g.: "Your order has been taken by driver ...", the driver may then contact you. |
| SMS Alert | Allow calls after receiving SMS messages like: "[From ...] We are calling to inform ..., please feel free to answer." |
| SMS Bomb | Block continuous OTP message floods |
| Recent Apps | Allow calls if some apps have been used recently. Use case: You ordered Pizza online and soon they call you to refund. |
| Meeting Mode | Decline calls during online video meetings. |
| Off Time | A time period that always allows calls, usually no spams at night. |
| Spam Database | Block numbers in the spam database. Any downloadable spam databases can be integrated, such as the FTC-DNC registry. |
| Local AI Training | Train your own spam SMS filter |
| Schedule & Calendar | Auto adjust rules based on time schedule and calendar events |
| Geolocation & Carrier | Block numbers based on geolocation or carrier name |
| Instant Query | Check the incoming number online in real time, querying multiple API endpoints simultaneously, such as the PhoneBlock. |
| Report Spam | Automatically or manually report the number to build our crowd-sourced databases, protecting others and yourself. |
| Regex (regular expression) |
Check the Wiki for examples. |
Limitations
FAQ
- How the "Priority" works
- Material UI
- It stops working after being killed
- Android 16+ always shows a "missed call" notification for silenced calls
Permissions
| Permission (all optional) | Why |
|---|---|
| INTERNET | For database downloading / instant query / number reporting |
| ANSWER_PHONE_CALLS | Reject, answer and hang-up calls |
| POST_NOTIFICATIONS | Show notifications |
| READ_CONTACTS | Match contacts |
| RECEIVE_SMS / RECEIVE_MMS | For SMS notification screening |
| SEND_SMS | For auto replying to blocked contacts |
| READ_CALL_LOG | For allowing repeated calls |
| READ_SMS | For training local AI |
| READ_CALENDAR | For dynamically adjusting rules based on calendar events |
| PACKAGE_USAGE_STATS | For feature: Recent Apps (check whether an app has been used recently) |
| READ_PHONE_STATE | For BlockMode: Answer+Hang-up (monitor ringing state) |
| READ_PHONE_NUMBERS | For displaying phone numbers on SIM picker |
| REQUEST_IGNORE_BATTERY_OPTIMIZATIONS | For it to keep working after being swiped and killed |
| NOTIFICATION_ACCESS | For feature: Push Alert (receiving notifications from other apps) |
| WRITE_SETTINGS | For customizing call ringtone |
| READ_LOG | For reporting bugs with logcat messages |
| SYSTEM_ALERT_WINDOW | For the caller ID floating window |
| SCHEDULE_EXACT_ALARM | For repeating important notifications |
Privacy
For offline features
No data collection.
For online features:
The API server will see your:
- IP address
- TLS and TCP fingerprints (which would reveal your Android OS)
- The reported number(including your country code)
Nothing else.
Reproducible apk
Apk signing signature:
apksigner verify --print-certs SpamBlocker.apk7b1ce727856f3427eab1fadfad6c9730cd4e6ba201661547f009206377dffb58
Language support
Languages are translated using AI, PRs for corrections are welcome.
Contribution Wanted
- Both manual and AI-assisted improvements are welcome.
Some ideas
(new ideas are welcome)
Donate 🤑
Explore related projects
codecrafters-io/build-your-own-x
Master programming by recreating your favorite technologies from scratch.
560,903 starspublic-apis/public-apis
A collective list of free APIs
497,142 starsmorluto/rea
Reverse engineer anything with agents, from app behavior down to native binaries.
442,158 starsopenclaw/openclaw
The AI that really does things. Any OS. Any Platform. The lobster way. 🦞
394,173 stars