NimBLE Projects

HijelHID_BLEMouse is an ESP32 Bluetooth Low Energy (BLE) Human Interface Device (HID) mouse library built on NimBLE-Arduino. It provides both an interrupt-safe base layer for hardware sensor integration and a high-level macro layer for scripted automation and emulation. The library targets ESP32 microcontrollers with BLE radio support across Windows, macOS, Linux, Android, and iOS platforms.

Vibe Watch is a wearable, tactile control surface for parallel AI-assisted coding built on the M5Stack StopWatch. Powered by an ESP32-S3, it leverages a 466 × 466 round touchscreen, tactile buttons, sound, and haptics alongside Bluetooth Low Energy to monitor up to six AI agent sessions and provide instant physical approval and voice controls.

An advanced ESP32-S3-based e-book reader featuring a 2.7-inch E-ink display and a custom-built UI framework. It integrates Wi-Fi/BLE connectivity, audio playback via the ES8311 codec, and a diverse application ecosystem including a reader, notepad, and file manager.

Slave I is a wireless research firmware for the M5Stack Tab5, utilizing a dual-chip architecture with the ESP32-P4 and ESP32-C6. It provides a toolkit for Wi-Fi, BLE, and 802.15.4 protocol analysis, built on FreeRTOS and featuring a sophisticated LVGL-based touch interface.

Midad is an open-source firmware for Xteink e-ink devices, specifically engineered for Arabic script and right-to-left languages. Running on the ESP32-C3 platform with FreeRTOS, it provides a comprehensive e-reading experience with advanced text shaping, OTA updates, and a unique suite of integrated applications like a gym logger and Tasbih counter.

CyberKey is a biometric TOTP authenticator built for the M5StickC Plus 2 (ESP32) that types 2FA codes over Bluetooth. By combining a fingerprint sensor with encrypted storage and BLE HID emulation, it provides a seamless and secure way to enter one-time passwords without a phone or manual copy-pasting.

A high-performance microphone solution for the M5StickS3, featuring Rust-based firmware and companion applications for macOS and iOS. It supports both plug-and-play USB Audio Class functionality and wireless streaming via WebSockets or Bluetooth LE, utilizing the ESP32-S3 and an ES8311 audio codec.

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.