https://github.com/boshyxd/rssicheck
Simple python tool for scanning and classifying the RSSI signal strengths of nearby Bluetooth devices using the Bleak library.
https://github.com/boshyxd/rssicheck
bluetooth network-performance-test python real-time-analytics rssi
Last synced: 2 months ago
JSON representation
Simple python tool for scanning and classifying the RSSI signal strengths of nearby Bluetooth devices using the Bleak library.
- Host: GitHub
- URL: https://github.com/boshyxd/rssicheck
- Owner: boshyxd
- Created: 2024-06-10T19:41:16.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-08-23T04:58:31.000Z (10 months ago)
- Last Synced: 2025-04-15T03:39:38.989Z (2 months ago)
- Topics: bluetooth, network-performance-test, python, real-time-analytics, rssi
- Language: Python
- Homepage:
- Size: 3.91 KB
- Stars: 3
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# RSSICheck 📡
RSSICheck is a Python-based tool that leverages the `Bleak` library to scan and classify the signal strengths (RSSI) of nearby Bluetooth devices. This script provides a detailed analysis of each detected device's signal quality, helping users to understand the strength and reliability of their Bluetooth connections.
[Features](#-features) •
[Requirements](#-requirements) •
[Installation](#-installation) •
[Usage](#-usage) •
[Example Output](#-example-output) •
[License](#-license)
## 🌟 Features
- Real-time Bluetooth Scanning: Continuously scans for Bluetooth devices within range.
- RSSI Classification: Classifies signal strength into categories: Excellent, Good, Fair, Weak, Very Weak, and Unusable.
- Detailed Output: Displays the device name, address, RSSI value, and signal quality in real-time.
- Summary Report: Provides a summary of all detected devices and their signal qualities after the scan.
## 🛠️ Requirements
- Python 3.7+
- Bleak library
## 📥 Installation
1. Clone the repository:
```sh
git clone https://github.com/boshyxd/RSSICheck.git
cd RSSICheck
```
2. Install the required dependencies:
```sh
pip install bleak
```
## 🚀 Usage
Run the script to start scanning for Bluetooth devices:
```sh
python RSSICheck.py
```
The script will scan for 10 seconds and output the RSSI and signal quality of each detected device.
## 📊 Example Output
```bash
Scanning for Bluetooth devices...
Device: Unknown, Address: 00:1A:7D:DA:71:13, RSSI: -55 dBm, Signal Quality: Good
Device: Bluetooth Speaker, Address: 24:62:AB:F2:4D:7E, RSSI: -67 dBm, Signal Quality: Fair
Summary of detected devices:
Address: 00:1A:7D:DA:71:13, RSSI: -55 dBm, Signal Quality: Good
Address: 24:62:AB:F2:4D:7E, RSSI: -67 dBm, Signal Quality: Fair
```
## 📄 License
This project is licensed under the MIT License.
---
Made with ❤️ by [boshyxd](https://github.com/boshyxd)