matthewkukanich/chimerable — explained in plain English
Analysis updated 2026-05-18
Scan for nearby BLE devices and guess what unnamed ones are from their broadcast data.
Connect to a BLE device and enumerate all of its readable and writable characteristics.
Clone or emulate a BLE peripheral to see how another device reacts to it.
Sit between two devices as a proxy to log the BLE traffic passing between them.
| matthewkukanich/chimerable | hackman3d/hackman3d-orbit-controller | redteamfortress/phantomkiller | |
|---|---|---|---|
| Stars | 166 | 166 | 170 |
| Language | C++ | C++ | C++ |
| Setup difficulty | moderate | hard | hard |
| Complexity | 4/5 | 3/5 | 4/5 |
| Audience | developer | general | researcher |
Figures from each repo's GitHub metadata at analysis time.
Requires one of the supported ESP32 boards plus the PlatformIO toolchain to build and flash the firmware.
ChimeraBLE is a tool for exploring and testing Bluetooth Low Energy, or BLE, devices using an ESP32 microcontroller board. It can act in three roles at once. It can scan and connect to nearby BLE devices the way a phone would, it can pretend to be a BLE device itself so it can copy or imitate one, and it can sit between a real device and whatever it normally talks to, watching and recording the traffic that passes between them. Once connected to a device, ChimeraBLE can list every feature the device exposes, read and write its data, and listen for updates as they arrive. It can also decode information broadcast by nearby devices without even connecting to them, and it will often guess what a device is, such as a fitness tracker, a pair of headphones, or a smart appliance, based on patterns in the signals it gives off. It can read keyboard and remote control style devices and work out which buttons are being pressed. A direction finding mode lets someone walk around with the board and watch a signal strength indicator grow stronger while approaching a device, which helps with physically locating it. The project runs on a handful of small hardware boards, including one with its own screen and keyboard so it can be used on its own, and others that are controlled by typing commands over a serial connection from a computer. Getting it running involves building and flashing the firmware with a tool called PlatformIO, then typing commands to scan, connect to, and inspect devices. Because it can copy other devices, intercept their traffic, and pretend to be them, the project states plainly that it should only be used on devices someone owns or has clear permission to test, and that whoever uses it is responsible for following the laws that apply where they are.
ChimeraBLE is an ESP32-based tool for scanning, connecting to, cloning, and proxying Bluetooth Low Energy devices for security research.
Mainly C++. The stack also includes C++, ESP32, PlatformIO.
Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.
Mainly developer.
This repo across BitVibe Labs
Don't trust strangers blindly. Verify against the repo.