EN ET
Help

Guide & FAQ

How to get log files off your device, read your numbers, trim, merge and submit your best runs to GP3S — plus answers to the questions that come up most.

From install to submission in six steps

GPS Analyzer works the same way whether you're pulling logs straight off an ESP-IDF GPS Logger over WiFi or importing files from another device.

1

Install the app

Install through TestFlight on iOS (public beta) or Google Play on Android. It's free to use.

2

Add a device or import files

On the Devices tab, WiFi-discover your ESP-IDF GPS Logger and download its logs — or import .sbp, .ubx, .oao, .gpy, .gpx or .fit files from Files or another app's share sheet.

3

Browse Devices → Files → Sessions

Drill down from a device or file into its sessions. Sessions are detected automatically the moment a file is analyzed — no manual splitting.

4

Check your metrics

Every competitive interval — 2 s, 10 s, ½ hour, 1 h, sprint distances, nautical mile, alpha 500 — appears instantly, computed the same way GP3S computes them.

5

Trim, merge & compare

Select one session and choose Trim to cut the paddle-out, a shore break, or a GPS gap. Select two or more and choose Compare to line them up, or Merge to combine them into one continuous session — all directly from the Sessions list, and all undoable.

6

Group into an Activity & submit

Gather sessions from multiple devices or days into an Activity to see the best run across the whole group, then submit the run you pick to GP3S in one tap.

What each part of the app does

A closer look at every screen, for when you want more than the quick version above.

📡

Devices & WiFi

The Devices tab discovers an ESP-IDF GPS Logger automatically. The logger supports two WiFi modes: in Access Point (AP) mode it broadcasts its own WiFi network that your phone joins directly; in station mode it joins your home/router WiFi like any other device, so your phone just needs to be on that same network. Tap a device to browse and download its logs, view and edit its configuration, or flash new firmware over the air.

Don't see your logger? In AP mode, join the logger's own WiFi network from your phone's WiFi settings first. In station mode, make sure your phone is on the same network as the logger (not a guest or isolated network) — or add it manually by IP address from the same screen.

📂

Import & file formats

The Files tab holds everything you've downloaded or imported. Use the share sheet or file picker to bring in logs from Locosys, u-blox-based loggers, Motion, OpenGNSS, Garmin / COROS, or a plain GPX export.

Supported formats: .sbp · .ubx · .oao · .gpy · .gpx · .fit. Doppler speed is read straight from the file wherever the format provides it.

🗂️

Sessions

A session is one continuous run, split out automatically from a file by time and location gaps — by default a break of more than 30 minutes starts a new session.

The session list shows a mini-track preview, max speed and key intervals for each one — sort by date, location, 10 s, max speed, or distance.

Metrics & analysis

Opening a session runs the same C analysis engine used by GP3S: 2 s peak average, 10 s average, ½ hour, 1 hour, 100 m / 250 m / 500 m, nautical mile, alpha 500 and max speed, plus a map and speed-over-time graph.

High-rate logs are read at up to 20 Hz. Everything is computed on-device, so results appear immediately after import — nothing is uploaded to see your own numbers.

🔀

Trim, merge & compare sessions

All from the Sessions list. Select one session and choose Trim to edit its time window directly on the track and speed graph — drag the start/end handles, zoom in for sub-second precision, or type exact times. The most common reason: the logger kept running after you got off the water, and the drive home shows up as a suspicious new "record" — trim cuts it off without touching the original file.

Select two or more sessions and choose Compare to line them up side by side, or Merge to combine them into one continuous session. Merge is mainly for sessions from the same device — one continuous outing that got split by a gap — though any sessions that meet the requirements (same location, within 24 hours of each other, not overlapping in time) can technically be merged, even across devices.

Both are non-destructive. A trim always keeps the full original range to reset to. A merge keeps the source sessions untouched and marks them "merged into" the new one — delete the merged session and the originals reappear in the list automatically.

🧭

Activities: group across devices & days

An Activity gathers sessions that belong to the same outing — logged on two devices, or split across several files — into one group you manage together. GPS Analyzer can auto-cluster sessions that look like they belong together and suggest the grouping for you.

Inside an Activity, GPS Analyzer highlights the best run across the whole group. You don't need one just to compare or merge two sessions, though — Compare and Merge (above) work directly from the Sessions list on any sessions you select.

🏆

Submit to GP3S

Sign in with your GPS-Speedsurfing (GP3S) account once, from Settings. After that, any session or run shows an upload action that builds the correct payload and metadata for you.

