Repository navigation
Troubleshooting
- The radio must be started on both (START RADIO, notification visible).
- All runtime permissions granted (see Permissions).
- Android 10/11: turn location services on.
- Bluetooth on; keep the phones within a few metres for the first test.
- Watch the log:
adb logcat -s MESH_RADIO.
The phone maker is freezing the app despite the foreground service. See dontkillmyapp.com for your model. Known cases:
- Honor / Huawei (EMUI): the app is frozen when the screen turns off. Open Settings > Apps > NodeWave > Battery > App launch, switch to Manage manually and enable Auto-launch, Secondary launch and Run in background.
- Xiaomi (MIUI): set Battery saver to No restrictions for NodeWave and enable Autostart.
The first message to a node, or after the peer restarted, needs an extra round trip to set up the encrypted session. Subsequent messages are fast.
Stale routes expire after up to about 2.5 minutes (ROUTE_TTL 150 s) if the neighbour announcement was missed.
Tap it to send it again. The failure text says how far it got (for example "120/283 chunks got through"). Over Bluetooth, photos are small; a Wi-Fi Direct link is much faster. Check that the other phone allows fast links (Settings → Wi-Fi Direct).
Photos are refused on slow links and by relays whose next link is slow. This is by design.
Copy the APK to the phone and install it manually.
Open an issue with the phone models, Android versions, app version and the MESH_RADIO log around the failure. For anything that looks exploitable, contact the maintainers privately (see Security).