Bluetooth Debugging Tool

Professional tool for developers to debug and test Bluetooth devices. Intuitive web interface with terminal command support.

GitHub Repository Docker Hub

Key Features

BLE Interaction

Read and write data to BLE devices, subscribe to notifications in real-time.

Web UI

Intuitive web interface for simple interaction with BLE devices without CLI.

Web Terminal

Advanced commands for users who prefer command-line interface.

Device Sharing

Connected BLE device is mirrored on all web clients across the network.

Web Server

Access from any device on the network at the host's IP address.

Docker Support

Easy deployment in containers with support for Linux, macOS, and Windows.

Advanced Capabilities

  • Terminal Commands: subscribe, unsubscribe, read, write, clear, delete
  • Configuration: Switchable Bluetooth adapters and log levels
  • Tested Platforms: macOS, Linux (Fedora, Debian), Windows 11
  • Easy Deployment: npm run dev/build/start
  • Docker Optimization: Pre-built images available on Docker Hub
$ npm run dev
▲ Next.js 16.2.6 (Turbopack)
➜ Local: http://localhost:6767
➜ Network: http://0.0.0.0:6767
✓ Ready in 293 ms
[NapicuServer] - Starting...
[NapicuServer] - BLE adapter powered on.
[NapicuServer] - New client connected.
[NapicuServer] - Restarting BLE.
[NapicuServer] - Starting BLE scan...
[NapicuServer] - Successfully connected to: ESP32
[NapicuServer] - Stopping BLE scan...
[NapicuServer] - Discovering all services and characteristics...

Supported Platforms

macOS 26.5

✓ Tested

Fedora 44

✓ Tested

Debian 13

✓ Recommended

Windows 11

✓ Tested

NapicuBLEHub Subscribe Feature

Subscription Management

Technology Stack

Next.js

Modern React framework for fast performance

TypeScript

Type-safe JavaScript for better code quality

@abandonware/noble

BLE library for Node.js

Docker

Containerization for easy deployment