Because the on-device numbers match the GP3S engine, the run you see is the run that shows up on the leaderboard.

📤

Export & share

Export a session's original log file at any time through the share sheet — to back it up, send it to someone else, or open it in another tool.

⚙️

Settings

Timezone (device local, UTC, or a custom offset), speed units (km/h or knots), map layout, font size, and your GP3S account all live in Settings.

You'll also find Rebuild index under Maintenance — safe to use if the browse list ever looks out of sync with what's on disk — and Contact support under Support.

Frequently asked questions

Still stuck after reading these? Jump to Contact support below.

Getting started

Is GPS Analyzer free?
Yes — it's free to use. Android is live on Google Play; iOS is still in public TestFlight beta.
Do I need an ESP-IDF GPS Logger to use it?
No. The app has direct WiFi support for the ESP-IDF GPS Logger (discovery, download, configuration, OTA firmware), but it can open and analyze log files from almost any speed-GPS through the file picker or share sheet.
What file formats can I open?
.sbp (Locosys), .ubx (u-blox), .oao (Motion), .gpy (OpenGNSS), .gpx, and .fit (Garmin / COROS).

Devices & WiFi

How do I connect to my logger?
It depends on the logger's WiFi mode. In AP mode, join the logger's own WiFi network from your phone's WiFi settings, then open the Devices tab. In station mode, put your phone on the same WiFi network as the logger and open Devices — it's discovered automatically. If it doesn't show up, add it manually by IP address from the same screen.
I don't see my device on the WiFi list — what should I check?
First check which WiFi mode the logger is in. In AP mode, your phone needs to join the logger's own network directly rather than looking for it on your home WiFi. In station mode, confirm the logger is powered on and broadcasting, and that your phone is on the same network (not a guest or client-isolated WiFi, which blocks discovery) — then try the manual IP-address option if it still doesn't appear.
Can I update my logger's firmware from the app?
Yes — from a connected device's screen you can flash new firmware over the air, no cables or desktop tool needed.

Sessions, trim & merge

How are sessions detected?
Automatically, from time and location boundaries in the log — by default a gap of more than 30 minutes starts a new session. If the auto-split doesn't match what actually happened on the water, you can fix it: select the sessions in the list and choose Merge to combine them back into one, trim a session's edges, or do both — all of it is undoable.
Do the numbers match GP3S exactly?
Yes. The on-device analysis mirrors the GPS-Speedsurfing scoring engine, so what you see in the app is what will be recorded if you submit it.
Can I remove the paddle-out or the drive home from a session?
Yes — open the session and choose Trim, then drag the start/end handles on the track and speed graph. The classic case: you forgot to stop the logger, drove home with it still running, and now it looks like you set a new top-speed record — trim cuts that tail off and recomputes every metric for the new window.
Can I undo a trim?
Yes — trimming keeps the original full range, so you can reset a session back to it at any time.
Can I combine two sessions into one, or compare them without an Activity?
Yes — select two or more sessions in the Sessions list and choose Compare to view them side by side, or Merge to combine them into one continuous session. Merge is mainly meant for sessions from the same device — one outing split into two by a gap — but it works on any sessions that meet the requirements (same location, within 24 hours of each other, no time overlap), even across devices. It's non-destructive too: delete the merged session and the originals reappear automatically.

Activities, GP3S & sharing

What's an Activity, and when should I use one?
An Activity groups sessions from different devices or days together and highlights the best run across the whole group — useful when the same outing was logged twice. You don't need one just to compare or merge two sessions, though: Compare and Merge work directly from the Sessions list on any sessions you select.
How do I submit a run to GP3S?
Sign in with your GPS-Speedsurfing account once from Settings. After that, an upload action appears on sessions and runs — tap it and the app sends the correct payload and metadata for you.
Can I export or back up a session?
Yes — export a session's original log file through the share sheet at any time, to back it up, send it to someone else, or open it elsewhere.

Privacy & support

Does any of my data leave my phone?
Analysis runs entirely on-device — nothing is uploaded to any server we run. Your logs and activities stay on your phone unless you explicitly choose to submit a run to GP3S, export/share a file, or view map tiles (which requests imagery from the map provider).
What speed unit does it use?
km/h by default; switch to knots in Settings → Display at any time.
How do I get help or report a bug?
In the app, go to Settings → Contact support — it opens an email prefilled with your app version and platform. See Contact support below for the direct email address.

Still need a hand?

✉️

Contact support

The fastest way: in the app, open Settings → Contact support — it opens an email with your app version and platform already filled in. You can also reach us directly at info@majasa.ee.