Skip to content

Support for 0.91″ I²C OLED Displays with 5-Button Navigation #878

@sandulwarnasooriya

Description

@sandulwarnasooriya

Problem / Motivation:
The current ESP32 Marauder firmware is designed for SPI TFT displays and full-size boards. Users with small OLED displays (0.91″ SSD1306, I²C, 128×32) cannot use the graphical UI effectively. A compact version optimized for OLEDs and low-power setups would expand usability and portability.

Proposed Solution / Feature:

  • Create a dedicated “Marauder Mini” firmware variant for 0.91″ I²C OLEDs.

  • Full UI redesign for 128×32 resolution with scrollable menus and status indicators.

  • Support 5-button navigation (Up, Down, Left, Right, Select).

  • Maintain full functionality (Wi-Fi scanning, deauth, beacon spam, EAPOL sniffing) but adapted for small display constraints.

  • Include configuration options to easily switch between TFT SPI and OLED I²C.

Alternatives Considered:

  • Running headless / serial-only builds (loses graphical UI).

  • Using larger TFTs (less portable).

  • Manual porting of TFT graphics to small OLEDs (high maintenance).

Additional Context:

  • OLED: 0.91″ SSD1306, I²C, 128×32, typical ESP32 pins SDA=21, SCL=22.

  • 5-button navigation provides easy access to menus and functions on a small screen.

A “Marauder Mini” variant could become a lightweight, portable Marauder edition for compact builds or battery-powered deployments.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions