Welcome to my comprehensive collection of ESP32 projects, modules, and learning resources! This repository serves as a one-stop destination for ESP32 enthusiasts, makers, and developers looking to explore the full potential of this powerful microcontroller.
This library is designed to be a growing collection of practical, well-documented ESP32 projects that you can clone, learn from, and build upon. Whether you're just starting with ESP32 development or looking for advanced project examples, you'll find something valuable here.
- OLED Display Integration - Various display libraries and techniques
- Keypad Matrix Systems - Different keypad configurations and debouncing
- MicroSD Card Modules - File system operations and data logging
- Sensor Combinations - Multiple sensors working together
- Communication Protocols - I2C, SPI, UART examples
- WiFi & Bluetooth - Wireless communication projects
- PhantomFox.MkI - Advanced penetration testing device
- FileExplorer - SD card file browser with OLED and keypad
- Step-by-step tutorials for each component
- Wiring diagrams and schematics
- Code documentation and explanations
- Troubleshooting guides
- Best practices and optimization tips
ESP32-Projects/
├── PhantomFox.MkI/ # Penetration testing device
│ ├── README.md # Complete project documentation
│ ├── CHANGELOG.md # Project version history
│ ├── phantomFoxMkIV1.ino # Version 1.2.0
│ ├── phantomFoxMkIV2.ino # Version 2.1.0
│ └── phantomFoxMkIV3.ino # Version 2.3.0 (Latest)
├── FileExplorer/ # SD card file browser
│ ├── README.md # Project documentation
│ └── FileExplorer.ino # Arduino sketch
├── README.md # Main library documentation
└── CHANGELOG.md # Repository changelog
Status: ✅ Complete & Active Development
A sophisticated penetration testing device featuring:
- OLED display with intuitive menu system
- WiFi scanning and network analysis
- Evil Twin attacks and credential harvesting
- Handshake capture capabilities
- File system for data storage
- Portable, battery-powered design
Status: ✅ Complete
A simple SD card file browser featuring:
- OLED display interface
- 2x2 keypad navigation
- File listing and viewing
- Text file content display
- Basic file system operations
- Arduino IDE with ESP32 board support
- ESP32 Development Board (any variant)
- Basic Electronic Components (breadboard, jumper wires, etc.)
- Enthusiasm for Learning! 🎉
-
Clone this repository
git clone https://github.com/supunhg/ESP32-Projects.git cd ESP32-Projects -
Install Arduino IDE ESP32 Support
- Add ESP32 board manager URL in Arduino IDE preferences
- Install ESP32 board package
-
Choose a Project
- Browse the project folders
- Read the individual README files
- Follow the specific setup instructions
-
Start Building!
- Gather required components
- Follow the wiring diagrams
- Upload the code and experiment
- SSD1306 OLED (128x64, 128x32)
- TFT LCD displays
- E-paper displays
- LED matrix displays
- Matrix keypads (2x2, 3x4, 4x4)
- Rotary encoders
- Touch sensors
- Button arrays
- MicroSD card modules
- EEPROM integration
- Flash memory management
- Cloud storage connectivity
- WiFi connectivity examples
- Bluetooth Classic & BLE
- LoRa long-range communication
- Ethernet integration
- Battery monitoring
- Solar charging systems
- Low-power sleep modes
- Power optimization techniques
- Basic ESP32 Setup - LED blinking, serial communication
- Digital I/O - Buttons, switches, basic sensors
- Analog Reading - Potentiometers, basic analog sensors
- Display Output - Simple OLED text display
- Module Integration - Combining multiple components
- WiFi Basics - Network scanning, simple web server
- Data Storage - SD card file operations
- User Interface - Menu systems, keypad input
- Network Security - Penetration testing tools
- Real-time Systems - Time-critical applications
- IoT Integration - Cloud connectivity, MQTT
- Custom PCB Design - From breadboard to production
I welcome contributions from the community! Here's how you can help:
- Found an issue? Open a GitHub issue with detailed information
- Include error messages, hardware setup, and steps to reproduce
- Have an idea for a new project or improvement?
- Check existing issues first, then create a new feature request
- Fork the repository
- Create a feature branch for your changes
- Submit a pull request with clear documentation
- Improve existing documentation
- Add tutorials or guides
- Share your own project builds
- Test projects on different ESP32 variants
- Report compatibility issues
- Verify hardware configurations
- ⭐ Star this repository for updates
- 👀 Watch for new project releases
- 🍴 Fork to create your own variants
- 📖 Check project-specific README files
- 🐛 Open GitHub issues for problems
- 💡 Join discussions in GitHub Discussions
- 📧 Contact for collaboration opportunities
Built something amazing using these projects? I'd love to see it!
- Share photos of your builds
- Submit your improvements
- Inspire others with your creativity
Educational Purpose: These projects are designed for learning, experimentation, and authorized testing only. Users are responsible for compliance with local laws and regulations, especially regarding security-related projects.
Hardware Safety: Always follow proper safety procedures when working with electronics. Double-check wiring before powering on projects.
Browse the projects, pick something that interests you, and start building! Remember, the best way to learn is by doing.
Happy Making! ⚡🛠️
Repository maintained by Supun Hewagamage - Last updated: July 2025