ListenWIFI Troubleshooting Guide (iOS & Android)

Printer Friendly Version

iOS Troubleshooting

- iOS version compatibility issues (especially iPhone 15 / iOS 18): ListenWIFI may crash or freeze on newer iOS versions if not updated.

- Focus Mode interference: Focus or Do Not Disturb modes can block audio or background activity.

- Local Network and Microphone permissions: Ensure ListenWIFI has access to both in iOS Settings.

- Wi-Fi network requirements: Must be on the correct SSID with no captive portal or client isolation.

- Bluetooth routing conflicts: Audio may stop if Bluetooth devices connect/disconnect.

- Venue server issues: If the ListenWIFI server is offline or misconfigured, the app will not function.

Quick iOS checklist:

• Disable Focus/Do Not Disturb
• Grant Local Network and Microphone permissions
• Connect to correct Wi-Fi (no captive portal)
• Turn off Bluetooth temporarily
• Restart the app and device

Android Troubleshooting

- Wi-Fi isolation / AP isolation: Prevents the app from discovering the ListenWIFI server.

- Captive portals blocking LAN access: Login pages block local traffic until accepted.

- Battery optimization killing the app: Android may stop background audio unless battery settings are adjusted.

- Local network permissions: Required for discovery and streaming.

- Bluetooth routing conflicts: Audio may stop when Bluetooth devices connect/disconnect.

- Venue server misconfiguration: Server must be discoverable and properly configured.

Quick Android checklist:

• Disable battery optimization for ListenWIFI
• Connect to correct Wi-Fi (no guest network)
• Ensure no captive portal is active
• Turn off mobile data
• Disable Bluetooth temporarily
• Restart the app

Captive Portal Explanation

- What a captive portal is: A login or terms page shown before granting internet access on public Wi-Fi.

- Why it breaks ListenWIFI: It blocks local network access until the portal is completed, preventing the app

from reaching the server.

- How to detect one: Open http://neverssl.com - if redirected to a login or terms page, a captive portal is

active.

Network Requirements for ListenWIFI

- No captive portal: Must allow immediate access to LAN without login pages.

- No client isolation: Devices must be able to see each other on the network.

- Multicast and mDNS allowed: Required for service discovery.

- Stable DHCP: Devices must receive consistent IP addresses.

- Dedicated SSID recommended: Prevents interference from guest or public networks.

Quick Reference

iOS quick fixes:

- Disable Focus Mode

- Grant all permissions

- Use correct Wi-Fi

- Restart app and device

Android quick fixes:

- Disable battery optimization

- Avoid guest networks

- Turn off mobile data

- Restart app and device

Network quick checks:

- No captive portal

- No AP/client isolation

- Multicast and mDNS enabled

- Stable DHCP

- Server online and reachable