MinimapPR MinimapPR

Realtime environmental awareness: distributed sound localization + classification + common operating picture.

Self-hosted. Point a mic array (or several, PPS/GPS-synced) at the world and get a live map of what's making noise, where it is, and whether you should care.

curl -LsSf https://minimappr.com/install.sh | sh
View on GitHub

Primary features

One binary. A browser tab. Everything below runs locally on your hardware.

◎

Live common operating picture

Full-bleed map, filtered live websocket feed, entity symbology, and uncertainty ellipses on every localized track.

▦

Single node or synced array

Run one node standalone, or scale to a PPS/GPS-synced array with cross-node SRP-PHAT fusion and multi-server federation.

♪

BirdNET species ID + localization

Identify bird species by call and place them on the map — not just a classification, a located, tracked entity.

✎

Speech-to-text with keyword alerting

Transcribe speech in range and fire alerts on matched keywords, with the triggering snippet attached as evidence.

⚑

Configurable classifier alerting

Coyote detection ships as a default rule out-of-the-box; drones, gunshots, and anything else are supported via classifier labels plus your own rules.

◉

Ambisonics / IAMF spatial audio

Offline studio render pipeline exports spatial recordings to IAMF/MP4 for post-hoc listening and review.

Also included

⌖

PTZ camera integration

ONVIF slew-to-track: point a PTZ camera at a localized sound event automatically.

▨

BLE device localization

RSSI multilateration to place Bluetooth devices on the same operating picture as audio tracks.

≈

Environmental sensing

Per-node temperature/humidity sensing feeds live speed-of-sound correction for tighter localization.

Install

Installs uv, then uv tool install's MinimapPR. Cross-platform, no manual Python setup.

curl -LsSf https://minimappr.com/install.sh | sh
The installer prompts to add a desktop shortcut and to launch MinimapPR now. Once running, the UI is at http://127.0.0.1:8080. To install without the BirdNET/YAMNet/ONVIF extras, pass --base to install.sh. Start it any time with minimappr; uninstall with uv tool uninstall minimappr.

Nodes & hardware

Coming soon

Sirith tetrahedral array

MinimapPR's reference node design is a 4-mic tetrahedral array (PPS-synced for multi-node fusion). A full node build/setup tutorial is on the way — in the meantime, see the firmware README and node_config.h for node settings.