NimBLE Projects

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.

A comprehensive development resource for the Seeed Studio XIAO ESP32 family, including the C3, S3, and C6 modules. It provides over thirty modular projects demonstrating hardware-specific features like LiPo battery monitoring, deep sleep optimization, and advanced wireless implementations such as BLE HID keyboards and WebSocket camera servers.

An ESP32-S3 based platform that enables MDB protocol communication for vending machine cashless payments and remote telemetry. It features support for EVA DTS DEX/DDCMP standards, Bluetooth connectivity via NimBLE, and integrated foot traffic analysis using a PAX counter.

AntiHunter is an open-source distributed perimeter defense system designed for wireless network security and operational awareness. Built on the ESP32-S3 platform using the Arduino framework and FreeRTOS, it creates a scalable mesh network of sensors for real-time WiFi/BLE threat detection, device mapping, and signal triangulation. The system integrates GPS, SD logging, and tamper-responsive data destruction to provide a robust digital tripwire for security professionals.

A smart home controller for roof windows that utilizes Matter over Thread on the Espressif ESP32-C6 platform. It combines environmental sensing via an AM2301 sensor with hardware control for window automation, integrating directly into ecosystems like Home Assistant through a Thread border router.

This project integrates the Zig programming language and toolchain with the Espressif IoT Development Framework (ESP-IDF), supporting both Xtensa and RISC-V architectures. It enables developers to leverage Zig's modern features like comptime and meta-programming while maintaining full compatibility with ESP-IDF's FreeRTOS-based ecosystem.

This project transforms an ESP32 into a bridge between wired USB peripherals and Bluetooth-enabled hosts. By combining software-defined USB host capabilities with the NimBLE stack, it allows standard USB keyboards and mice to function as wireless BLE devices across multiple operating systems.

An expansion module for the Portapack H4 and PortaRF that adds GPS, environmental sensors, and a web-based remote control interface. Built on the ESP-IDF framework with FreeRTOS, it integrates NimBLE Bluetooth and LwIP to provide features like signal geotagging, fox hunting assistance, and satellite tracking.

NimBLE OTA is a specialized library for ESP32 devices that enables firmware updates over Bluetooth Low Energy (BLE). It leverages the memory-efficient NimBLE stack to provide a robust OTA service, featuring secure authentication, progress tracking, and compatibility with both Python-based and web-based upload tools.

A Modbus to Matter adapter designed for the ESP32-C6 microcontroller. It enables Modbus-compatible devices, such as the Eastron SDM120M energy meter, to be exposed as Matter Electrical Sensor devices using the ESP-IDF framework and NimBLE Bluetooth stack.

A library for ESP32 that enables firmware and filesystem (SPIFFS/LittleFS) updates over Bluetooth Low Energy. It supports both BlueDroid and NimBLE stacks, offering features like data compression, secure RSA-based signature verification, and customizable callbacks for update monitoring.

A synchronization tool written in CPython and MicroPython for fetching FIT activity files from XOSS and Cycplus cyclo-computers via Bluetooth Low Energy (BLE). It implements the YMODEM protocol over the Nordic UART Service to provide an open-source alternative to proprietary mobile applications.

A full-stack open-source solution for smart aquarium LED control featuring ESP32-based hardware, ESP-IDF firmware, and a Flutter mobile application. It provides high-resolution PWM dimming, sunrise/sunset simulation, and efficient CoAP/CBOR communication for professional-grade lighting management.

VaktBLE is a security framework that acts as a benevolent Man-in-the-Middle bridge to protect BLE peripherals from malicious central devices. It utilizes non-compliant BLE firmware on nRF52840 hardware to validate link-layer packets in real-time, shielding targets like ESP32 from protocol-level attacks without requiring modifications to the target's firmware.

An ESP32-based firmware that extracts vehicle data via an ELM327 OBD2 adapter and transmits it to an MQTT broker over cellular networks. Designed for Home Assistant integration, it supports a wide range of LilyGO T-Call and Waveshare modules with integrated GSM/LTE and GPS capabilities.

A specialized security auditing and wireless monitoring firmware for ESP32 devices. Built on the ESP-IDF framework and FreeRTOS, it provides tools for BLE wardriving, WiFi deauthentication testing, and device detection for hardware like AirTags and Flipper Zero.

An ESPHome component designed to interface with Cosori smart kettles using Bluetooth Low Energy on ESP32 microcontrollers. It provides comprehensive control over heating states and temperature setpoints while exposing sensors for real-time water temperature and base status to Home Assistant.

An ESP32-S3 firmware for monitoring Victron SmartSolar chargers and battery monitors via Bluetooth. It decrypts BLE advertisements using AES-128 and displays real-time metrics on a 3.5-inch LCD using the LVGL library.

A comprehensive treadmill computer replacement based on the ESP32-S3 and ESPHome firmware. It implements the Fitness Machine Service (FTMS) protocol to enable direct Bluetooth connectivity with fitness apps like Zwift and Kinomap while controlling treadmill hardware via UART.