https://github.com/ztroop/btlescan

BTLE/Bluetooth Scanner
https://github.com/ztroop/btlescan

bluetooth bluetooth-low-energy scanner

Last synced: 18 days ago
JSON representation

BTLE/Bluetooth Scanner

• Host: GitHub
• URL: https://github.com/ztroop/btlescan
• Owner: ztroop
• License: mit
• Created: 2024-03-02T04:26:19.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2024-09-02T20:53:51.000Z (over 1 year ago)
• Last Synced: 2026-02-14T19:15:40.073Z (about 1 month ago)
• Topics: bluetooth, bluetooth-low-energy, scanner
• Language: Rust
• Homepage:
• Size: 2.7 MB
• Stars: 49
• Watchers: 2
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-ratatui - btlescan - Bluetooth Low Energy (BTLE) scanner and GATT viewer. (💻 Apps / 🚀 Productivity and Utilities)

README

          
[![Build](https://github.com/ztroop/btlescan/actions/workflows/build.yml/badge.svg)](https://github.com/ztroop/btlescan/actions/workflows/build.yml)

# btlescan

## Summary

This tool provides a cross-platform CLI with an interactive way to view Bluetooth Low Energy (BTLE) devices, showcasing their Address/UUID, Name, TX Power, and RSSI (Received Signal Strength Indicator) in a table format. It also provides functionality to inspect GATT information.

![demo](./assets/demo.png)

## Features

- Real-Time Discovery: Continuously scans for Bluetooth devices, updating the list in real-time as new devices appear or existing devices become unavailable.

- Device Information: Displays detailed information about each detected Bluetooth device, including:

    - **Address/UUID**: The unique address or UUID of the Bluetooth device.

    - **Name**: The name of the Bluetooth device, if available.

    - **TX Power**: The transmission power level, indicating the strength at which the device is broadcasting its signal.

    - **RSSI**: Received Signal Strength Indicator, a measure of the power present in the received signal, indicating how close or far the device is.

- Interactive UI: The terminal-based user interface allows users to scroll through the list of discovered devices, providing an easy way to browse and select devices of interest.

- Keyboard Navigation: Supports simple keyboard controls for navigation:

    - **Up/Down Arrows**: Scroll through the list of devices.

    - **Q**: Quit the application.

    - **S**: Toggle scanning.

    - **E**: Export CSV data to current directory.

    - **ENTER**: Open or close widget.

## Installation

```sh

git clone git@github.com:ztroop/btlescan.git && cd ./btlescan

cargo install --path .

```

### Arch Linux (AUR)

You can install `btlescan` from the [AUR](https://aur.archlinux.org/packages/btlescan) with using an [AUR helper](https://wiki.archlinux.org/title/AUR_helpers).

```shell

paru -S btlescan

```

## Alternatives

If you're looking to manage or pair Bluetooth devices, check out [bluetui](https://github.com/pythops/bluetui)!