Install a plugin
| App | How |
|---|---|
| ZYRNTOPO (web, Android) | Plugins on the toolbar, or in Tools on a phone, then Get plugins |
| ZYRNMAPS (Android) | Menu ▸ Plugins ▸ Get plugins |
| ZYRN Workstation (Windows, macOS, Linux) | The Plugins tab ▸ Get Plugins… |
The plugins below are installed from inside the apps; there are no manual downloads. A plugin someone shares with you as a .zyrnplugin file installs from the same Plugins screen.
Search and rescue
| Plugin | What it does | Needs |
|---|---|---|
| Lost Person Rings | Statistical search rings (25, 50, 75 and 95 percent) around the last known point from your team's Lost Person Behavior figures, saved as profiles, plus a travel-limit ring from the hours since last seen and walking speed. Can add the rings to Map Items so the whole team sees them. | Map items |
| Team Check-in | Personnel accountability. Everyone heard over TAK with the time since they last reported; an alert and a last-known-location marker when someone goes quiet past your limit; a roll call to All Chat Rooms that ATAK, WinTAK and iTAK show as chat; a roster to save as CSV. | TAK, files |
| Unit Log | A timestamped activity log with positions. One-tap entries for departed, on assignment, clue found, complete and returned; clues become red markers. Saves as an ICS 214-style CSV or a GPX. Other plugins on this page write their alerts into it. | Position, files, map items |
| Checklists | Shared checklists from templates (initial response, team departure, debrief) or your own list. Everyone on the same TAK network with the plugin sees who ticked what and when. | TAK, files |
| Reference Grid | A lettered and numbered grid (A1, B4…) over the view or between two corners, so a whole team names a place the same way on the radio. Tap the map to read the cell; keep the grid as a layer or save it as GeoJSON. | Files |
Tracking and alerts
| Plugin | What it does | Needs |
|---|---|---|
| Bloodhound | Live range, bearing, closing speed and arrival time from you or any team member to a team member, map item or point. The line turns from green to yellow to red as the arrival time drops, with an alert on arrival. | TAK, position, map items |
| Geofence Alerts | Turn any area or circle in your Map Items into a geofence and get an alert when you or a team member enters or leaves it. | Map items, TAK, position |
| Aircraft (ADS-B) | Live aircraft around the map from the free adsb.lol network, coloured by altitude, with a low-flying filter for air operations and drone flights and an alert on emergency squawks. | Internet: adsb.lol |
Weather, water and light
| Plugin | What it does | Needs |
|---|---|---|
| Spot Weather | Weather now and for the next 12 hours anywhere (Open-Meteo), the National Weather Service forecast and active alerts in the US, and field observations shared with the team as a marker over TAK. | Internet: Open-Meteo, NWS; TAK, position |
| River Gauges | Live USGS stream gauges in view: flow, water level and whether the river is rising or falling, with an alert when a gauge you watch passes your limit. United States only. | Internet: USGS |
| Daylight | Sunrise, sunset, civil and nautical twilight, moonrise, moonset and moonlight anywhere, with a warning before last light. Works offline. | Position |
Community plugins
These come from people who use ZYRNTOPO. Each one passed the automatic scan described under Submit a plugin before it was listed, and no person reviewed it. They install from the Plugins section of an app like the plugins above, and the app shows what each one needs before it runs. ZYRNTOPO lists them from version 1.17.19 and ZYRN Workstation from 1.1.10, and ZYRNMAPS from its next update. If one misbehaves, report it here.
Loading the community list…
Submit a plugin
Anyone with a verified account can list a plugin for everyone. Upload the .zyrnplugin file and a server checks it straight away, with nobody in between. It unpacks the file, checks plugin.json, reads the code for things plugins may not do (code built from text at run time, hidden or obfuscated code, keys and passwords written into the code, services made for collecting data, mining, reaching past the sandbox), and then starts the plugin in the same engine the apps use and presses its buttons. A plugin that passes is listed at once, here and in the apps. Either way the report comes back here and by email, with what to fix.
Choose open source and name the licence if others may reuse your code, or proprietary to keep all rights. Either way the code travels to every device that installs the plugin, so never put passwords or keys in it. To publish an update, raise version in plugin.json and submit again; only the account that first published a plugin id can update it.
A scan cannot prove a plugin is safe. What protects people is that every app runs plugins in a sandbox, lets them reach only the servers listed in hosts, and asks before one uses the internet, TAK, your position, files or your map items. Three reports from verified accounts take a plugin down at once, and every app turns off copies already installed. A new version that passes the scan brings it back. The rules are in the Terms of Use.
Your plugins
Write your own
A plugin is a folder with a plugin.json and JavaScript. You can write the JavaScript yourself, or write the plugin in Python, Java, Go, C or C++. The plugin SDK has a starting template for each of these languages and one build command that turns your code into the same package, so it runs in every app like any other plugin. The SDK's README says which compiler each language needs.
Build it with the SDK, or zip a JavaScript plugin's folder and rename it to .zyrnplugin. You can share that file directly, and it installs from the same Plugins screen, or submit it above to list it for everyone. The plugins on this page are ordinary plugins built on the same API anyone can use, and they talk to each other through the plugin bus: Geofence Alerts, Team Check-in, Bloodhound and the rest write into Unit Log through the zyrn.log topic.
Plugins that share data over TAK send it as Cursor on Target, so it travels through a TAK server and nearby TAK. ATAK, WinTAK and iTAK ignore it; only the same plugin reads it.