Repository navigation
v1.16.0
Highlights
The admin console now runs the server, too
v1.15.0 brought the redesigned console to your library. This release finishes it: health, jobs, listening activity, people and devices, settings, backups, an audit log and notifications all live in /admin now.
Health and jobs
- Issues: missing covers, unmatched books, unreadable files, suspect folders, duplicates and offline libraries, each with a one-click fix and an Ignore.
- Jobs: every scan goes through one queue. You can watch the running scan, stop it or cancel a waiting one, and read the history with its log.
- Scheduled scans per library: every 1-24 hours, or daily at a set time.
- Ignore rules per library (gitignore-style), stored on the server. Your library folder is never written to.
- System: ffmpeg and ffprobe versions, community metadata health, certificates, database size, backups and each library folder's reachability and free space.
Activity and people
- Activity: listening hours, sessions, peak streams and books finished over 7 days to a year, plus a calendar and heatmap, top books, people, authors and narrators, and a started vs finished funnel.
- Live now: every device that is playing, with chapter, app and playback mode.
- Year in listening: a summary of each year.
- Each person gets a Listening tab (their year, in progress, finished and sessions) and a Devices tab, where you can sign a device out.
- Progress actions: mark a book finished or not finished, and correct start and finish dates.
Server operations
- Settings: your config.yaml as a page, one topic at a time: General (a new server name), Network & HTTPS, Players & app links, Community metadata, Transcoding, Demo mode, Backups and Notifications.
- A value set by an
AUDIOSILO_*environment variable is shown and locked. - Settings that need a restart are saved and flagged until you restart.
- A value set by an
- Backups: the whole database, written with
VACUUM INTOto<data>/backups(orbackups.dir). You can back up now, download, delete and restore. A restore is applied on the next start, and the current database is kept as a safety copy first. - Audit log: every admin change, with who made it and how (session, API key or the server itself).
- Notifications: webhook (with an optional HMAC signature), ntfy and Discord, for new books, failed scans, an offline library, a new device, an accepted invite, an available update and a failed backup. A bell in the top bar shows the same feed.
- Update check and logs: About shows whether a newer release exists, with update steps for your install type. Logs shows a live tail of the newest 2,000 lines, with secrets redacted.
Before you upgrade
- Back up your data directory. This release adds three database migrations (0017, 0018 and 0019), which run automatically on first start.
- Scheduled backups are on by default, including on existing installs: daily at 03:00 server time, keeping the newest 7. They go to
<data>/backupsunless you setbackups.dirorAUDIOSILO_BACKUP_DIR. Turn them off under Settings > Backups or withbackups.schedule: off. - The update check is on by default. It asks GitHub Releases for the latest version once a day. The request carries only
User-Agent: AudioSilo/<version>. Turn it off withupdate_check: falseorAUDIOSILO_UPDATE_CHECK=false. - Built with Go 1.26:
/webnow redirects to/web/with a 307 instead of a 301. Browsers and the apps follow either.- An unbracketed IPv6 address with a port (
http://fe80::1:8080) is no longer accepted inpublic_url,metadata.base_urlor notification addresses. Use brackets (http://[fe80::1]:8080).
Other changes
- Fix: after sign-in, the self-service rate limiter could share one bucket between everyone using the same kind of token. Each client is now limited on its own address.
- Library edits: renaming a library no longer triggers a rescan. Only a change to its folder or ignore rules does.
- Read problems: a book whose file can't be read (unreadable, empty, or ffprobe failed) is recorded with the reason and checked again on every scan.
- Listening sessions are built from progress saves. Apps may identify themselves with an
X-AudioSilo-Clientheader. Raw sessions are kept 400 days and then folded into daily totals. Signed-out and expired devices have their stored IP address cleared. - Admin console toolchain: Vite 8, Vitest 5 and ESLint 10.
The player API is unchanged, and every server-side change is additive, so existing iOS, Android and web players keep working.
Admin guides:
- Health: https://docs.audiosilo.app/users/admin/health
- Activity: https://docs.audiosilo.app/users/admin/activity
- Backups: https://docs.audiosilo.app/users/admin/backups
- Notifications: https://docs.audiosilo.app/users/admin/notifications
- Server: https://docs.audiosilo.app/users/admin/server
Native builds embed the web player; ffmpeg/ffprobe are found locally or
auto-downloaded on first use. Prefer Docker for advanced / multi-user
setups: ghcr.io/kodestar/audiosilo-server.