New Files

README.md

@@ -1,2 +1,197 @@
-# Home-Assistant-finder
-Looking for Home Assistant Server on local network
+# ![Banner](banner.png)
+
+# 🔍 Home Assistant Auto-Finder (Windows + Linux)
+
+Et lille Python-script, der automatisk scanner dit lokale netværk og finder, hvilken IP-adresse din **Home Assistant**-server bruger (port **8123**).
+
+Scriptet kan køres både på **Windows** og **Linux**, så længe Python 3 er installeret.
+
+Perfekt til:
+- Headless Home Assistant installationer (ingen skærm på boksen)
+- Proxmox / VM-miljøer
+- Raspberry Pi og andre små bokse
+- Hurtigt at finde ny IP efter reinstall / flytning
+
+---
+
+## 🚀 Funktioner
+
+- Fungerer på både **Windows** og **Linux**
+- Finder automatisk din lokale IPv4-adresse
+- Antager et /24-netværk (fx `192.168.2.0/24`)
+- Scanner hele subnettet efter åben port **8123**
+- Kører i loop indtil en Home Assistant-server svarer
+- Kan altid stoppes med **CTRL + C**
+- Ingen eksterne Python-pakker – kun standardbiblioteket
+
+---
+
+## 📦 Krav
+
+- **Python 3.x**
+- Netværksforbindelse til det subnet, hvor Home Assistant kører
+- På Windows: Python tilføjet til `PATH` (valgfrit, men rart)
+- På Linux: Standard Python 3-installation (Debian/Ubuntu/RPiOS mv.)
+
+---
+
+## 📥 Installation
+
+Pak ZIP-filen ud, så du har disse filer:
+
+```text
+find_ha.py
+README.md
+banner.png
+```
+
+---
+
+## ▶️ Brug på Linux
+
+Åbn en terminal i mappen med filerne og kør:
+
+```bash
+chmod +x find_ha.py
+./find_ha.py
+```
+
+Eller:
+
+```bash
+python3 find_ha.py
+```
+
+Eksempel-output:
+
+```text
+🔍 Home Assistant Auto-Finder (Windows + Linux)
+   Scanner efter Home Assistant på port 8123
+   Kører indtil en server findes – stop med CTRL+C
+
+🌐 Opdaget lokal IP-range (baseret på /24): 192.168.2.0/24
+
+⏳ Ingen Home Assistant fundet endnu... prøver igen om 5 sekunder.
+⏳ Ingen Home Assistant fundet endnu... prøver igen om 5 sekunder.
+✅ Fundet Home Assistant: http://192.168.2.84:8123
+
+Færdig. Åbn adressen ovenfor i din browser.
+```
+
+---
+
+## ▶️ Brug på Windows
+
+1. Sørg for at **Python 3** er installeret  
+   (du kan teste i **PowerShell** eller **Kommandoprompt**):
+
+   ```powershell
+   python --version
+   ```
+   eller
+   ```powershell
+   py --version
+   ```
+
+2. Navigér til mappen med `find_ha.py`:
+
+   ```powershell
+   cd C:\sti\til\mappen
+   ```
+
+3. Kør scriptet:
+
+   ```powershell
+   python .\find_ha.py
+   ```
+   eller
+
+   ```powershell
+   py .\find_ha.py
+   ```
+
+Stop med **CTRL + C** hvis du vil afbryde.
+
+---
+
+## 🔍 Hvordan virker det?
+
+1. **Finder lokal IPv4-adresse**  
+   Scriptet laver en "falsk" UDP-forbindelse til `8.8.8.8:80` for at finde den IP, dit system ville bruge til at gå på nettet.  
+   Der sendes ingen rigtig trafik, men OS vælger det rigtige interface.
+
+2. **Antager et /24-subnet**  
+   Hvis IP f.eks. er `192.168.2.57`, antager scriptet netværket:
+
+   ```text
+   192.168.2.0/24
+   ```
+
+   og scanner alle adresser fra `192.168.2.1` til `192.168.2.254`.
+
+3. **Scanner port 8123**  
+   For hver IP prøves en TCP-forbindelse til port **8123**.  
+   Hvis den svarer, antages det, at det er en Home Assistant-instans.
+
+4. **Looper indtil succes**  
+   Hvis der ikke findes nogen, venter scriptet et par sekunder og prøver igen.
+
+---
+
+## 🧪 Typiske scenarier
+
+- Du har lige installeret Home Assistant på en **Raspberry Pi** uden skærm  
+- Du har lavet en ny **VM i Proxmox** med Home Assistant  
+- Din router har givet en anden IP end du forventede  
+- Du sætter Home Assistant op for andre, og vil hurtigt kunne finde IP’en
+
+---
+
+## ❗ Fejlfinding
+
+### Scriptet siger: *"Kunne ikke finde en ikke-127.x IPv4-adresse."*
+
+Mulige årsager:
+- Maskinen er ikke forbundet til et netværk
+- Der er kun loopback (127.0.0.1) aktivt
+- VPN / specielle netværksopsætninger
+
+➜ Tjek din netværksforbindelse og prøv igen.
+
+---
+
+### Scriptet finder ingen Home Assistant
+
+Tjek følgende:
+- Kører Home Assistant faktisk?
+- Er port **8123** åben i firewall?
+- Er den maskine, du kører scriptet fra, på **samme subnet**?
+- Bruger du VLANs, hvor der måske ikke er routing mellem netværkene?
+
+---
+
+## 📂 Projektstruktur
+
+```text
+homeassistant-autofinder/
+├── find_ha.py
+├── README.md
+└── banner.png
+```
+
+---
+
+## 📜 License
+
+MIT License
+
+---
+
+## 💡 Idéer til videreudvikling
+
+- Tilføje scanning af flere porte (fx HTTPS, add-ons osv.)
+- Enkel web-UI der viser scanning live
+- Docker-version der kan køre i container
+- Mulighed for at angive subnet manuelt via argumenter
+
+PR’er og forks er naturligvis velkomne 🙂