APRSdroid APRS Setup: Settings, Path & Live Users

Open-source APRS client for Android. Connects via Bluetooth TNC, audio cable, or APRS-IS internet gateway. Full messaging tier: sends ACKs and displays incoming text.

3711 station(s) heard beaconing with a APRSdroid on the APRS-IS network in the last 7 days.

Live APRSdroid stations

How to set up APRS on the APRSdroid

APRSdroid can run two completely different ways: over the internet with no radio at all, or over RF through a TNC. The settings look similar and the results do not, so decide which one you want before you start.

  1. Set your callsign and SSID
    Open Preferences and enter your callsign under APRS Settings. Add an SSID. APRSdroid on a phone is conventionally -7, or -9 if the phone rides in a vehicle.
  2. Get a passcode, but only if you are going over the internet
    An APRS-IS connection needs a passcode derived from your callsign. A connection to a radio or TNC needs none. Neither we nor APRSdroid can issue one for you; see our passcode guide for what it is and where it comes from.
  3. Set symbol, comment and path
    Still under Preferences: pick an APRS symbol, write a short comment, and set "APRS digi path" to WIDE1-1,WIDE2-1. The path only matters on an RF connection; over APRS-IS your packet goes straight to the servers and never touches a digipeater.
  4. Choose where position comes from
    Under "Location Settings", "Location Source" offers SmartBeaconing, "Periodic GPS/Network Position" and a manual fixed position. Periodic is the gentler starting point; SmartBeaconing is better once you are driving with it.
  5. Choose the connection
    Under "Connection Preferences", "Connection Protocol" selects the transport. TCP over APRS-IS is the default and needs only the passcode. For a radio, select "TNC (KISS)", set "Connection Type" to "Bluetooth SPP", then pick your TNC under "TNC Bluetooth Device".
  6. Start tracking
    Back on the main screen, tap Start Tracking and switch to the log view. A green line in the log is a position report leaving the app. No green line means the app never transmitted, which is a different problem from nobody hearing you.

Recommended APRS settings

SettingValueNotes
CallsignYOURCALL-7-9 if the phone travels in a vehicle
Passcoderequired for APRS-IS onlya TNC connection needs none
APRS digi pathWIDE1-1,WIDE2-1ignored on an APRS-IS connection
Location SourcePeriodic GPS/Network PositionSmartBeaconing once you are mobile
Connection ProtocolTCP for APRS-IS, TNC (KISS) for a radio—
Connection TypeBluetooth SPPfor a Bluetooth KISS TNC
Symbol/[ (person) is a safe default—

Troubleshooting

The app says my login or passcode was rejected

The passcode is computed from the callsign, so a passcode issued for one callsign will never validate another, and it must match the base callsign, without the SSID. Re-check both fields character by character.

It shows connected but nothing is transmitted

Being connected and tracking are separate states. Tap Start Tracking, then watch the log view for a green outgoing line. If there is none, the app has no position fix yet or "Location Source" is set to a manual position that was never entered.

It will not connect to my Bluetooth TNC

A KISS TNC accepts one connection at a time. If the manufacturer’s configuration app is still connected in the background, APRSdroid cannot get in. Disconnect and fully exit that app first.

Can I use APRSdroid without a radio?

Yes, over APRS-IS with a passcode. Understand what that means: your position reaches the internet map but is never transmitted on the air, so operators listening on RF near you will not hear it and it does not exercise the local digipeater network.

Which SSID should I use?

It is a convention, not a rule, and nothing rejects a packet for using the "wrong" one: -7 for a handheld, -9 for a vehicle, -10 for an internet gateway, and no SSID at all for a home station. Using the conventional one just means other operators can read your intent at a glance.

Source: github.com · aprsdroid.org

Related guides

All APRS hardware · Live APRS map