Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Web UI

The Web UI is mostly self-explanatory so this is just a quick tour, plus the handful of things that are only reachable through it (that is, not exposed to Subsonic clients).

Hover on the screenshot to see Light/Dark modes.

Public homepage

Your configured http://<host>:<port>/ (or your external_hostname) shows a public homepage.

If public_now_playing is enabled, a card displays the currently playing track (off by default).

Public homepage

Public shares

TODO

Admin dashboard

The dashboard is organized into tabs. Most settings are editable live, those that require a server restart to take effect are clearly marked.

A setting that is already pinned by a CLI flag, an environment variable, or a config.yaml value shows as locked/disabled from the Web UI.

See Configuration reference for the precedence rules.

Users

Create/update/delete users, toggle their roles, manage avatars, and see or revoke their app passwords.

Users

Connections

Your existing app passwords and signed-in web sessions.

Connections

Playlists

Browse and play playlists, and export them as M3U or CSV (see Moving a playlist to a streaming service).

Server

Every Server & Network related setting.

Server settings

Library

Every Library & Metadata related setting.

Library settings

Audio

Every Audio & Jukebox related setting.

Audio settings

Security

Live view of the current IP allow/deny lists and rate-limit state (see Security). Allows adding/removing entries, and clearing rate-limit buckets.

Security tab

Podcasts & radio

Add/refresh/delete podcast subscriptions and internet radio stations.

Radio discovery (when enable_radio_discovery is on) allows you to find new stations.

Radio stations

Podcasts

Artists

Browse, search, add or replace artist images, and fetch the missing ones from external services (see Library augmentation).

Artist images

Shares

View, edit and revoke any active public share.

Shares

Chat moderation

View the full chat log, edit/delete any user’s message for moderation, or post server announcements.

Chat moderation

Beets

Interact with the Beets installation: view Beets’ config.yaml (editing it needs to be allowed at server startup) and run imports (interactive, pinned and watched folders).

See Beets import for the details.

Beets configuration and import

Notifications

Create and manage notifications sent through Apprise (imports, blocked logins, health scans, new shares…).

Notifications

Maintenance

Trigger a library health scan (see Encoding errors detection & self-healing streams), cleanup BeetstreamNext’s database, clear disk caches, and view the server logs.

Maintenance