Utility to send SMS messages with a custom Sender ID
A clean CLI, Perfect for any use case where the sender name matters
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
| 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 |
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.pypip
pip install -r requirements.txtuv
uv syncOnce 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 ✉️
Is this free?
The tool itself is free and open-source, but Vonage charges per SMS sent. Pricing depends on the destination country. You can check Vonage SMS Pricing for details. New accounts receive a small free credit to get started.
Which languages does it support?
Full Unicode support — English, Russian, Chinese, Arabic, Hebrew, and all other Unicode-compatible languages work out of the box.
Can my account get banned?
Yes — if you violate Vonage's Terms of Use, your account may be suspended. Use this tool responsibly and only for legitimate purposes.
Does it work on Linux?
Yes, fully supported. The codebase is platform-agnostic and has been tested on both Windows and Linux environments.
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!
This utility relies entirely on the official public Vonage API.
The author assumes no liability for misuse.
I'll glad to get a star from you
Made with ❤️ by Defaultik