https://github.com/apsun/NekoSMS

A pattern-based text message blocker for Android.
https://github.com/apsun/NekoSMS

android sms xposed

Last synced: 2 months ago
JSON representation

A pattern-based text message blocker for Android.

• Host: GitHub
• URL: https://github.com/apsun/NekoSMS
• Owner: apsun
• License: gpl-3.0
• Created: 2015-08-30T20:37:56.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2024-10-21T03:26:00.000Z (3 months ago)
• Last Synced: 2024-10-22T19:48:42.896Z (3 months ago)
• Topics: android, sms, xposed
• Language: Java
• Homepage:
• Size: 1.66 MB
• Stars: 426
• Watchers: 10
• Forks: 44
• Open Issues: 10
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
# NekoSMS

A pattern-based text message blocker for Android.

## Requirements

- A rooted phone running Android 4.4 KitKat or newer

- [Xposed framework](http://forum.xda-developers.com/xposed)

## Features

- Works with all SMS apps, stock or third party

- Block messages based on sender and/or content

- Supports regular expressions, wildcard patterns, and more

- Backup and restore your filter rules across devices

- Free, both as in beer and in speech

- No internet access, no ads, no telemetry

## Q&A

### Why is it called NekoSMS?

No reason in particular. I wanted a name that had "SMS" in it, and "neko"

was the first word that popped into my head. Hence, NekoSMS.

### Why does this app require Xposed?

[Starting from Android 4.4, only the default SMS app has the ability to intercept SMS messages](http://android-developers.blogspot.in/2013/10/getting-your-sms-apps-ready-for-kitkat.html).

In order to bypass this restriction, code must be modified at the OS level.

### What are the permissions used for?

- `READ_SMS`, `WRITE_SMS` for obvious reasons

- `VIBRATE` for notifications

### Does NekoSMS work with (insert SMS app here)?

As long as your ROM supports it, yes. There is no app-specific SMS blocking

code, so if it works with one SMS app, it will work with them all.

### How does it work? (for nerds)

It hooks the internal Android class, [`com.android.internal.telephony.InboundSmsHandler`](https://android.googlesource.com/platform/frameworks/opt/telephony/+/master/src/java/com/android/internal/telephony/InboundSmsHandler.java).

This class is responsible for taking the raw SMS data received by the phone

and dispatching it to the default SMS app, then broadcasting it to all apps

capable of reading SMS messages.

Essentially, this app intercepts the data right before it is sent to the

default SMS app, then runs it through the user-defined filters. If the

message matches a blacklist rule, the broadcast is dropped.

### How does it work? (for non-nerds)

[Dragon magic.](https://www.youtube.com/watch?v=kXbrvDsdlgE)

### Hey! Are you trying to steal my personal data?!

[Does this look like the face of evil to you?](http://i.imgur.com/rOYrxsN.gif)

The code is fully open source, so feel free to check for yourself! :-)

### Nyaa?

[Nyaa!](http://i.imgur.com/EUkvvOl.jpg)

## License

All code is licensed under [GPLv3](http://www.gnu.org/licenses/gpl-3.0.txt).

Icons are from Google's [material icons library](https://design.google.com/icons/).