Find your way around the admin console
Every AudioSilo server has a built-in admin console. It is a web page served by the server itself, so there is nothing to install. You use it to manage libraries, books and people, see who is listening, and look after the server.
Only admin accounts can use the console.
Opening the console
The console lives at /admin on your server. If your server runs at
https://audiobooks.example.com, open:
https://audiobooks.example.com/admin
Signing in
Sign in with the admin username and password created when you first set up the server (see Set up your server). On a new server, signing in first opens the Set up your server flow.
A regular listener account can't sign in here. Listeners connect their devices with invites instead.
The Language selector under the sign-in card changes the console's language. Once you are signed in, it is in your account menu.
You can install the console as an app. Open it over HTTPS (or on localhost)
and your browser offers to install it.
The layout
The bar along the top of every page has:
- The AudioSilo mark, which takes you to the overview. Beside it are the server's name and whether it is online.
- Five destinations: Library, People, Activity, Health and Server. Each has its own sections in a row under the top bar.
- Search, which opens the command palette.
- The Notifications bell (see Notifications), a theme menu and your account menu.
On a phone the destinations move to a tab bar at the bottom of the screen.
What each section is for:
| Where | What it's for |
|---|---|
| Library > Books | Every book, with filters, bulk edits and each book's own page. See Fix book details. |
| Library > Authors, Series, Narrators | Merging two spellings of a name, and the books missing from a series. See Authors and narrators. |
| Library > Folders | How AudioSilo reads each folder. See The Folders page. |
| Library > Libraries | Add, edit, rescan, export and delete libraries. See Add and manage libraries. |
| Library > LibriVox | Search LibriVox and have your Bridge add a free book to a library. See Add free books from LibriVox. |
| People > People and Invites | Accounts and invite links. See Invite people. |
| People > Shares | Named sets of folders you give to people. See Sharing. |
| People > Devices | Every signed-in phone, browser and API key. See The Devices page. |
| Activity | Listening over time, who is playing now, every session and a year in review. See See who is listening. |
| Health > Issues | Books that could be better, each with a fix. See Library health. |
| Health > Jobs | Scans running, waiting and finished. See Jobs. |
| Health > System | Everything the server depends on, with a status for each. See System. |
| Server > Settings | The server's settings by topic. See Settings. |
| Server > Logs, Audit log and About | The server's log, what admins changed, and updates. See Server settings, updates and logs. |
The overview
The overview is the console's home page. It shows:
- Listening now: a card for each device playing or paused in the last ten minutes. Click one to see its details in Activity > Live now.
- Totals: books, libraries, people and books in progress.
- Recent listening: who listened to what, and how far they got.
- Needs attention: the kinds of library issue that have something in them. Triage opens Library health.
- Books per library. A count that looks wrong is a cue to check that library's folder detection.
- Server: the version, whether a newer one is out, and which features are on.
A notice appears at the top when a library's folder can't be read (see When a library folder goes missing). Another appears when saved settings wait for a restart (see When a change takes effect). While books are not matched to community metadata, a third says how many, with Match automatically. Library > Books shows the same notice.
A new server with no libraries shows an Add your first library button instead. Until you dismiss it, a Finish setting up card lists any setup steps you skipped.
The support card
AudioSilo is free, with nothing held back. Once your server has been in use for a while, the overview shows a small Support AudioSilo card with a link to GitHub Sponsors. It first appears 30 days after the server's first account was made, or after 7 days once 10 books have been finished.
- Sponsor on GitHub opens GitHub Sponsors in a new tab.
- I've donated hides the card for good.
- Not now hides it for six months.
Your answer counts for every admin on the server. Nothing is checked or sent anywhere, and a donation unlocks nothing: every feature is there either way. Only admins see the card, never listeners. Support AudioSilo stays in the account menu and on Server > About.
Search and commands
Press Ctrl K (⌘K on a Mac) or click the search box to open the command palette. Type to filter, use the arrow keys to move and press Enter to open.
- Actions: invite someone, add a library, rescan a library or every library, open the web player, or sign out.
- Go to: any destination or section.
- Settings: any Server > Settings topic, the scan schedules, the themes and the console's languages.
Type two letters or more to search your books, people, authors, series, narrators and shares. The last entry, "Search all books for ...", opens Library > Books with what you typed.
