Repository navigation
Settings Reference
Every section of Settings, in the order the app shows them. Sections for features you have not enabled show only their switch.
Pick one of four: Light · Nostr Violet, Light · Bitcoin Orange, Dark · Nostr Violet, Dark · Bitcoin Orange. Auto dark theme switches to the matching dark variant at sunset and back at sunrise (on by default).
System default, or one of 27 languages. See Localisation.
Pseudonymous mode (recommended) shows other Roadstr users a generic avatar and “nostrich”; Show profile publicly shows your Nostr name, npub and picture. See Nostr and sign-in.
Eco, Balanced, 3D Eco or Performance. See Navigation.
| Setting | |
|---|---|
| Avoid unpaved roads | Steers routes away from tracks and dirt roads when a paved way exists — a preference, not a guarantee |
| Keep screen on | Prevents sleep during navigation |
| Keep screen on outside navigation too | Also while browsing the map |
| Minimum screen brightness | Stops dimming below a level (useful on OLED screens); Off disables it |
| Show altitude | A small elevation readout near the map controls |
| Map element overlays | Closed by default: Pedestrian crossings and Traffic lights from OpenStreetMap on the map |
| Center on my position at startup | Uses GPS only after location permission was already granted |
| Imperial units | Miles and feet |
| Map tile URL | Raster tile server for the map |
| Routing provider | OSRM (public, default), GraphHopper (local/private), GraphHopper Cloud (API key), OpenRouteService (API key); a Verify button checks a GraphHopper key or server |
Speedometer style — Classic (default), Digital, Analog, Sport, Minimal — and the movement cursor: vehicle (Standard, Formula 1, SUV, Racing car, Electric car, City car, Classic Fiat 500) and colour (Violet, Indigo, Blue, Green, Yellow, Orange, Red).
Choose the web search engine (Qwant, Brave Search, DuckDuckGo, Startpage or Google) and — optional — Web results in search through a SearXNG instance you provide. Web results are off by default. See Search and Explore.
Nostr Wallet Connect (NWC): paste your NWC URI to pay zaps directly from the app. See Lightning and zaps.
Add place, edit and delete favourites; Export favorites / Import favorites (encrypted JSON, optional password).
End-to-end encrypted sync of your favourites to your Nostr relays: Sync automatically (off by default), Push to Nostr, Pull from Nostr, Sync passphrase (optional), Your own relay (optional). Needs a signed-in identity. See Nostr and sign-in.
Enable Journey and rewards, Sync Journey with Nostr, Open Journey dashboard. Both switches are off by default. See Journey and achievements.
Show compatible reports, Also publish in the compatible format, Sign the compatible copy with a one-time key. See Interoperability and MeshCore.
Radio pairing, receive, send, the two bridges and the waiting queue. See Interoperability and MeshCore.
Voice guidance, Voice model (download), Voice (female/male), Speech speed, Voice volume. See Voice guidance.
Download the model / Delete the model, status, privacy notes and the model's licence attribution (shown on devices that can run it). See Voice search.
Version, protocol (Nostr), maps (opens the OpenStreetMap attribution), the routing provider in use, the source link, and Support Roadstr.
Roadstr is open source under the MIT licence · Source · Releases · Changelog · Issues
Using Roadstr
- Installation
- Getting started
- Navigation
- Maps and offline use
- Search and Explore
- Road reports
- Public transport
- Voice guidance
- Voice search
- Journey and achievements
- Settings reference
Nostr and money
Trust
Build and extend