Skip to content

Witthayanuraks/blockercell

Repository files navigation

🔒📱 BlockerCell

A smart call & SMS blocker to keep your privacy intact.

BlockerCell Demo

Python Version
License: MIT
GitHub Stars

Tired of spam calls and unwanted messages? BlockerCell is your Python-powered shield against telemarketers, scammers, and annoying contacts. Block calls, filter SMS, and take back control of your phone!
スパム電話や迷惑メッセージにうんざりしていませんか?BlockerCellは、テレマーケティング、詐欺師、迷惑な連絡先に対するPythonパワーの盾です。電話をブロックし、SMSをフィルタリングし、携帯電話のコントロールを取り戻しましょう!


✨ Features [ COMMING SOON AS SOME FEATURE ]

Call Blocking – Silence specific numbers or unknown callers.
SMS Filtering – Auto-detect and block spam messages using keywords.
Custom Rules – Blacklist/whitelist numbers, regex patterns, or contacts.
Easy to Use – Simple CLI (GUI support planned? Mention if applicable).
Cross-Platform – Works on Windows, Linux, and Android (via Termux).


🚀 Quick Start

Prerequisites

  • Python 3.6+
  • pip

Installation

  1. Clone & enter:
    git clone https://github.com/Witthayanuraks/blockercell.git && cd blockercell
  2. Install dependencies:
    pip install -r requirements.txt
  3. Run it:
    python main.py --help

🛠️ Usage Examples

Block a number

python main.py --block +1234567890

Unblock a number

python main.py --unblock +1234567890

Filter SMS with keywords

python main.py --filter-sms "spam,promo,loan"

(Add a GIF here showing the CLI in action!)


⚙️ Configuration

Edit config.json to customize rules:

{
  "blacklist": ["+1234567890", "Scammer"],
  "whitelist_mode": false,
  "sms_keywords": ["spam", "urgent!"]
}

🤝 Contributing

Love BlockerCell? Help make it better!

  1. Fork the repo.
  2. Branch your feature (git checkout -b cool-feature).
  3. Commit changes (git commit -m 'Added cool feature').
  4. Push to the branch (git push origin cool-feature).
  5. Open a PR and describe your changes!

📜 License

MIT © Aroes Noer Cahya


❓ Need Help?


Star this repo if you find it useful, and dont forget to still improve

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •  

Languages