✈️ ADS-B Proxy für Home Assistant

Ein Flask-Proxy-Server der lokale ADS-B-Flugzeugdaten aufbereitet und als fertige HTML-Karten für Home Assistant bereitstellt, mit Fotos, Airline-Logos und Routen.

Features

• Echtzeit-Flugzeugkarten direkt aus dem lokalen tar1090 oder ultrafeeder Feed
• Fotos von Planespotters.net
• Airline-Logos via airhex.com
• Routen via adsb.im API (ZRH → LUX, HAM → IBZ etc.)
• Privatflugzeug-Erkennung für Kennzeichen wie D-EBHX
• Auto-Refresh alle 30 Sekunden
• HTTPS-tauglich via Cloudflare Tunnel

Voraussetzungen

• Raspberry Pi oder anderer Linux-Server mit laufendem ultrafeeder oder tar1090
• Python 3
• Home Assistant optional mit Cloudflare Tunnel Add-on für HTTPS

Installation

1. Abhängigkeiten installieren

pip3 install -r requirements.txt

2. Repository klonen und konfigurieren

git clone git@github.com:saarlandpower/adsb-ha-proxy.git
cd adsb-ha-proxy
cp .env.example .env
nano .env

Passe in .env an:

LOCAL_FEED=http://192.168.178.130:1090/data/aircraft.json
PROXY_BASE=http://192.168.178.130:5055
PROXY_PORT=5055

3. Server manuell testen

python3 server.py

Dann im Browser prüfen:

http://DEINE-PI-IP:5055/cards

4. systemd Service einrichten

sudo cp systemd/adsb-proxy.service /etc/systemd/system/

Passe User und Pfade bei Bedarf an:

User=dein-user
WorkingDirectory=/opt/adsb-ha-proxy
ExecStart=/usr/bin/python3 /opt/adsb-ha-proxy/server.py

Dann aktivieren:

sudo systemctl daemon-reload
sudo systemctl enable adsb-proxy
sudo systemctl start adsb-proxy
sudo systemctl status adsb-proxy

Home Assistant Integration

Option A: Cloudflare Tunnel

Im Cloudflare Tunnel Add-on unter Zusätzliche Hosts hinzufügen:

• Hostname: adsb.deinedomain.de
• Service: http://DEINE-PI-IP:5055

Dann in Lovelace:

type: iframe
url: https://adsb.deinedomain.de/cards
aspect_ratio: "120%"

Option B: Lokales Netzwerk

type: iframe
url: http://DEINE-PI-IP:5055/cards
aspect_ratio: "120%"

Eine fertige Beispielkarte liegt unter home-assistant/adsb_card.yaml.

API-Endpunkte

Endpunkt	Beschreibung
/cards	Alle 4 nächsten Flugzeuge als HTML-Grid
/card/<index>	Einzelne Karte (0-3) als HTML
/info/<callsign>/<hex>	JSON mit allen Infos
/photo/<hex>	Redirect zum Planespotters-Foto
/health	Cache-Status als JSON

Konfiguration

In server.py anpassbar:

FEED_TTL = 10      # Lokaler Feed Cache
PHOTO_TTL = 86400  # Fotos Cache
ROUTE_TTL = 21600  # Routen Cache

Verwendete APIs

API	Zweck	Kosten
Planespotters.net	Flugzeugfotos	Kostenlos
adsb.im	Routen	Kostenlos
airhex.com	Airline-Logos	Kostenlos

Lizenz

MIT License, siehe LICENSE