SatTrack

Satellite imagery object tracking for Home Assistant.
Detects objects (ships, vessels) on satellite images, tracks them over time, and exposes sensors + a live camera entity in HA.

---

Installation (Home Assistant)

Step 1 – Add the add-on repository

1. In Home Assistant open Settings → Add-ons → Add-on Store
2. Click ⋮ (three dots) → Repositories
3. Paste: https://github.com/NikGro/sattrack
4. Click Add → close the dialog
5. Find SatTrack in the store and click Install

Step 2 – Configure the add-on

In the add-on Configuration tab set your region:

Option	Description	Default
region_west	West longitude	-5.0
region_south	South latitude	35.0
region_east	East longitude	5.0
region_north	North latitude	45.0
interval_minutes	Scan interval	60
source	Image source (nasa_gibs or sentinel)	nasa_gibs
detector	Detector (opencv or yolo)	opencv

Click Start. The web dashboard opens via SatTrack in the HA sidebar.

Step 3 – Add the integration (optional, for sensors)

1. Settings → Integrations → + Add integration → SatTrack
2. If the add-on is running it connects automatically – no URL needed

This adds:

Entity	Description
sensor.sattrack_object_count	Objects detected in latest scan
sensor.sattrack_active_tracks	Active tracks with GPS coordinates
sensor.sattrack_last_event	Last change event (appeared/moved/disappeared)
camera.sattrack_latest_image	Live annotated satellite image
binary_sensor.sattrack_change_detected	ON when an event occurred < 5 min ago

---

Image sources

Source	Resolution	Auth needed
nasa_gibs	250 m (MODIS, daily)	None – free
sentinel	10 m (Sentinel-2)	Free account at sentinel-hub.com

---

Architecture

addon/                    ← HA Supervisor add-on (Docker, runs sattrack engine + web UI)
sattrack/                 ← Python package (detection, tracking, notifications)
web/                      ← FastAPI backend + dark dashboard (served via HA Ingress)
custom_components/sattrack/ ← HACS integration (HA sensors, camera, binary sensor)