Files
kestrelos/docs/map-and-cameras.md
Madison Grubb a4996e7c91
All checks were successful
ci/woodpecker/pr/pr Pipeline was successful
get rid of ambiguous unicode chars
2026-02-17 11:28:47 -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).