Skip to content

README.md

Latest commit

 

History

History
307 lines (231 loc) · 7.6 KB

README.md

File metadata and controls

307 lines (231 loc) · 7.6 KB

📱 PhoneControl - Complete Android Remote Access Suite

Educational project for learning ethical hacking, network programming, and full-stack development

🎯 What Is This?

A comprehensive suite of tools for Android device control and network tunneling:

  1. WirelessConnector - Professional ADB wireless manager with 15+ features
  2. WebExploit - Browser-based remote access demo
  3. Mport - Production-level tunneling service "Your Port to the World" 🚀 (in development)

⚡ Quick Start

Run Main Launcher:

MAIN_LAUNCHER.bat

Or Run Individual Projects:

# ADB Wireless Control (Local WiFi)
python WirelessConnector/wireless_connector.py

# Web Browser Exploitation Demo
python WebExploit/web_exploit_server.py

# Mport Tunnel Service (when ready)
cd Mport
python server/main.py

📁 Project Structure

PhoneControl/
├── 📱 WirelessConnector/    # ADB wireless manager (READY ✅)
├── 🌐 WebExploit/           # Browser exploitation (READY ✅)  
├── 🚀 Mport/                # Tunnel service "Your Port to the World" (IN DEV 🏗️)
├── 📚 docs/                 # All documentation
├── 📜 scripts/              # Batch launchers
└── 🗄️  archived/            # Legacy code

🚀 Mport - The Star Project!

"Your Port to the World"

What is Mport?

A production-ready tunneling service (like ngrok) that:

  • ✅ Works in restricted networks (e.g., Pakistan)
  • ✅ Free for students (GitHub Student Pack)
  • ✅ Multi-user support
  • ✅ Web dashboard
  • ✅ Production-grade security

Why "Mport"?

  • M = Muhammad (creator)
  • port = Network port / Portal to the world
  • Mission: Connect anyone, anywhere, always

Timeline:

  • 12 weeks to production
  • Phase 1 (Now): Basic TCP tunnel
  • Phase 5 (Week 12): Full production launch

Read more: Mport/README.md and Mport/ROADMAP.md

📋 Features

WirelessConnector (Complete ✅)

  • ✅ Wireless ADB connection manager
  • ✅ Screenshot & screen recording
  • ✅ File transfer (pull/push)
  • ✅ App installation & management
  • ✅ Shell command execution
  • ✅ Live screen monitoring (scrcpy)
  • ✅ Power button lock
  • ✅ System information
  • ✅ Network diagnostics
  • ✅ Auto-save devices
  • ✅ One-time USB setup wizard

WebExploit (Complete ✅)

  • ✅ Flask + Socket.IO server
  • ✅ Camera access
  • ✅ Vibration control
  • ✅ Browser fingerprinting
  • ✅ Hacker-style UI
  • ✅ Real-time communication

Mport (Week 1 Complete! �)

Production-Ready TCP Tunneling Service

✅ Core Features (Week 1):

  • ✅ 3-port architecture (public, control, tunnel)
  • ✅ Persistent client connections (24/7 uptime)
  • ✅ Multiple simultaneous tunnels
  • ✅ Bidirectional data forwarding
  • ✅ Comprehensive error handling & recovery
  • ✅ Exponential backoff reconnection
  • ✅ Connection health monitoring
  • ✅ Graceful shutdown handling

✅ Professional Features (Day 4-5):

  • ✅ Real-time statistics & metrics
  • ✅ Rate limiting (prevent abuse)
  • ✅ CLI argument parsing (15+ options)
  • ✅ Dual logging (console + files)
  • ✅ Human-readable data formatting
  • ✅ Auto-cleanup dead connections
  • ✅ Professional error messages

🔜 Coming in Week 2:

  • 🔜 TLS/SSL encryption
  • 🔜 VPS deployment (DigitalOcean)
  • 🔜 Token authentication
  • 🔜 Web dashboard
  • 🔜 Domain setup

🎓 Learning Project

This is an educational project for learning:

