Files
kestrelos/docs/map-and-cameras.md
Madison Grubb c696f38f4d
Some checks failed
ci/woodpecker/pr/pr Pipeline failed
simplify docs
2026-02-17 11:25:40 -05:00

1.5 KiB

Map and Cameras

KestrelOS shows a map with devices, POIs, live sessions (Share live), and ATAK/iTAK positions. Click markers or use Cameras page to view streams.

Map Layers

  • Devices — Fixed feeds (IPTV, ALPR, CCTV, NVR, etc.) added via API
  • POIs — Points of interest (admin/leader can edit)
  • Live sessions — Mobile devices streaming via Share live
  • CoT (ATAK/iTAK) — Amber markers for connected TAK devices (position only)

Cameras

A camera is either:

  1. A device — Fixed feed with stream URL
  2. A live session — Mobile device streaming via Share live

View via map markers or Cameras page (sidebar).

Device Types

device_type Use case
alpr, nvr, doorbell, feed, traffic, ip, drone Labeling/filtering

source_type: mjpeg (MJPEG over HTTP) or hls (HLS .m3u8 playlist)

Stream URLs must be http:// or https://.

API: Devices

Create: POST /api/devices (admin/leader)

{
  "name": "Main gate ALPR",
  "device_type": "alpr",
  "lat": 37.7749,
  "lng": -122.4194,
  "stream_url": "https://alpr.example.com/stream.m3u8",
  "source_type": "hls"
}

List: GET /api/devices
Update: PATCH /api/devices/:id
Delete: DELETE /api/devices/:id

Cameras endpoint: GET /api/cameras returns devices + live sessions + CoT entities.

POIs

Admins/leaders add/edit from POI page (sidebar). POIs appear as map pins (reference only, no stream).