Waypoints: waypoint

Send, delete, and list waypoints on the mesh network. Waypoints are named geographic points that appear on the map in compatible Meshtastic clients.

waypoint send

Broadcast or unicast a new waypoint to the mesh.

# Send a waypoint broadcast to all nodes
mttctl waypoint send --name "Base Camp" --lat 40.4168 --lon -3.7038

# Send a waypoint with full options
mttctl waypoint send \
  --name "Checkpoint A" \
  --lat 40.4168 \
  --lon -3.7038 \
  --alt 650 \
  --icon 9410 \
  --expire 3600 \
  --dest 04e1c43b
OptionDescription
--nameWaypoint name, up to 30 characters (required)
--latLatitude in decimal degrees (required)
--lonLongitude in decimal degrees (required)
--altAltitude in meters (optional)
--iconUnicode code point for the waypoint icon displayed in clients (optional)
--expireSeconds until the waypoint expires (optional, omit for no expiry)
--destTarget node ID in hex for a unicast waypoint (omit to broadcast)
--toTarget node name for a unicast waypoint (omit to broadcast)

waypoint delete

Delete a waypoint by its numeric ID.

mttctl waypoint delete --id 42
OptionDescription
--idNumeric waypoint ID to delete (required)

waypoint list

List all waypoints known to the local node. Listens for incoming waypoint packets with a configurable timeout.

mttctl waypoint list