Programming:

  • Python async/await
  • Socket programming
  • Protocol design
  • Full-stack development

DevOps:

  • Linux server management
  • Docker & deployment
  • CI/CD pipelines
  • Monitoring & logging

Security:

  • Network security
  • TLS/SSL encryption
  • Authentication systems
  • Ethical hacking concepts

📚 Documentation

💰 Resources Available

GitHub Student Pack (FREE):

  • DigitalOcean: $200 credit (33 months of $6/mo VPS!)
  • Namecheap: Free .me domain
  • Azure: $100 credit
  • ngrok Pro: 1 year free
  • Many more tools!

Total Cost: $0 for first 2+ years! 🎉

⚠️ Legal & Ethical Use

IMPORTANT: This project is for EDUCATIONAL PURPOSES ONLY

✅ Allowed:

  • Testing on YOUR OWN devices
  • Learning networking concepts
  • Building portfolio projects
  • Educational demonstrations

❌ NOT Allowed:

  • Unauthorized access to others' devices
  • Malicious use
  • Privacy violations
  • Any illegal activities

Always get explicit permission before accessing any device!

📊 Project Status

Component Status Completion
WirelessConnector ✅ Production 100%
WebExploit ✅ Production 100%
Mport 🚀 Week 1 Complete! 85% (6/7 days)
Documentation ✅ Complete 100%

Mport Progress Details:

  • ✅ Day 1: Basic TCP tunnel architecture
  • ✅ Day 2: Bidirectional data forwarding
  • ✅ Day 3: Persistent connections & multiple tunnels
  • ✅ Day 4: Error handling & recovery system
  • ✅ Day 5: Statistics, rate limiting, CLI arguments
  • ✅ Day 6-7: Testing & comprehensive documentation
  • Code Written: 4,109 lines
  • Tested: ✅ Working with real Android phone (BE2029)
  • Next: Week 2 - Security & Deployment

🎯 Current Focus

Mport Week 1 - COMPLETE! 🎉

Achievements:

  • ✅ 4,109 lines of production-ready code
  • ✅ Professional-grade error handling
  • ✅ Real-time statistics & monitoring
  • ✅ Rate limiting & abuse prevention
  • ✅ CLI arguments (15+ options)
  • ✅ Comprehensive testing & documentation

Test Results:

PS> adb connect localhost:8080
connected to localhost:8080

PS> adb -s localhost:8080 shell getprop ro.product.model
BE2029  # ✅ WORKING!

What's Next:

  • Week 2: TLS/SSL encryption + VPS deployment
  • Goal: Access your phone from ANYWHERE in the world! 🌍

See detailed progress in:

  • Mport/PROGRESS.md - Development timeline
  • Mport/TESTING.md - Test results
  • Mport/CHANGELOG.md - Complete history
  • Mport/ROADMAP.md - 12-week plan

🚀 Quick Commands

# Run existing projects
MAIN_LAUNCHER.bat

# Run Mport Server (Week 1 Complete!)
cd Mport
python server/tunnel_server.py --help
python server/tunnel_server.py  # Start with defaults

# Run Mport Client
python client/tunnel_client.py --help
python client/quick_start.py  # No-prompt launcher

# Connect ADB through Mport tunnel
adb connect localhost:8080
adb -s localhost:8080 shell getprop ro.product.model

# View Mport documentation
type ROADMAP.md     # 12-week plan
type PROGRESS.md    # What we've built
type TESTING.md     # Test results
type CHANGELOG.md   # Complete history
type BRANDING.md    # Project vision

# Install dependencies
pip install -r requirements.txt

🙏 Acknowledgments

  • ADB - Android Debug Bridge
  • scrcpy - Screen mirroring
  • Flask - Web framework
  • GitHub Student Pack - Free resources
  • Open source community - Inspiration & learning

Let's Build Mport Together! 🚀

Mport - Your Port to the World

Last Updated: October 25, 2025
Mport Week 1: COMPLETE! 🎉 - 4,109 lines of production code
Next: Week 2 - Security & Deployment