How kuleuven-cosic/whisperpair works
WhisperPair is a Fast Pair security-testing harness: an operator selects a nearby device, configures and runs protocol or pairing attacks, and reviews progress and results. The web UI controls a Linux/BlueZ server over the network. The server discovers and manages devices, performs Fast Pair operations, and uses RFCOMM for Audio Switch messaging; model metadata is resolved through Google’s service and cached locally. The graph reflects documented capabilities, but several UI routes and server handlers were not sampled, so those connections are omitted or marked unverified.
Main entry points: index.ts HTTP and socket API · fast-pair-service.ts Fast Pair operations · device-manager.ts Device manager · session.ts RFCOMM session
Components 23
Web interface
- Device dashboard
toolkit-ui/src/app/page.tsx - Device view
toolkit-ui/src/components/device.tsx - Attack controls
toolkit-ui/src/components/attack.tsx - Set model ID
toolkit-ui/src/components/set-model-id.tsx - Task status
toolkit-ui/src/components/task-controller.tsx - Device details
toolkit-ui/src/components/device-details.tsx - Service view
toolkit-ui/src/components/services.tsx - UI primitives
toolkit-ui/src/components/ui
Server control
- HTTP and socket API
toolkit-server/src/index.ts - Task execution
toolkit-server/src/task.ts
Bluetooth and protocol
- Device manager
toolkit-server/src/device-manager.ts - Device lookup map
toolkit-server/src/device-map.ts - Fast Pair operations
toolkit-server/src/fast-pair-service.ts - Pairing protocol
toolkit-server/src/protocol.ts - RFCOMM parser
toolkit-server/src/message-stream/parser.ts - RFCOMM session
toolkit-server/src/message-stream/session.ts - RFCOMM transport
toolkit-server/src/message-stream/rfcomm.ts - Bluetooth control
toolkit-server/src/bluetoothctl.ts
Device metadata
- Model ID resolver
toolkit-server/src/model-id-resolver/index.ts - Local metadata cache
toolkit-server/src/cache.ts
Other components
- Researcher
- Google device service
- Bluetooth device
Connections 30
- Researcher → Device dashboard: uses
README.md - Device dashboard → Device view: presents
- Device view → Device details: shows details
- Device view → Service view: shows services
toolkit-ui/src/components/services.tsx - Device dashboard → Attack controls: offers testing
- Attack controls → HTTP and socket API: requests attacks
README.md - Set model ID → HTTP and socket API: sets model ID
- Task status → HTTP and socket API: emits cancel
toolkit-ui/src/components/task-controller.tsx - UI primitives → Attack controls: renders controls
toolkit-ui/src/components/attack.tsx - UI primitives → Task status: renders status
toolkit-ui/src/components/task-controller.tsx - UI primitives → Service view: renders view
toolkit-ui/src/components/services.tsx - HTTP and socket API → Device dashboard: serves control data
README.md - HTTP and socket API → Device manager: queries devices
toolkit-server/src/index.ts - HTTP and socket API → Model ID resolver: resolves model data
toolkit-server/src/index.ts - HTTP and socket API → Task execution: runs tasks
toolkit-server/src/index.ts - HTTP and socket API → Device manager: forwards events
toolkit-server/src/index.ts - Device manager → Device lookup map: tracks devices
toolkit-server/src/device-manager.ts - Device manager → Fast Pair operations: creates service
toolkit-server/src/device-manager.ts - Device manager → Bluetooth device: discovers device
README.md - Fast Pair operations → Pairing protocol: builds messages
toolkit-server/src/fast-pair-service.ts - Fast Pair operations → Model ID resolver: fetches device data
toolkit-server/src/fast-pair-service.ts - Fast Pair operations → RFCOMM session: uses session
toolkit-server/src/fast-pair-service.ts - Fast Pair operations → Bluetooth control: controls pairing
toolkit-server/src/fast-pair-service.ts - RFCOMM session → RFCOMM transport: opens channel
toolkit-server/src/message-stream/session.ts - RFCOMM session → RFCOMM parser: parses stream
toolkit-server/src/message-stream/session.ts - RFCOMM session → Bluetooth device: sends messages
toolkit-server/src/message-stream/session.ts - Model ID resolver → Local metadata cache: reads and writes
toolkit-server/src/model-id-resolver/index.ts - Model ID resolver → Google device service: fetches metadata
toolkit-server/src/model-id-resolver/index.ts - Pairing protocol → Bluetooth device: tests protocol
README.md - Fast Pair operations → Bluetooth device: runs attacks
README.md