Skip to content

michelangelomo/marauder-ui

Repository files navigation

marauder-ui

Marauder Web Interface Screenshot

A modern web interface for the ESP32 Marauder firmware. This project provides a user-friendly way to interact with your Marauder device through a web browser.

🌐 Live Demo

This entire project, including the code and this README, has been written by Claude AI assistant.

Features

  • 🔌 Serial connection management
  • 📡 Real-time AP scanning and monitoring
  • 👥 Station detection and tracking
  • 📊 Dynamic AP and station list with sorting and filtering
  • 🖥️ Interactive terminal output
  • 🎨 Modern neobrutalist design
  • 📱 Responsive layout
  • ⌨️ Command history
  • 🔍 Advanced filtering and sorting options

Technical Details

  • Built with Vue 3 and Tailwind CSS
  • Uses Web Serial API for device communication
  • Reactive state management
  • Real-time data processing
  • Modular component architecture

Requirements

  • A browser supporting the Web Serial API (Chrome, Edge)
  • An ESP32 device running the Marauder firmware

Development

  1. Clone the repository:
git clone https://github.com/yourusername/marauder-ui.git
cd marauder-ui
  1. Install dependencies:
npm install
  1. Run development server:
npm run dev
  1. Build for production:
npm run build

Usage

  1. Connect your Marauder device to your computer
  2. Open the web interface
  3. Click "Connect" and select your device from the serial port list
  4. Use the command builder or enter custom commands
  5. Monitor results in the AP list and terminal output

Commands

The interface supports all Marauder commands, including:

  • scanap - Scan for access points
  • scansta - Scan for stations
  • stopscan - Stop any ongoing scan
  • list -a - List detected access points
  • sniffbeacon - Sniff beacon frames
  • sniffdeauth - Sniff deauth frames
  • sniffpmkid - Sniff PMKID
  • And many more...

Features

Access Point Monitoring

  • Real-time AP detection
  • Signal strength indicators
  • Channel information
  • Connected stations tracking
  • Last seen timestamps

Station Tracking

  • Station-AP relationships
  • MAC address display
  • Station IDs
  • Last seen information

Interface Features

  • Command history
  • Terminal output
  • Compact and detailed views
  • Search and filter capabilities
  • Sorting options

Contributing

Feel free to submit issues and enhancement requests!

Credits

License

This project is licensed under the MIT License - see the LICENSE file for details.