TopoKin

Getting started

Five minutes, with signal, before you need it. TopoKin's maps and radio setup are for the United States (where it works).

Setting TopoKin up for your kin? You're the organizer: follow steps 1 and 2 here, then go to For the organizer to create your group, invite everyone and set up radios.

1. Install

TopoKin is for Android: phones, tablets and Chromebooks. (There's also TopoKin for Windows and Ubuntu for planning on a big screen.) Two ways to get it:

Google Play (testing now, for people who've been invited). On your Android device, signed in with the Google account you were invited with, open join the TopoKin test (or scan the code), tap Become a tester, then install TopoKin from Play. Play keeps it up to date.

Scan to join the TopoKin test on Google Play

Direct download. Open the download page on your phone and tap Download. Android asks whether to allow installing apps from your browser: allow it, then install. Updates come by themselves: when there's a new version, TopoKin shows a small Update bar at the top of the map.

Pick one. The two can't update each other: to switch, uninstall first (then rejoin your group and get your maps again).

A tablet or Chromebook without GPS uses Wi-Fi location, or the GPS of a radio paired to it.

2. First start

The welcome screen

TopoKin asks for two things:

The permissions step

If you tapped Don't allow by mistake, tap Open settings on that screen and allow Location for TopoKin.

3. Join your group (or start one)

Whoever set up your group gives you an invite: a QR code on their screen, or a link. Scan the code with your phone's camera (or in TopoKin: Group › Scan invite QR code), or open the link, and TopoKin opens with the invite filled in. Check your name and tap Join.

Joining a group (or creating one)

Within a few seconds the Group panel shows who's in the group. People appear on your map once they share a position.

An invite works once and expires. If it says it didn't work, ask for a new one and tap Use a different invite.

No one has made a group yet? Then you're the organizer: tap Create a group on the same screen and see For the organizer to invite everyone.

4. Get maps for where you're going

Maps download per square (about 15 miles across) and work with no signal.

Before any maps: the online map with "No offline maps yet"

  1. Move the map to where you're going.
  2. Tap the Maps button on the right side, then Get more maps.
  3. Tap the squares you want (they turn blue), or Fill around to add the ones next to them, then Get.

Picking map squares

Each square is built for you the first time, then downloads in a minute or two. The pill at the top shows progress. Want satellite photos with no signal too? In Maps, tap Add satellite.

A square downloaded: the offline topo map

5. Going past signal? Get a radio

With signal, your phone is all you need. Past signal, your phone can't reach anyone by itself: seeing your kin, messages, rally points and trackers go through a small Meshtastic radio paired to your phone. One per person going out there, plus one for each tracker. See How it works and Your own radio.

6. Ready to go?

Before you leave signal, tap Ready? at the bottom of the map. It checks your maps, GPS, group, radio, phone battery, and each tracker radio, and tells you what to fix while you still can.

Ready to go? check

The screen at a glance

The map with the action bar at the bottom

Where What
Top middle Status lights: GPS, MAP (offline map here), NET (internet), RADIO. Green is good; tap for details.
Top left ⚙ Settings
Top right North-up compass, satellite on/off, Map layers, 3D
Right side Find, Center on me, Group, Messages, Maps
Bottom Mark here, Bearing, Ready?, Record trip. Swipe up for your position, your kin and trackers.

Next: How it works.