Skip to main content

Connect the app to your server

Before you can listen, the iOS and Android apps or the web player must sign in to your server. In the app, a QR code is quickest. Install the app, tap Scan a QR code and scan the code your server shows, with nothing to type.

You do this once per device. The app stays signed in until you sign out, your password changes, or an admin signs the device out.

Sign in the app with a QR code​

  1. Install AudioSilo from the App Store or Google Play. See Get the apps.
  2. Open the app and tap Scan a QR code.
  3. Point the camera at your QR code.

The app signs in to the server and shows Your library is ready.

Where to find your QR code:

  • If you run the server, open the admin console and go to People, your name, then Pair a device. The Connect a phone step of first-time setup shows one too.
  • If someone invited you, it is on your invite page, the page your invite link opens. Open the link on a computer and scan the code from there.

Scan with the app, not with the phone's camera app. The camera app opens a web page instead. An invite's code opens the invite page, and other codes open the web player in the browser.

Each device can scan the same invite's QR code, up to the invite's number of uses.

If someone invited you​

  1. Open the invite link you were sent. It looks like https://books.example.com/connect#code=….
  2. The server's connect page signs the invite in.
  3. Choose where to listen:
    • The QR code: scan it with the app on your phone, as above.
    • Open in app: sign in the app on this device. If nothing happens, the app isn't installed.
    • Open web player: listen in this browser, with nothing to install.

The server's connect page with a pairing QR code, Open in app and Open web player, and the app store links

Opened on a phone, the page leads with getting the app instead of a QR code. Install AudioSilo from the store links on the page, then open the invite link again and tap Open in app. If you typed the code in, keep the page open and come back to it, or enter the code there again. Or tap Open web player to listen in the browser now. An Android phone without Google Play can download the app's APK from the link under the store buttons.

The invite page on a phone: get the app first, the store links, then Open web player and Open in app

tip

Anyone who opens your invite link can sign in as you, so don't post it publicly.

If the invite has expired or is used up, the page says so. Ask for a new one. The admin's side is in Invite people.

Connecting from the app​

In the web player there is nothing to type. It already knows the server it came from, so tap Sign in. If your server has single sign-on, the next step also offers Sign in with and its name. After it, the web player goes back to where you started, such as Add someone or the book you were opening.

The web player's connect screen: the server it belongs to, with Sign in and Try the demo

In the iOS and Android apps, without a QR code:

  1. Under Or enter the server address, enter the address, for example books.example.com, and tap Continue.
  2. Check the server the app found and tap Sign in.
  3. Choose Invite code or Username and password.
  4. Enter your code, or your username and password, and tap Sign in.

If you run the server, your admin username and password work here too. The sign-in step also has No password? Scan a QR code instead, which opens the scanner.

The app adds https:// to the address. Type http:// yourself for a server that only answers plain HTTP. Do the same at home for a server on its default self-signed certificate (see Plain HTTP at home).

If the server can't be reached, check the address for typos and that the server is on. A home address like 192.168.1.20:8080 only works on your home network.

The web player has no scanner. Instead, tap I have a pairing link and paste the link. It's in the same places as your QR code.

An invite code looks like 9M4K-P2TQ-WX7V-3RHD. Many accounts have no password, which is normal. You can set one whenever you like.

When signing in doesn't work​

It saysWhat to do
The invite code didn't workCheck the code for typos.
The invite is used up or has expiredAsk your admin for a new invite.
The username or password is wrongCheck both and try again.
Your account is turned offAsk your admin to turn it back on.
Too many tries from this networkWait as long as it says, then try again.

"Your library is ready."​

The first time a device connects, it shows the server's name and libraries. If you already had a book on the go, it shows where you left off. Tap Start listening to carry on, or Browse the library.

Your library is ready: the server's name and libraries, and Start listening

If the server has no books yet, an admin sees Open the admin console to add a library.

Getting back in after signing out​

The app remembers every server you've used. The connect screen lists them under Reconnect, so you only re-enter your code or password, never the address.

If the server signs this device out while you're using it, a Reconnect bar appears at the top of the screen. Tap it to sign in again.

A password is the most dependable way back in. With one, you can sign in on any device with no code or invite.

Adding more devices later​

You don't need a new invite:

To listen from more than one server, tap Add a server in your profile menu, or in Settings > Accounts and devices. Home and search then cover all of them. Only the iOS and Android apps can do this, because the web player only reaches its own server.

At home and away​

A server can have two addresses. A home address works only on the same network as the server, like http://192.168.1.20:8080. An away address works from anywhere, like https://books.example.com.

When the server has both, the iOS and Android apps use the home address at home and the away address when you're out. They switch by themselves, and a playing book carries on from the same place. Before using the home address, the app checks the server there really is yours.

Your account page lists both addresses. The web player doesn't switch. It keeps the address you opened it at. A watch works the same way as the phone. See Apple Watch and Wear OS.

To listen away from home at all, the server must be reachable from the internet. See Reach your server from outside your home.

If the app doesn't switch to the home address​

  • Does the server know its home address? Your admin sets Home address in Server settings > General. Behind a reverse proxy, see Tell the server its home address.
  • Is your phone on the same network? A guest Wi-Fi network or a VPN can stop the home address answering.
  • Does the home address work from the phone? Open it in the phone's browser, for example http://192.168.1.20:8080/web. If the web player loads, the app can reach it too.
  • Was the address set after the app connected? Close the app completely and open it again.

Good to know​

The web connect page links to the mobile apps in their stores.

On the web, removing a person or server also removes it from the other tabs. Reconnecting checks the server and the person before restoring the saved connection.

  • On a device in kids mode, the app doesn't open links or QR codes. It asks for a grown-up.
  • A link to a book, opened while you're signed out, takes you through signing in and then to the book. That still holds if you sign in by scanning a QR code for the same server.
  • A server behind a sign-in proxy, such as Cloudflare Access, needs the app to send extra headers. Tap Proxy headers on the connect screen before you continue. See Behind a sign-in proxy.
  • Some servers offer a guest demo. The connect screen then shows Try the demo. There is also a public demo.
  • A pairing code made on another device works once, for 10 minutes. A link from an invite works for as many devices as the invite has uses left.