NimBLE Projects

FlightPortrait is an open-source firmware for an ESP32-S3-powered 13.3" color e-ink frame that visualizes local aviation traffic. Built using the ESP-IDF framework, it leverages FreeRTOS and NimBLE to provide a secure, low-power display solution that retrieves images via HTTPS. The project emphasizes a "simple by design" approach, featuring a robust state machine for provisioning, polling, and deep sleep cycles to maximize battery life.

GeoShake is an open-source firmware and hardware project for a distributed, real-time earthquake monitoring station based on the ESP32-S3. It utilizes high-precision accelerometers and on-device seismic processing to contribute to a global seismic network via MQTT and BLE connectivity.

An embedded desk display project using the Waveshare ESP32-S3-Touch-AMOLED-2.16 to track live Claude Code usage, local weather, and background agent health. The system leverages the LVGL graphics library for its UI and connects to a host computer via Bluetooth LE using the NimBLE stack.

Purplx is a comprehensive cyberdeck operating system designed for the M5Stack Cardputer ADV (ESP32-S3). It features a wide array of tools including a WiFi CSI human-presence radar, a firmware launcher for booting guest binaries, off-grid survival guides, and a collection of retro games. The project utilizes FreeRTOS and the NimBLE stack on the ESP32-S3 platform to provide a multi-functional cyberpunk utility environment.

NucleoOS is a web-native operating system designed for the M5Stack Cardputer (ESP32-S3), featuring both a native firmware UI and a desktop-class web shell. Built on the ESP-IDF framework and FreeRTOS, it optimizes constrained hardware (512 KB RAM) by offloading heavy tasks like AI and image generation to the browser via WebAssembly and WebGPU. The system includes a wide array of applications ranging from offline AI assistants and media players to a suite of security-testing tools.

WaveSight is an ESP32-based radar system that utilizes Wi-Fi Channel State Information (CSI) to detect human presence and movement without the need for cameras or PIR sensors. Built on the ESP-IDF framework and FreeRTOS, it features a real-time web dashboard for signal visualization, auto-calibration routines, and GPIO outputs for integration with external hardware.

A Game Boy emulator and monster-battling RPG implemented as a Meshtastic module for the LilyGO T-Deck. It features a deterministic Gen-1 battle engine, a mesh-wide daycare system with save-file XP patching, and LoRa-based multiplayer battles, all running alongside standard mesh networking.

NRSuite is a modular wireless research toolkit that offloads the radio layer to an ESP32 connected via USB OTG to an unrooted Android device. It enables advanced Wi-Fi operations, BLE HID emulation, and BadUSB functionality within the Termux environment using a custom binary bridge protocol.

A specialized fork of Espressif's ESP-Hosted-MCU that unlocks low-level radio capabilities typically hidden by stock firmware, including 802.11p, CSI sensing, and FTM ranging. It operates as a wireless co-processor firmware for ESP32 chips, communicating with host MCUs over SDIO using FreeRTOS, lwIP, and NimBLE.

A secondary e-ink desk display designed for AI Agents like Claude Code and Codex, utilizing the M5Paper V1.1 hardware. The project features a Python-based daemon for server-side rendering and an ESP32 firmware that supports Wi-Fi, BLE, and USB communication.

A high-performance bare-metal Arduino core for Nordic's next-generation nRF54L series, bypassing the overhead of Zephyr and the nRF Connect SDK. It provides direct hardware access to the Cortex-M33 and RISC-V coprocessor, supporting BLE, Thread, Zigbee, and Matter with minimal binary footprints.

A transparent UART-to-BLE cable replacement for the ESP32-C6 that implements the Nordic UART Service (NUS). It is specifically optimized for high throughput using BLE 5 features like LE 2M PHY, Data Length Extension (DLE), and credit-based flow control.

A minimal bare-metal SDK for Espressif RISC-V microcontrollers, specifically the ESP32-C6 and ESP32-P4, designed to operate independently of the ESP-IDF framework. It provides low-level hardware access through direct register-level programming, custom startup code, and linker scripts while integrating the lwIP and NimBLE stacks for networking and Bluetooth functionality.

A passive RF scanner for the M5Cardputer ADV that detects Flock Safety ALPR cameras and Raven surveillance devices. It utilizes WiFi promiscuous mode and BLE scanning on the ESP32-S3, running entirely locally without cloud connectivity. Detections are logged to an SD card with GPS coordinates and signal strength visualizations.

CrumBLE is an advanced e-reader firmware for the Xteink X4 and X3, built on the ESP32-C3 platform using the Arduino framework and NimBLE. It provides enhanced Bluetooth Low Energy (BLE) remote support, a customizable collections system, and optimized e-ink rendering through specialized image pre-caching.

DeskPet is a pixel-art companion for the M5Stack Cardputer that synchronizes with Claude Code sessions via Bluetooth Low Energy. Built on the ESP32-S3 using the Arduino framework and NimBLE, it provides real-time visual feedback on AI agent states, including task progress, token usage, and permission approvals directly from the device's keyboard.

AirMouseS3 is an ESP32-S3 based gesture-controlled mouse that uses an onboard gyroscope and accelerometer to translate physical movement into cursor actions. Designed for the M5Stack StickS3, it utilizes the NimBLE library for Bluetooth HID connectivity and the M5Unified framework for hardware management.

A single-button wireless keyboard built on the ESP32-C5 that translates Morse code patterns into HID keystrokes over Bluetooth Low Energy. It features a real-time LVGL UI on a tiny 0.85-inch display and implements secure BLE bonding using the NimBLE stack.

