gitwtfhub

wtf is chimerable?

matthewkukanich/chimerable — explained in plain English

Analysis updated 2026-05-18

166C++Audience · developerComplexity · 4/5Setup · moderate

TL;DR

ChimeraBLE is an ESP32-based tool for scanning, connecting to, cloning, and proxying Bluetooth Low Energy devices for security research.

Mindmap

mindmap
  root((ChimeraBLE))
    What it does
      Scan BLE devices
      Clone a device
      Proxy traffic
      Fingerprint devices
    Tech stack
      C++
      ESP32
      PlatformIO
      NimBLE
    Use cases
      Enumerate GATT tree
      Log MITM traffic
      Clone peripherals
      Locate devices
    Audience
      Security researchers
      Embedded developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Scan for nearby BLE devices and guess what unnamed ones are from their broadcast data.

REASON 2

Connect to a BLE device and enumerate all of its readable and writable characteristics.

REASON 3

Clone or emulate a BLE peripheral to see how another device reacts to it.

REASON 4

Sit between two devices as a proxy to log the BLE traffic passing between them.

What's in the stack?

C++ESP32PlatformIONimBLE

How it stacks up

matthewkukanich/chimerablehackman3d/hackman3d-orbit-controllerredteamfortress/phantomkiller
Stars166166170
LanguageC++C++C++
Setup difficultymoderatehardhard
Complexity4/53/54/5
Audiencedevelopergeneralresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 1h+

Requires one of the supported ESP32 boards plus the PlatformIO toolchain to build and flash the firmware.

Wtf does this do

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.

Yoink these prompts

Prompt 1
Walk me through building and flashing ChimeraBLE onto an ESP32 board with PlatformIO.
Prompt 2
Explain what commands I would use in ChimeraBLE to scan for nearby BLE devices and inspect one closely.
Prompt 3
How does ChimeraBLE guess what an unnamed BLE device is from its advertising data?
Prompt 4
Show me how ChimeraBLE's man-in-the-middle mode logs traffic between two BLE devices.

Frequently asked questions

wtf is chimerable?

ChimeraBLE is an ESP32-based tool for scanning, connecting to, cloning, and proxying Bluetooth Low Energy devices for security research.

What language is chimerable written in?

Mainly C++. The stack also includes C++, ESP32, PlatformIO.

How hard is chimerable to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is chimerable for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.