Invite people

There are two ways to give someone access to your server:

• Invite them as their own account. You make the invite in the admin console and choose what they can listen to. Use this for anyone you want to manage yourself: friends, family in another home, other adults.
• Add them as a household member. Anyone with an account can add the kids and grown-ups they live with from the player, with no invite from you. The person who adds them manages them. See Add your household.

Several people sharing one phone or tablet? Each signs in with their own account and switches between profiles. To give someone only some of your books, see Limit what someone can see.

Everything below is in People in the admin console, and needs an admin.

Inviting someone

1. Click Invite someone (on the People or Invites page).
2. Enter Their name.
3. Optionally, enter a Password (optional) of at least 8 characters. It lets them sign in with their name and password too, in the web player or the app. Leave it empty and they pair their devices with the link only.
4. Choose What can they listen to?: All libraries, one library, one of your shares, or Decide later.
5. Choose how many Devices it can pair (5 by default) and when it Expires after (7 days by default).
6. Click Create invite.

The invite shows a QR code, an Invite link and the Code on its own.

• Share opens your device's share sheet with a short message and the link. Where the browser has no share sheet, it copies them instead.
• They can use the same link on each of their devices until it runs out.
• To scan the QR code, they open the AudioSilo app and tap Scan a QR code. The phone's camera app opens the invite page in the browser instead, which doesn't sign the app in.

See Connect the app to your server for what they see, on a computer and on a phone.

The code is shown only this once. To send a fresh one later, rotate the invite.

The new account isn't an admin.

All libraries gives them each library you have now. Give them any library you add later from their page.

When the link only works nearby

The invite link uses the server's public address, else the address you opened the console at. A notice under Share says when that limits who can open it:

• Only this computer can open this link: the link points at localhost. Set a public address in Server > Settings > General, or open the console at the server's network address, then make a new invite.
• Works on your home network only: to invite someone elsewhere, set a public address.
• Their browser will warn about the certificate: the server uses its own self-signed certificate, or the link is https:// at an IP address, which rarely has a certificate browsers trust. The notice says which. They can continue past the warning, or you can set a public address with a real certificate.

The People page

People > People shows everyone as a card. It shows whether they are listening now or when they were last active, the book they are in the middle of, and their devices. A household is grouped into one block. Click a card to open that person's page.

A person's page

A person's page has six tabs: Listening, Access, Devices, Invites, Sign-in and Account.

Pair a device in the header makes a new invite for this person, for a new phone or a lost link. It replaces any invite they already have. Your own page's Pair a device is where you find a QR code for your own phone.

Listening

Their listening this year, the books in progress and finished, and their recent sessions. Each book has a ... menu to edit their progress. If you imported their history, an Imported history card lists each import with Undo.

Access

What this person can listen to: whole libraries and shares.

• Give access adds a library or share.
• Remove takes one away.

They see the change the next time their app refreshes. Someone with no access can sign in but sees no books. Admins always see everything.

For a household member, a card above says what they get through the person who added them. Anything you give them here comes on top.

Devices

Their signed-in devices, each with Sign out, and their personal API keys, each with Revoke.

Sign out everywhere signs them out of every phone, tablet and browser at once. Household members signed in on those devices are signed out too. Their password and API keys don't change. To get back in, they sign in with their password, or you send them a new invite.

Invites

Their invites, with Rotate and Revoke, as on the Invites page.

Sign-in

• Set a password (or Change password) - at least 8 characters. A password lets them sign in to the web player by username. Changing a password signs them out everywhere. Kids have no password.
• Revoke recovery code - only shown if they saved one from an older app.

Account

• Role - Member or Admin. An admin sees every library and can use the console. Making someone an admin asks for a password if they don't have one.
• Household - see Household members.
• Danger zone - disable or delete the account.

Last active is the last time any of their devices talked to the server.

Household members

People add the kids and grown-ups they live with from the player's Household page, with no invite from you. Each household member is a real account with its own progress, managed by the person who added them (the owner). The owner chooses what they can listen to, and manages their devices.

You control this in two places:

• Server > Settings > Household turns it on or off for the whole server and sets how many members each person can add. See Household.
• Can add household members, on a person's Account tab, turns it off for just that person.

On a member's Account tab you can also:

• Make independent - take them out of the household, as an ordinary account you manage. They keep their progress.
• Assign to someone - move them to another person's household. This also works for an ordinary account, such as one you made for a child earlier.

Deleting an owner deletes their members too, unless you untick them in the delete dialog.

Editing someone's progress

The ... menu beside each book on a person's Listening tab (or beside each listener on a book's page) offers:

• Mark as finished (with Undo) or Mark as not finished.
• Edit dates... - when they started and finished the book.
• See listening sessions - opens Activity > Sessions.

A device that is still playing the book saves its own position again within moments.

The Devices page

People > Devices lists every signed-in device and API key on the server: its name, app, owner and when it was last seen.

Sign out (or Revoke for an API key) stops that one device at once. The person's other devices stay signed in. To sign out all of someone's devices, use Sign out everywhere on their page.

A browser you sign out here is announced as a new sign-in if it signs in again.

The Invites page

People > Invites lists every invite, with who it is for, how many devices it has paired and when it expires. An invite is Active, Used up or Expired.

One active invite per user

Each person has at most one active invite. Making a new one, or rotating an old one, stops their other invites working.

Rotating and revoking

• Rotate gives the invite a new code, with a fresh expiry. The old link and QR code stop working at once.
• Revoke removes the invite.

Either way, devices already paired stay signed in. To stop someone's devices working, disable the account.

Disabling vs deleting

• Disable account - their devices stop working, but nothing is lost. Enable brings everything back.
• Delete account - permanent. It removes their devices, invites, progress, bookmarks, notes and history. Your audio files are not touched.

When in doubt, disable.

Good to know

• There is always at least one admin. The last admin can't be demoted, disabled or deleted.
• You can't delete, disable or change the role of your own account. Ask another admin.
• A household member can't be an admin. Make them independent first.