{"id":31767910,"url":"https://github.com/webdevtodayjason/mct2032","last_synced_at":"2025-10-10T01:48:56.555Z","repository":{"id":296716618,"uuid":"993994552","full_name":"webdevtodayjason/mct2032","owner":"webdevtodayjason","description":"ESP32 Pen Testing Dev Project","archived":false,"fork":false,"pushed_at":"2025-06-02T03:08:47.000Z","size":922,"stargazers_count":5,"open_issues_count":1,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-06T01:30:31.969Z","etag":null,"topics":["cybersecurity","esp32","penetration-testing","pentesting"],"latest_commit_sha":null,"homepage":"https://webdevtodayjason.github.io/mct2032/","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/webdevtodayjason.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-01T00:46:09.000Z","updated_at":"2025-09-07T18:45:52.000Z","dependencies_parsed_at":"2025-06-03T06:20:04.667Z","dependency_job_id":null,"html_url":"https://github.com/webdevtodayjason/mct2032","commit_stats":null,"previous_names":["webdevtodayjason/mct2032"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/webdevtodayjason/mct2032","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webdevtodayjason%2Fmct2032","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webdevtodayjason%2Fmct2032/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webdevtodayjason%2Fmct2032/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webdevtodayjason%2Fmct2032/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/webdevtodayjason","download_url":"https://codeload.github.com/webdevtodayjason/mct2032/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webdevtodayjason%2Fmct2032/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279002400,"owners_count":26083375,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-09T02:00:07.460Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cybersecurity","esp32","penetration-testing","pentesting"],"created_at":"2025-10-10T01:48:51.117Z","updated_at":"2025-10-10T01:48:56.549Z","avatar_url":"https://github.com/webdevtodayjason.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MCT2032 - Mini Cyber Tool 2032\n\n\u003cdiv align=\"center\"\u003e\n\n![MCT2032 Logo](https://img.shields.io/badge/MCT2032-Cyber%20Tool-8b5cf6?style=for-the-badge\u0026logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIyNCIgaGVpZ2h0PSIyNCIgdmlld0JveD0iMCAwIDI0IDI0IiBmaWxsPSJub25lIiBzdHJva2U9ImN1cnJlbnRDb2xvciIgc3Ryb2tlLXdpZHRoPSIyIiBzdHJva2UtbGluZWNhcD0icm91bmQiIHN0cm9rZS1saW5lam9pbj0icm91bmQiPjxwYXRoIGQ9Ik0xMiAydjIwTTIgMTJoMjBNMiAxMmw0IDQtNC00TTIyIDEybC00IDQgNC00Ii8+PC9zdmc+)\n\n[![GitHub release](https://img.shields.io/github/release/webdevtodayjason/mct2032.svg?style=flat-square\u0026color=8b5cf6)](https://github.com/webdevtodayjason/mct2032/releases)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)\n[![ESP32](https://img.shields.io/badge/ESP32-S3-000000?style=flat-square\u0026logo=espressif)](https://www.espressif.com/)\n[![PlatformIO](https://img.shields.io/badge/PlatformIO-5.0+-orange?style=flat-square)](https://platformio.org/)\n[![Python](https://img.shields.io/badge/Python-3.8+-blue?style=flat-square\u0026logo=python)](https://www.python.org/)\n[![Web Installer](https://img.shields.io/badge/Web-Installer-success?style=flat-square\u0026logo=google-chrome)](https://webdevtodayjason.github.io/mct2032/)\n\n**A portable cybersecurity toolkit that fits in your pocket**\n\n[Web Installer](https://webdevtodayjason.github.io/mct2032/) • [Documentation](docs/) • [Report Bug](https://github.com/webdevtodayjason/mct2032/issues) • [Request Feature](https://github.com/webdevtodayjason/mct2032/issues)\n\n\u003c/div\u003e\n\n---\n\n## 🎯 About The Project\n\nMCT2032 transforms the Waveshare ESP32-S3-LCD-1.47 into a powerful cybersecurity research tool. With its circular display, dual-core processor, and wireless capabilities, it's the perfect platform for security professionals and enthusiasts.\n\n**Why \"Mini\"?** At just 50mm × 38.5mm and $12.99, MCT2032 proves that powerful security tools don't need to be expensive or bulky. It's the most affordable entry point into professional WiFi security research.\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://www.waveshare.com/media/catalog/product/e/s/esp32-s3-lcd-1.47-1.jpg\" alt=\"Waveshare ESP32-S3-LCD-1.47\" width=\"400\"\u003e\n\u003c/div\u003e\n\n---\n\n## 🛡️ Hardware: Waveshare ESP32-S3-LCD-1.47\n\n### Why This Device?\n\nThe Waveshare ESP32-S3-LCD-1.47 is the **first of its kind** to be transformed into a dedicated cybersecurity tool. While others focus on generic IoT projects, we're pioneering its use in the security sector.\n\n### Technical Specifications\n\n| Component | Specification |\n|-----------|---------------|\n| **Processor** | ESP32-S3 Dual-core Xtensa LX7 @ 240MHz |\n| **Memory** | 512KB SRAM, 384KB ROM, 16MB Flash, 8MB PSRAM |\n| **Display** | 1.47\" Round LCD (172×320, 262K colors, ST7789 driver) |\n| **Wireless** | 2.4GHz WiFi (802.11 b/g/n), Bluetooth 5.0 LE |\n| **Storage** | MicroSD card slot (SPI) |\n| **USB** | Type-C with native USB support |\n| **GPIO** | 14 programmable pins |\n| **Extras** | RGB LED, BOOT/RESET buttons |\n| **Power** | 5V via USB-C, 3.3V operating |\n| **Size** | 50.0mm × 38.5mm (pocket-sized!) |\n| **Price** | ~$12.99 (Incredible value!) |\n\n### Why It's Perfect for Cybersecurity\n\n- 🚀 **Dual-Core Power**: Run packet capture on one core, UI on the other\n- 📡 **Integrated Antenna**: No external antenna needed for WiFi/BLE operations\n- 💾 **Massive Memory**: 8MB PSRAM handles large packet buffers\n- 🎨 **Circular Display**: Unique form factor with custom cyberpunk UI\n- 🔌 **Native USB**: Direct serial communication, no adapter needed\n- 💰 **Affordable**: Professional features at hobbyist price\n\n---\n\n## ✨ Current Features\n\n### 🟢 Working\n- ✅ **WiFi Scanner** - Comprehensive network analysis\n  - SSID, BSSID, Channel, RSSI, Security detection\n  - Hidden network discovery\n  - Channel-specific scanning\n  - Real-time signal strength indicators\n- ✅ **Stop Scan** - Interrupt long-running scans\n- ✅ **BLE Admin Console** - Full device control via Bluetooth\n  - Cross-platform Python application\n  - Dark hacker-themed UI\n  - Real-time data visualization\n- ✅ **Chunked Data Transfer** - Handle large datasets over BLE\n- ✅ **Web Installer** - Browser-based firmware flashing\n- ✅ **Circular UI** - Custom LVGL interface with animations\n\n### 🟡 Framework Ready (Not Active)\n- 🔨 Packet Monitor (promiscuous mode)\n- 🔨 Deauth Attack capability\n- 🔨 Beacon Spam framework\n- 🔨 PCAP capture infrastructure\n- 🔨 Evil Portal framework\n\n---\n\n## 🐛 Known Issues\n\n- 🔴 **BLE Scanning**: Not implemented (returns \"Not implemented yet\")\n- 🟡 **SD Card**: Not tested, may need initialization\n- 🟡 **Battery Monitor**: Returns dummy value (100%)\n- 🟡 **Advanced Features**: Framework only, not functional yet\n\n---\n\n## 📋 TODO List\n\n### High Priority\n- [ ] Implement BLE scanning functionality\n- [ ] Add SD card support for PCAP storage\n- [ ] Implement packet injection for deauth\n- [ ] Create settings persistence system\n- [ ] Add OTA update capability\n\n### Medium Priority\n- [ ] Battery voltage monitoring\n- [ ] Channel hopping visualization\n- [ ] Signal strength graphs\n- [ ] Export scan results to CSV\n- [ ] Implement WPS pin attacks\n\n### Low Priority\n- [ ] Custom boot logo\n- [ ] Sound effects via piezo\n- [ ] RGB LED patterns for status\n- [ ] Power saving modes\n\n---\n\n## 🗺️ Roadmap\n\n### Phase 1: Foundation (Current)\n- ✅ Basic WiFi scanning\n- ✅ BLE communication\n- ✅ Admin console\n- ✅ Web installer\n\n### Phase 2: Security Tools (Q1 2025)\n- 🎯 Active packet monitoring\n- 🎯 Deauth attack implementation\n- 🎯 Beacon spam activation\n- 🎯 PCAP file creation\n\n### Phase 3: Advanced Features (Q2 2025)\n- 🎯 Evil Portal deployment\n- 🎯 WPS vulnerability scanner\n- 🎯 Bluetooth device scanner\n- 🎯 Mesh network analysis\n\n### Phase 4: Professional Tools (Q3 2025)\n- 🎯 Custom packet crafting\n- 🎯 Protocol fuzzing\n- 🎯 MITM capabilities\n- 🎯 Network mapping visualization\n\n### Phase 5: Integration (Q4 2025)\n- 🎯 Cloud dashboard\n- 🎯 Multi-device coordination\n- 🎯 AI-powered threat detection\n- 🎯 Automated penetration testing\n\n---\n\n## 🤝 Contributing\n\n**We need YOUR help to make MCT2032 the ultimate pocket cyber tool!**\n\n### How You Can Help\n\n#### 🐍 Python Developers\n- Enhance the admin console UI\n- Add data visualization features\n- Implement export formats\n- Create automated testing scripts\n\n#### 🔧 C++ Developers\n- Implement BLE scanning\n- Optimize packet capture\n- Add new attack vectors\n- Improve memory management\n\n#### 🎨 UI/UX Designers\n- Create custom icons\n- Design new UI themes\n- Improve user workflows\n- Create animation effects\n\n#### 📚 Documentation Writers\n- Write tutorials\n- Create video guides\n- Translate documentation\n- Document API endpoints\n\n#### 🧪 Security Researchers\n- Test attack implementations\n- Find vulnerabilities\n- Suggest new features\n- Create PoC exploits\n\n### Getting Started\n1. Fork the repository\n2. Check our [Issues](https://github.com/webdevtodayjason/mct2032/issues) page\n3. Pick a task from the TODO list\n4. Create a feature branch\n5. Submit a Pull Request\n\n### Development Setup\n```bash\n# Clone the repo\ngit clone https://github.com/webdevtodayjason/mct2032.git\ncd mct2032\n\n# Set up firmware development\ncd mct2032-firmware\npio lib install\n\n# Set up admin console\ncd ../mct2032-admin\npython -m venv venv\nsource venv/bin/activate\npip install -r requirements.txt\n```\n\n---\n\n## 🚀 Quick Start\n\n### Option 1: Web Installer (Recommended)\n1. Visit [https://webdevtodayjason.github.io/mct2032/](https://webdevtodayjason.github.io/mct2032/)\n2. Connect your ESP32-S3 device via USB\n3. Click \"Install\" and follow the prompts\n4. Download and run the admin console\n\n### Option 2: Build from Source\n```bash\n# Clone the repository\ngit clone https://github.com/webdevtodayjason/mct2032.git\ncd mct2032\n\n# Build and upload firmware\ncd mct2032-firmware\npio run -t upload\n\n# Run admin console\ncd ../mct2032-admin\npython -m venv venv\nsource venv/bin/activate  # Windows: venv\\Scripts\\activate\npip install -r requirements.txt\npython main.py\n```\n\n## UI Design\n\n### ESP32 Display\n- **Background**: Deep dark blue (#0a0e27, #0f0f23)\n- **Border**: Purple gradient with glow effect (#8b5cf6)\n- **Status Text**: Terminal green (#00ff41)\n- **Mode Indicators**: Color-coded (Idle=Green, Scanning=Cyan, Attack=Red, etc.)\n- **Connection Status**: Visual indicator (Red=Disconnected, Green=Connected)\n\n### Admin Console\n- **Framework**: Python Tkinter with CustomTkinter\n- **Theme**: Dark hacker aesthetic matching the device\n- **Features**: \n  - Real-time WiFi network display with signal strength indicators\n  - Console log with timestamp\n  - Tabbed interface for different functions\n  - Stop scan functionality\n\n## Technical Details\n\n### Communication Protocol\n- **Transport**: Bluetooth LE with custom GATT service\n- **Chunking**: Automatic chunking for responses \u003e 512 bytes\n- **Format**: JSON-based command/response protocol\n- **Commands**: SCAN_WIFI, SCAN_BLE, GET_STATUS, and more\n\n### Security Features\n- **Passive Scanning**: Non-intrusive network discovery\n- **Channel Hopping**: Monitor multiple channels\n- **Packet Analysis**: Detailed frame type statistics\n- **Research Mode**: Advanced features for security testing\n\n## Development with Claude Code\n\nThis project is configured for Claude Code. See `CLAUDE.md` for detailed instructions.\n\n### Key Points:\n- Always update tasks in Dart before starting work\n- Use Context7 for latest documentation\n- Follow the dark hacker theme with purple gradients\n- Test with Playwright\n- Log all development activities\n\n## Project Structure\n```\nmct2032/\n├── mct2032-firmware/     # ESP32 firmware (PlatformIO)\n│   ├── include/          # Header files\n│   ├── src/              # Source files\n│   └── platformio.ini    # Build configuration\n├── mct2032-admin/        # Python admin console\n│   ├── mct2032_admin/    # Package source\n│   └── requirements.txt  # Python dependencies\n├── web-installer/        # Web-based firmware installer\n├── docs/                 # Additional documentation\n├── scripts/              # Build and release scripts\n├── .claude/              # Claude Code configuration\n└── logs/                 # Development logs\n```\n\n## Building from Source\n\n### Firmware\n```bash\ncd mct2032-firmware\npio run                    # Build\npio run -t upload          # Upload to device\npio device monitor         # Serial monitor\n```\n\n### Admin Console\n```bash\ncd mct2032-admin\npip install -r requirements.txt\npython main.py\n```\n\n## Contributing\n\n1. Check Dart for open tasks\n2. Follow the established code style\n3. Test all changes thoroughly\n4. Update documentation as needed\n\n---\n\n## 📸 Screenshots\n\n\u003cdiv align=\"center\"\u003e\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd align=\"center\"\u003e\n\u003cimg src=\"https://www.waveshare.com/media/catalog/product/e/s/esp32-s3-lcd-1.47-2.jpg\" width=\"200\" alt=\"Device Back\"\u003e\n\u003cbr\u003e\u003csub\u003e\u003cb\u003eCompact Design\u003c/b\u003e\u003c/sub\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\"\u003e\n\u003cimg src=\"docs/images/ui-scanning.png\" width=\"200\" alt=\"Scanning Mode\"\u003e\n\u003cbr\u003e\u003csub\u003e\u003cb\u003eScanning Mode\u003c/b\u003e\u003c/sub\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\"\u003e\n\u003cimg src=\"docs/images/admin-console.png\" width=\"300\" alt=\"Admin Console\"\u003e\n\u003cbr\u003e\u003csub\u003e\u003cb\u003eAdmin Console\u003c/b\u003e\u003c/sub\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\u003c/div\u003e\n\n---\n\n## 🏆 Why MCT2032?\n\n### Compared to Other Tools\n\n| Feature | MCT2032 | Flipper Zero | WiFi Pineapple | Proxmark3 |\n|---------|---------|--------------|----------------|-----------|\n| **Price** | $12.99 | $169 (+$29 for WiFi) | $99-$399 | $300+ |\n| **WiFi Attacks** | ✅ Native | ⚠️ With addon | ✅ Specialized | ❌ |\n| **Bluetooth** | ✅ BLE 5.0 | ✅ BLE | ❌ | ❌ |\n| **Display** | ✅ Color LCD | ✅ Monochrome | ❌ Web UI | ❌ |\n| **Sub-GHz Radio** | ❌ | ✅ | ❌ | ❌ |\n| **NFC/RFID** | ❌ | ✅ | ❌ | ✅ Specialized |\n| **Infrared** | ❌ | ✅ | ❌ | ❌ |\n| **Open Source** | ✅ | ✅ | ✅ | ✅ |\n| **Pocket Size** | ✅ (50mm) | ✅ | ⚠️ Varies | ✅ |\n| **Web Installer** | ✅ | ❌ | ❌ | ❌ |\n| **Battery** | USB-C Power | ✅ Built-in | ⚠️ Varies | USB Power |\n| **Target Users** | WiFi/BLE Research | Multi-Protocol | WiFi Pentesting | RFID Research |\n\n---\n\n## 🛠️ Technical Architecture\n\n```mermaid\ngraph TD\n    A[ESP32-S3] --\u003e|SPI| B[1.47\" LCD]\n    A --\u003e|WiFi| C[2.4GHz Networks]\n    A --\u003e|BLE| D[Admin Console]\n    A --\u003e|GPIO| E[RGB LED]\n    A --\u003e|SPI| F[SD Card]\n    D --\u003e|Python| G[Cross-Platform GUI]\n    C --\u003e|Scan| H[Network Data]\n    H --\u003e|JSON| D\n```\n\n---\n\n## 📚 Documentation\n\n- 📖 [Getting Started Guide](docs/GETTING_STARTED.md)\n- 🔧 [Hardware Setup](docs/HARDWARE_SETUP.md)\n- 💻 [API Reference](docs/API_REFERENCE.md)\n- 🎨 [UI Customization](docs/UI_CUSTOMIZATION.md)\n- 🔐 [Security Features](docs/SECURITY_FEATURES.md)\n- 📡 [Protocol Documentation](docs/PROTOCOL.md)\n\n---\n\n## 🌟 Community\n\n- 💬 [Discord Server](https://discord.gg/mct2032) *(Coming Soon)*\n- 🐦 [Twitter Updates](https://twitter.com/mct2032) *(Coming Soon)*\n- 📺 [YouTube Tutorials](https://youtube.com/@mct2032) *(Coming Soon)*\n- 📝 [Blog](https://mct2032.tech) *(Coming Soon)*\n\n---\n\n## 🙏 Acknowledgments\n\n- Inspired by [ESP32 Marauder](https://github.com/justcallmekoko/ESP32Marauder) and [Bruce](https://github.com/pr3y/Bruce)\n- Built with [ESP-IDF](https://github.com/espressif/esp-idf) and [PlatformIO](https://platformio.org/)\n- UI powered by [LVGL](https://lvgl.io/)\n- Admin console uses [CustomTkinter](https://github.com/TomSchimansky/CustomTkinter)\n\n---\n\n## ⚖️ Legal Disclaimer\n\n**IMPORTANT:** This tool is designed for legitimate security research and testing on networks you own or have explicit permission to test. \n\n- ⚠️ **Unauthorized network scanning or attacks are illegal**\n- ⚠️ **Users are responsible for complying with all applicable laws**\n- ⚠️ **We are not responsible for misuse of this tool**\n- ✅ **Only use on networks you own or have written permission to test**\n\n---\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n### Made with ❤️ by the MCT2032 Community\n\n[![Star History Chart](https://api.star-history.com/svg?repos=webdevtodayjason/mct2032\u0026type=Date)](https://star-history.com/#webdevtodayjason/mct2032\u0026Date)\n\n**If you find this project useful, please consider giving it a ⭐!**\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwebdevtodayjason%2Fmct2032","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwebdevtodayjason%2Fmct2032","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwebdevtodayjason%2Fmct2032/lists"}