Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Unable to connect to Bluetooth GNSS receiver after app reinstall — requires full Bluetooth re-pair as workaround

Open
#4,587 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
3/5
Estimated time
1-2 days
Newbie friendliness
55/100
Issue type
Bug
Clarity
Mostly clear
Activity status
Quiet
Tech stack
android
Domain
mobile

Research direction

Start by reproducing the issue through GPS settings → Connect new receiver → Bluetooth → Continue, using the previously paired receiver after reinstall. Inspect the Android Bluetooth GNSS connection flow and the + action; done means the receiver reconnects without OS-level re-pairing and provides feedback if connection fails.

Written by the indexing model from the issue text.

Description

android 🤖 bluetooth bug GPS

Description
After reinstalling the Mergin Maps app, a previously paired Bluetooth GNSS receiver cannot be reconnected through the app's "Connect new receiver" flow. The receiver appears in the Bluetooth device list, but tapping the + button does not establish a connection and no error is shown.

Environment
[x] Staging [ ] PROD

Application (+ app version, build, operating system)
Mergin Maps Android app 2026.3.0 (RC)
Device: Redmi A3, Android 15

Steps to reproduce

  1. Pair a Bluetooth GNSS receiver with the device and connect it successfully in the Mergin Maps app
  2. Reinstall the Mergin Maps app (uninstall + install)
  3. Open the app → go to GPS settings → Connect new receiver → Bluetooth → Continue
  4. Select the same receiver from the Bluetooth device list
  5. Tap the + button to connect

Actual results
No connection is established. The app gives no feedback — the receiver is not added and no error message is shown.

Expected results
The app should be able to reconnect to a previously OS-paired Bluetooth GNSS receiver after reinstall without requiring the user to remove and re-pair the device at the OS Bluetooth level.

Workaround

  1. Remove the GNSS receiver from the device's Bluetooth settings
  2. Re-pair the receiver at the OS level
  3. Force-close the Mergin Maps app
  4. Reopen the app — the receiver can now be connected via the standard flow

Screenshots or logs

Conclusion
Created by Claude and supervised by a human test analyst.

Dominant language
C++
Stars
388
Forks
87
Avg merge
4d 1h
Merged PRs (30d)
23

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from MerginMaps/mobile

All issues in MerginMaps/mobile

Similar issues

More C++ issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.