📸 Preview

📖 What is this?

sms-spoofer is a cross-platform Python utility that let you send SMS messages where the Sender ID (the name shown instead of a phone number) is fully customizable.

This is the same mechanism used by legitimate services worldwide — OTP codes, delivery notifications, appointment reminders, password resets, two-factor authentication prompts — all rely on custom Sender IDs.

📸 See it in action: Example #1 · Example #2

✨ Features

| Feature | Details | |--------|---------| | 🖥️ Cross-Platform | Runs natively on Windows, Linux, and macOS | | 🎛️ Menu-Based CLI | Interactive terminal interface, no config files needed | | 🐍 Pure Python | No compiled binaries, fully readable source code | | 🗣️ Unicode Support | Works in English, Russian, Chinese, Arabic, and more | | 🏷️ Custom Sender ID | Set any alphanumeric name as the sender (up to 11 chars) | | 🌍 Global Reach | Send to virtually any country via Vonage's global network |

🚀 Quick Start

Requirements: Python 3.14+ (verified version), Vonage account

# 1. Clone the repo
git clone https://github.com/Defaultik/sms-spoofer.git
cd sms-spoofer
3. Run
Menu Based
python source/menu/main.py
Command Based
python source/command/sms_spoofer.py

Installing dependencies

pip install -r requirements.txt

uv sync

🎬 Usage

Once launched, you'll be greeted by an interactive menu. Simply:

• Enter your Vonage API Key and API Secret (found in your Vonage Dashboard)
• Specify the Sender Name (what the recipient will see instead of a number)
• Enter the recipient's phone number in international format (e.g. +1001234567)
• Type your message
• Hit send ✉️

❓ FAQ

🤝 Contributing

Contributions are welcome! Feel free to:

• 🐛 Open an issue for bugs or suggestions
• 🔀 Submit a Pull Request with improvements
• ⭐ Star the repo if you find it useful — it genuinely helps!

⚠️ Legal & Ethical Disclaimer

This utility relies entirely on the official public Vonage API.

The author assumes no liability for misuse.