Metadata-Version: 2.4
Name: bthome-logger
Version: 0.0.5
Summary: BThome v2 BLE Advertisement Logger for debugging and monitoring BThome devices
Project-URL: Homepage, https://github.com/the78mole/bthome-examples
Project-URL: Repository, https://github.com/the78mole/bthome-examples
Project-URL: Issues, https://github.com/the78mole/bthome-examples/issues
Project-URL: Documentation, https://github.com/the78mole/bthome-examples/blob/main/tools/README.md
Author-email: Daniel Bader <mail@danielbader.de>
Maintainer-email: Daniel Bader <mail@danielbader.de>
License: MIT
License-File: LICENSE
Keywords: ble,bluetooth,bthome,home-assistant,iot
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Home Automation
Classifier: Topic :: System :: Monitoring
Requires-Python: >=3.8
Requires-Dist: bleak>=0.21.0
Requires-Dist: typer>=0.9.0
Description-Content-Type: text/markdown

# BThome Logger Tools

Dieses Verzeichnis enthält Tools zum Testen und Debuggen von BThome-Geräten.

## 🐍 Python BThome Logger

Ein zuverlässiges Python-Tool zum Scannen und Anzeigen von BThome v2 Advertisements.

### Installation

**Aus PyPI (empfohlen):**

```bash
# Systemweit installieren
pip install bthome-logger

# Oder mit pipx (isolierte Installation)
pipx install bthome-logger

# Tool ausführen
bthome-logger
```

**Mit uv (für Entwicklung):**

```bash
# uv installieren (falls noch nicht vorhanden)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Ins tools-Verzeichnis wechseln
cd tools

# Abhängigkeiten installieren und Tool ausführen
uv run bthome_logger.py
```

**Aus dem Repository:**

```bash
# Repository klonen
git clone https://github.com/the78mole/bthome-examples.git
cd bthome-examples/tools

# Mit pip
pip install -e .

# Mit uv
uv run bthome_logger.py
```

### Verwendung

```bash
# Wenn über PyPI/pipx installiert
bthome-logger

# Wenn lokal mit uv
uv run bthome_logger.py

# Wenn mit pip -e installiert
python -m bthome_logger
```

### Features

- ✅ Scannt nach BLE-Geräten mit "MAKE" im Namen
- ✅ Zeigt BThome v2 Company ID (0xFCD2) erkannt
- ✅ Dekodiert alle gängigen BThome Object IDs
- ✅ Farbige Terminal-Ausgabe für bessere Lesbarkeit
- ✅ Zeigt RSSI-Werte mit Farb-Codierung
- ✅ Echtzeit-Updates bei neuen Advertisements
- ✅ Unterstützt verschlüsselte und unverschlüsselte Pakete

### Ausgabe-Beispiel

```text
======================================================================
🔵 BThome Logger - Python Edition
Scannt nach BLE-Geräten mit BThome v2 Protocol
======================================================================

Filter: Geräte mit 'MAKE' im Namen
Drücke Ctrl+C zum Beenden

✓ Scanner gestartet...

----------------------------------------------------------------------
[14:32:45.123] 📱 MAKE-ESP32-S3-TS (XX:XX:XX:XX:XX:XX)
  RSSI: -65 dBm
  Raw: d2 fc 40 02 b6 10
  BThome: v2 (unverschlüsselt)
  Werte:
    • Temperatur: 42.78 °C
```

### Troubleshooting

**Problem:** `bleak` kann nicht installiert werden

**Lösung:** Stelle sicher, dass du Python 3.7+ verwendest:

**Problem:** Keine Bluetooth-Berechtigung

**Lösung (Linux):**

```bash
# Füge Benutzer zur bluetooth Gruppe hinzu
sudo usermod -a -G bluetooth $USER
```

Melde dich danach ab und wieder an oder führe `newgrp bluetooth` aus (wirkt nur für das aktuelle Terminal).
