its-consulting/Homeassistant
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Code von github.com/Kenearos/Homeassistant
8 commits 2 branches 0 tags 68 KiB
Find a file
Exact
Kenearos b4ac82a071
Merge pull request #3 from Kenearos/claude/webapp-read-export-01DLVoNur7gtj8ZWXxdo78Uz 
Build webapp to read and export data
2025-12-13 14:55:07 +01:00
templates Add Claude-friendly export format for Home Assistant data 2025-12-13 13:31:19 +00:00
.gitignore Add web-based GUI with frontend and backend 2025-11-17 20:14:28 +00:00
ANLEITUNG.md Add web-based GUI with frontend and backend 2025-11-17 20:14:28 +00:00
app.py Add Claude-friendly export format for Home Assistant data 2025-12-13 13:31:19 +00:00
ha-overview.py Add Home Assistant overview tool 2025-11-17 21:03:23 +01:00
ha_overview.py Add web-based GUI with frontend and backend 2025-11-17 20:14:28 +00:00
README.md Add web-based GUI with frontend and backend 2025-11-17 20:14:28 +00:00
requirements.txt Add web-based GUI with frontend and backend 2025-11-17 20:14:28 +00:00

README.md

Home Assistant Overview Tool

Ein webbasiertes Tool mit Frontend und Backend zur Erstellung einer vollständigen Übersicht über Ihre Home Assistant Installation.

🌟 Features

  • 🌐 Web-GUI - Moderne, benutzerfreundliche Weboberfläche
  • 📖 Integrierte Anleitung - Schritt-für-Schritt Anweisungen direkt im Frontend
  • 🔄 Echtzeit-Verbindungstest - Testen Sie Ihre Verbindung vor der Berichtserstellung
  • 💾 Konfigurationsspeicherung - Speichern Sie URL und Token für spätere Verwendung
  • 📊 Detaillierte Statistiken - Komponenten, Entitäten, Services, Domains
  • 📥 Export-Funktionen - Download als JSON oder TXT
  • 🎨 Responsive Design - Funktioniert auf Desktop und Mobile

🚀 Schnellstart

1. Installation

git clone https://github.com/Kenearos/Homeassistant.git
cd Homeassistant
pip install -r requirements.txt

2. Server starten

python app.py

3. Browser öffnen

Öffnen Sie http://localhost:5000 in Ihrem Browser.

📚 Dokumentation

Für eine ausführliche Anleitung auf Deutsch, siehe ANLEITUNG.md.

Die Anleitung enthält:

  • Schritt-für-Schritt Installation
  • Home Assistant Token erstellen
  • Verwendung der Web-GUI
  • Kommandozeilen-Tool
  • Fehlerbehebung
  • Sicherheitshinweise
  • FAQ

🔑 Home Assistant Token erstellen

  1. Öffnen Sie Home Assistant
  2. Klicken Sie auf Ihr Profil (unten links)
  3. Scrollen Sie zu "Long-Lived Access Tokens"
  4. Klicken Sie auf "TOKEN ERSTELLEN"
  5. Geben Sie einen Namen ein
  6. Kopieren Sie den Token (wird nur einmal angezeigt!)

💻 Verwendung

Web-GUI (Empfohlen)

  1. Server starten: python app.py
  2. Browser öffnen: http://localhost:5000
  3. URL und Token eingeben
  4. "Bericht generieren" klicken
  5. Optional: Bericht herunterladen

Kommandozeile

python ha-overview.py

Sie werden interaktiv nach URL und Token gefragt.

📋 Anforderungen

  • Python 3.7+
  • Flask
  • requests
  • Zugriff auf Home Assistant API
  • Long-Lived Access Token

🛠️ Technische Details

Architektur

  • Backend: Flask (Python)
  • Frontend: HTML/CSS/JavaScript
  • API-Kommunikation: REST API mit Home Assistant
  • Datenspeicherung: JSON (optional)

Verzeichnisstruktur

Homeassistant/
├── app.py              # Flask Backend-Server
├── ha-overview.py      # Original Kommandozeilen-Tool
├── ha_overview.py      # Modul-Version
├── templates/
│   └── index.html      # Frontend Web-GUI
├── requirements.txt    # Python-Abhängigkeiten
├── ANLEITUNG.md        # Ausführliche deutsche Anleitung
└── README.md           # Diese Datei

🔒 Sicherheit

  • ⚠️ Token niemals teilen oder in öffentlichen Repositories speichern
  • 🔐 Verwenden Sie HTTPS für Remote-Zugriff
  • 🔄 Erneuern Sie Token regelmäßig
  • 🏠 Verwenden Sie das Tool nur in vertrauenswürdigen Netzwerken

🤝 Mitwirken

Beiträge sind willkommen! Bitte erstellen Sie ein Issue oder Pull Request.

📄 Lizenz

MIT License

👤 Autor

Kenearos

Für die vollständige Anleitung auf Deutsch, siehe ANLEITUNG.md