ESP32 Bit Pirate is an open-source firmware that transforms ESP32-S3 development boards into multi-protocol hardware hacking tools. It provides extensive support for digital protocols like I2C, SPI, and UART, as well as radio communications including Wi-Fi, Bluetooth, and Sub-GHz, utilizing FreeRTOS and LittleFS for robust device interaction.

Bluehound is a comprehensive BLE reconnaissance and anomaly detection framework designed for real-time device discovery and environment analysis. It combines a Python-based Linux backend with ESP32-powered hardware components to monitor signal stability, detect RF interference, and visualize Bluetooth activity.

Clawdmeter is an ESP32-S3-powered desk dashboard that monitors Claude Code token usage and displays it on a 2.16" AMOLED screen. It uses the LVGL library for its high-resolution UI and the NimBLE stack to communicate with a host daemon via BLE, while also functioning as a HID keyboard for shortcuts. The project features dynamic pixel-art animations that react to real-time API utilization rates.

A standalone ESP32-S3 firmware project for a custom round external controller for La Marzocco espresso machines. It utilizes the ESP-IDF framework, FreeRTOS, and the LVGL graphics library to provide an on-device UI, BLE/cloud connectivity, and a local setup portal for managing machine settings and recipes.

The Tick is an ESP32-C3-based covert access control implant designed to intercept, log, and replay credentials across Wiegand, Magstripe Clock&Data, and OSDP protocols. It features a robust hardware design with integrated level shifting and a high-efficiency DC-DC converter, supported by a modular software stack utilizing NimBLE for Bluetooth and a custom HTTP interface for remote management.

DeskPet is a pixel-art companion for the M5Stack Cardputer that synchronizes with Claude Code sessions via Bluetooth Low Energy (BLE). Built on the ESP32-S3 using the NimBLE stack and ArduinoJson, it provides real-time visual feedback and hardware-based command approval for AI agent workflows.

GhostBLE is a portable BLE privacy scanner and wardriving application designed for the M5Stack ecosystem, including the Cardputer and StickC series. Leveraging the NimBLE-Arduino library on the ESP32 platform, it provides real-time analysis of Bluetooth Low Energy devices, privacy posture heuristics, and GPS-tagged logging for security research and education.

A keyboard-focused pentesting firmware for the M5Stack Cardputer-Adv (ESP32-S3) offering over 90 features across WiFi, BLE, sub-GHz, and LoRa. It utilizes FreeRTOS and the NimBLE stack to coordinate complex wireless attacks, including 5 GHz deauthentication and Zigbee sniffing via a companion ESP32-C5 node.

A high-performance serial communication hub for ESP32 and ESP32-S3 microcontrollers that bridges UART data to USB, WiFi, and Bluetooth. It features protocol-aware optimizations for MAVLink, SBUS, and CRSF, and includes a comprehensive web-based configuration interface.

Zhilly is an AI-powered portable cybersecurity tool for ESP32-S3 devices, enabling voice-controlled pentesting, RF/IR signal manipulation, and HID emulation. Built on the ESP-IDF framework, it utilizes FreeRTOS, LVGL, and NimBLE to provide a sophisticated, hands-free interaction model for security researchers.

UniGeek is a comprehensive multi-tool firmware for ESP32-based handheld devices, offering a suite of tools for WiFi security, Bluetooth analysis, and hardware module interfacing. Built on the Arduino framework and FreeRTOS, it supports a wide variety of hardware including M5Stack, LilyGO, and custom DIY builds.

ESP-HACK is a versatile wireless research and pentesting firmware for the ESP32 platform, targeting Sub-GHz, Bluetooth, and Infrared protocols. It utilizes the Arduino framework and NimBLE stack to provide tools for signal analysis, protocol exploration, and GPIO integrations. The project is designed for use with custom hardware including CC1101 transceivers and OLED displays.

TNY-360 is an open-source, 12-DOF quadruped robot designed for research and interaction, powered by the ESP32-S3 microcontroller. It utilizes the ESP-IDF framework and FreeRTOS to manage complex tasks like inverse kinematics, computer vision via an OV2640 camera, and human-robot interaction. The project features a fully 3D-printable chassis and integrated sensors including Lidar, IMU, and I2S audio.

A comprehensive Bluetooth Low Energy (BLE) HID keyboard library for the ESP32, built on the NimBLE-Arduino stack for high efficiency. It supports standard keyboard layouts, media keys, and advanced power management features including light and deep sleep. The library is designed for creating physical or emulated HID devices compatible with iOS, Android, macOS, Windows, and Linux.

This project enables ESP32 microcontrollers to manage Tesla vehicle charging and monitor telemetry over Bluetooth Low Energy using the ESPHome framework. It supports key pairing, charging current adjustment, and vehicle wake management while utilizing FreeRTOS for task handling on the ESP32 platform.

This project provides an ESPHome configuration to transform M5Stack AtomS3 Lite or NanoC6 devices into Bluetooth proxies for Home Assistant. It enables centralized management and extended range for Bluetooth Low Energy devices by leveraging ESP32-based hardware as network gateways.

A real-time firmware for ESP32-S3 based HUB75 LED matrix displays, specifically designed for Protogen masks. It features sensor-driven interactions using proximity, accelerometer, and microphone inputs, alongside Bluetooth LE control and OTA updates via the NimBLE stack.

A library for ESP32 Arduino that implements the Nordic UART Service (NUS) to provide a HardwareSerial-compatible BLE interface. It supports both the standard ESP32 BLE stack and the memory-efficient NimBLE-Arduino library, while offering optional integration with the Embedded Template Library (ETL) for deterministic memory management.