Map

The Map view displays all contacts with known GPS coordinates on an OpenStreetMap-based map.

Contact Markers

Contacts are shown as colored circle markers with type-specific icons:

ColorType
BlueChat users
GreenRepeaters
PurpleRoom servers
OrangeSensors
RedYour device

Click a saved contact marker to open the contact's detail dialog. For discovered nodes, clicking a marker opens a detail popover showing:

  • Type -- the node type (Chat, Repeater, Room, Sensor).
  • Public Key -- truncated key with a copy button to copy the full key.
  • Location -- GPS coordinates.
  • Last Seen -- when the node was last heard.
  • Add to Contacts -- button to add the discovered node directly to your contact list.

Filtering

Use the sidebar toggles to show or hide specific contact types (Users, Repeaters, Rooms, Sensors). A Discovered Nodes toggle controls whether nodes from the Discover Nearby Nodes scan or the online node database are shown. The Last Seen dropdown limits the map to nodes heard within Past hour, Past day, or Past month (or Any time); nodes that have never been heard are hidden as soon as a time window is selected. The status label below shows how many contacts are visible on the map vs. total contacts.

Clusters

When multiple contacts are close together at the current zoom level, they are grouped into numbered cluster markers. Click a cluster to zoom in or expand it into individual markers.

Offline Maps

Meshy caches the vector map style on disk in its cache directory (~/.cache/meshy/map-styles/ on native builds) and refreshes it in the background at most once a week. Together with the tile cache kept by the map library, this lets Meshy render a map that was used before even when the network is unavailable, including OpenFreeMap-based vector maps whose style must be available before any tiles can be drawn. Only areas you have viewed before are available offline; zooming to a region whose tiles were never cached still requires a connection.

Path Visualization

Path overlays can be shown on the map from:

  • Device view > Trace Path -- after tracing a route, the path is drawn with SNR labels at each segment midpoint
  • Contact details > Show Path on Map -- visualizes the established path to a contact

Path markers use the same colored circles as regular markers. SNR values are color-coded: green (good, ≥0 dB), dim (marginal, -5 to 0 dB), red (poor, <-5 dB).

Path Distance Units

The app checks locale environment variables to choose distance units. US, LR, MM, and GB are treated as imperial territories, all other recognized territories use metric units. To keep a locale such as en_US while displaying distances in metric units, set LC_MEASUREMENT:

LC_MEASUREMENT=cs_CZ.UTF-8 ./AppRun