Skip to content
DocumentationConnecting the band

Connecting the band

The ideal is that a band member types nothing at all: they open sync, the session is there, they tap it. In most networks that is exactly what happens. This page is about the rest of the cases.

How devices find each other

The leader starts a session and it announces itself on the network. Other phones look for it in two ways at once:
  • The fast way — on ordinary home or rehearsal-room networks the session shows up within seconds.
  • The slower way — it walks the network address by address. This works even where the fast way is blocked, which tends to mean hotel and club Wi-Fi.
ℹ

Both run at the same time, not one after the other. If the fast way does not work on your network, the session still turns up — just a little later.

Addresses where the band was last seen are tried first, so the second and every later connection to the same band is usually instant.

When discovery is not enough

QR code

The leader shows a QR code, the member scans it with the built-in reader, and they are connected. This skips discovery entirely, which makes it the most reliable route on a crowded or restricted network. The session password is carried inside the code, so nobody types it.

A typed address

The session list has an option to type an address by hand. The leader has it written on their sync screen — reading it out loud is enough.

Session password

The leader can lock a session with a PIN. Without it nobody gets in, even if they can see the session. Connecting by QR code fills the PIN in automatically.

It is worth using in places where strangers share the network — a festival, or a rehearsal room you share with other bands.

What the network needs

ConditionWhy
Everyone on the same Wi-FiDiscovery and connection only work inside one network. One on Wi-Fi and one on mobile data will never meet
Client isolation offPlenty of hotel and club Wi-Fi forbids devices from talking to each other
VPN offA VPN diverts traffic away from the local network
No internet is required. When the club network is unreliable, the most dependable fix is a hotspot from one phone — everyone joins that and you keep playing, even if the whole building is offline.

Permissions on iOS

On the first attempt iOS asks whether the app may use the local network. Discovery does not work without it. The dialog appears only once — if you declined it, the permission lives in iOS Settings → Eutepio → Local Network.

Permissions on Android

Android needs nothing granted specially. So that sync survives the screen going dark, a notification runs for the duration of the session — leave it alone, it is what keeps the connection alive.

Troubleshooting

The session does not appear on the other device

  1. Check that both devices are on the same Wi-Fi — not one on Wi-Fi and one on mobile data.
  2. Check whether the network has client isolation on (typical of public and hotel Wi-Fi).
  3. Turn off VPNs on both devices.
  4. Try the QR code — it skips discovery entirely.
  5. If nothing helps, make a hotspot from one phone and join that.

The connection drops while playing

The usual causes are roaming between access points and a power-saving mode that puts the network to sleep. The app tries to reconnect on its own; what happens to the song you were on is covered in When things drift apart.

A typed address fails but the QR code works

When the usual address is taken by another app, the session comes up slightly to the side. Discovery and the QR code both account for that; a typed address cannot. Use the QR code in that situation.