Local Network Connection

Local network connections provide the lowest latency and best synchronization accuracy. This is the recommended connection method when your device is on the same WiFi network as your server.

How It Works

SendSpin Player connects directly to your server over WebSocket on your local network. No internet connection or third-party services are required.

Automatic Discovery

The app uses mDNS/Zeroconf to automatically discover servers on your network:

1. Open the Server List screen
2. Nearby servers appear under Nearby Servers as they’re discovered
3. Tap a discovered server to connect immediately, or tap + to configure it with a nickname

Discovery requires multicast networking support on your WiFi network. Some enterprise or guest networks block multicast traffic.

Manual Configuration

If automatic discovery doesn’t find your server:

1. Tap the + button to open the Add Server wizard
2. Choose your server type (SendSpin or Music Assistant)
3. Select Manual Entry
4. Enter the server’s IP address or hostname
5. Enter the port number (default: 8927)
6. The app will test the connection

Finding Your Server’s IP Address

• Music Assistant: Check the Music Assistant web interface under Settings
• SendSpin Server: Check your server’s console output or your router’s device list

Network Requirements

• Your Android device and server must be on the same local network
• Multicast must be allowed for mDNS discovery (not required for manual connections)
• Port 8927 (or your custom port) must be accessible
• Cleartext (non-TLS) connections are allowed for local servers

Troubleshooting

• Server not discovered: Try manual entry instead. Some routers block mDNS between devices.
• Connection refused: Verify the server is running and the port is correct.
• Timeouts: Check that your device and server are on the same subnet.

See Connection Problems for more help.