Installation

Installation

Requirements

Android	7.0 (API 24) or newer
Architecture	64-bit Arm (arm64-v8a) is the normal case. 32-bit Arm and x86_64 builds exist too.
Location	A GPS receiver and the Precise location permission
Optional	3 GB of RAM and 64-bit Arm for offline voice search; free storage for offline maps and voice models

Download

The reference downloads are on the GitHub releases page. Each release carries four APKs and a SHA256SUMS.txt:

File	For
app-arm64-v8a-release.apk	Nearly every phone sold since 2016 — pick this one if you are unsure
app-armeabi-v7a-release.apk	Older 32-bit Arm phones
app-x86_64-release.apk	Emulators and rare x86 tablets
app-release.apk	Universal build with all three — larger, use it only when the architecture is unknown

The embedded offline speech engine is only in the 64-bit Arm code. On the other builds the microphone button simply keeps using your phone's own speech recogniser.

Roadstr is also distributed through Zapstore under the package name app.roadstr. The GitHub release is always the reference for what a version contains.

Check that the download is genuine

Every official APK is signed with the same release key. Compare the checksum with the one in SHA256SUMS.txt:

sha256sum app-arm64-v8a-release.apk     # then compare with SHA256SUMS.txt

and check the signing certificate (needs the Android SDK build tools):

apksigner verify --print-certs app-arm64-v8a-release.apk

The certificate's SHA-256 digest must be:

9d6113c5a9bfa0308636d7a7c69eea50c3b9e16446ad29127c2561c550154281

If it differs, do not install the file.

Install

1. Open the downloaded APK on the phone. Android asks to allow installs from that source (your browser or file manager) — allow it for this one install.
2. Open Roadstr and follow Getting started.

Updating

• In place, keeping everything. A new version installs over the old one. Because every release uses the same package name (app.roadstr) and the same signing key, nothing is lost: identity, saved places, settings and downloaded models stay.
• From the 0.5.x line (the old Flutter app). The same applies. On the first start of 1.x, Roadstr reads the old app's data once — identity (when it was an Amber login), saved places, parking spot, settings, search history, queued reports, the Lightning wallet string, routing keys and favourites-sync settings. Nothing in the old files is changed or deleted. If something cannot be read, the app says so and offers Try again or Continue without importing; it never starts with a silently empty profile.
• An old login with a pasted nsec comes over logged out, with a one-time notice. Roadstr no longer accepts a private key; see Nostr and sign-in.

Uninstalling

Removing the app deletes its data, including the downloaded voice and speech models. Export your saved places first (Settings → Saved Places → Export favorites) or turn on favourites sync if you want them back later.