Troubleshooting the Android app
Android app
Pictures
| Problem | What to do |
|---|---|
| Portraits and generated pictures are missing in the app but show in a browser | Fixed in app 0.12.5 and 0.12.6 (an https app page could not load pictures from an http home server, and a cache poisoned by a host behind Cloudflare). Update the app. |
| Token faces or icons missing on the board | Fixed in 0.11.0 and 0.12.4. Update the app. |
| Covers and faces on the home screen are missing | Fixed in app 0.15.6 (a cover whose name held a space, and pictures behind a server's login). Update the app. |
| Pictures come in slowly on a shared world | Generated art travels through the host's tunnel. Ask the host to turn pictures to fast quality, or off, in the Setup tab. |
Screens
- The game screens look unstyled (plain text, no panels). The system WebView is older than Chrome 120. Update Android System WebView and Chrome in Google Play, then reopen the app.
- The audio and dice panel did not load. Fixed in 0.12.1. Update the app.
- A page will not scroll, or a page change freezes for seconds. Fixed in 0.12.3. Update the app.
- An older host opens its own pages inside the app. Expected for a server below 0.21.0; the Visiting hosts switch in Settings covers hosts between 0.16.0 and 0.20.x. Ask the host to update.
Hosting
- Friends say the host keeps dropping. The phone is killing the background server. Keep the world shared (the notification is what protects it), exempt the app from battery optimisation, and avoid swiping it out of recents. A LAN-only world with no share stops when the app is in the background.
- "Opening a public address..." never finishes. The tunnel helper could not connect. Check the network (a captive portal or a strict corporate Wi-Fi blocks it), or try mobile data.
- The app was slow or froze while hosting. Fixed in app 0.14.0, which moved the server's stop and start off the main thread, sized its memory to the phone and capped its logs. Update the app.
- The lobby says another device holds your room code. Take the new code it offers.
Permissions
- The app closed when it asked for a permission (signing in, scanning a QR code, the microphone, notifications or Bluetooth). Fixed in app 0.15.6. Update the app.
- No microphone prompt. It was denied earlier. Settings, Apps, Open Dungeon Master, Permissions, Microphone.
- Scan a QR code does nothing. Camera permission was denied, or the device has no camera. Type the code instead.
- No hosting notification. Notifications were denied; hosting still works, but the phone may stop the server sooner. Allow notifications for the app.
Links and codes
- An invite link opens the browser instead of the app. The Play listing's signing certificate is not yet verified for
opendungeonmaster.comlinks, so the confirmation page opens; it offers the app. Anodm://link always opens the app. - "No table is online with that code". The host is not sharing. Ask them to open the campaign.
Reporting a problem
Open an issue with the app version (Settings, This app), the phone model and Android version, whether the world was hosted on the phone or joined, and what you saw. If the problem is with a host, say which server version it runs (About this server in the account menu). Quick questions are welcome on the Discord.