App Settings

Server Configuration

Displays a card view of the detected media server.

Enable

Disabled servers will not be available for selection in certain pop-ups or lists.

Status

Previously discovered servers may appear as OFFLINE if not yet discovered on the network; active servers are ONLINE. Read only.

IP

IP address of the device. Read only.

UDN

Unique Device Name, identifies the device on the network. Read only.

MY PLAYLIST — ObjectID

Media server ObjectID of a folder containing playlists. Usually configured automatically by the UI; once set, the playlists from that folder appear in the sidebar.

Note — If the server’s database is recreated or reindexed, the ObjectID may change and has to be set again.

ID3 Rating

If checked, enables reading and writing star ratings to audio file metadata, if the format supports it.

Note — Only available for the UMS media server (fork).

Renderer configuration

Displays a card view of the detected media renderers. Offline renderers may appear if not yet discovered; disabled renderers are excluded from selection lists.

Device driver

A device driver lets nextCP/2 control the device your streamer feeds its audio into — typically an integrated amplifier — and take over its power, volume and balance from the UI. These are hardware functions of the amplifier that UPnP alone cannot reach.

Typical setup. A network streamer (e.g. a LUMIN) is connected to an input of the amplifier (e.g. a McIntosh MA9000) — for example over USB — and feeds it the audio; the amplifier drives the speakers.

How nextCP/2 reaches the amplifier depends on the device:

• Network-controllable amplifiers are driven directly over TCP/IP.
• Serial-only amplifiers that offer just RS232 need a small, optional TCP/IP ↔ RS232 bridge that puts the serial port on the network (see the README for a tested adapter such as the USR-TCP232-302). The bundled McIntosh MA9000/MA12000 driver uses this path.

What changes once a device driver is configured:

• The volume slider in the UI now controls the amplifier instead of the streamer — the audiophile path, where the volume is done in the amp.
• The power button in the UI likewise targets the amplifier.
• Optionally, the streamer is forced to 100 % (no attenuation, so it no longer controls the volume) via the UPnP/streamer max volume option — only the amplifier then changes the level.
• Default volume and balance can be applied automatically when the amplifier is powered on.

Settings

amplifier type

Select the device driver, e.g. MA9000 for McIntosh amplifiers.

amplifier driver connection

Connection string (host:port) to the amplifier or, for serial-only amps, to the RS232 bridge — e.g. 192.168.112.37:12345.

amplifier on power default volume

Volume applied to the amplifier when it is powered on, e.g. 10.

amplifier default balance

Balance applied to the amplifier when it is powered on, e.g. -3.

UPnP/streamer max volume

If checked, sets the UPnP/streamer to maximum (100 %) on power-on, so all volume control happens in the amplifier.

Server Actions

Additional UMS server actions, available when the active media server is a UMS instance.

rescan media library

Rescans the UMS media library. Can be resource-intensive on large libraries.

backup liked albums

Backs up UMS liked albums to a separate file on the UMS server, so they can be restored if the library is deleted.

restore liked albums

Restores liked albums from a backup file, if one exists.

import rating from musicBrainz.org

Imports star ratings from the musicbrainz.org account configured under Accounts.

App Behavior

Reload page on focus

When enabled, returning to the tab/window reloads the current page. This is a browser-local preference (stored per browser), not part of the server configuration.

General Configuration

device driver library path

Where to look for amplifier device drivers. McIntosh amplifiers such as MA9000 / MA12000 (and similar) should work.

database path

Where nextCP/2 stores its internal settings.

unsecure server listening port

The HTTP port you connect to with your browser.

path to restart script

Full path to a restart script; read access is required.

Note — Experimental — may not work.

Log4j config file

Where to look for a Log4j2 configuration file.

Behind reverse proxy

Trust the X-Forwarded-* headers so nextCP/2 reconstructs the correct external scheme and host when TLS terminates at a proxy. Enable only when nextCP/2 is reachable solely through a trusted proxy — see running behind a reverse proxy. Default: off.

SSE heartbeat interval

Interval in seconds for the Server-Sent-Events keep-alive ping that stops proxies from dropping the live /SSE and /mcp streams. Set 0 to disable. Default: 30.

Show image items while browsing

When off (default), image items are hidden while browsing. Many folders and playlists carry their cover as an image file in the same directory, which otherwise clutters the listing and makes it hard to tell folders from images. Enable to list image items as well.

SSL

secure server listening port

The HTTPS listening port. Works only if a P12 keystore is configured below.

P12 keyfile file location

Path to the nextCP/2 keystore for secure connections. Must be in P12 format.

P12 keyfile password

Password for the P12 keystore.

UPnP

Generate UPnP code

If true, JUPnP access wrappers are generated for discovered UPnP services.

bind interface stream server

Leave empty to bind to all interfaces. Changes require a restart.

Note — If nextCP/2 runs inside a Docker container, select the host interface here.

path for generated UPnP code

Folder where generated UPnP code is saved.

Browser Player

transcode before streaming

Applies to the built-in browser player (“This device”). If checked (default), a track that needs transcoding is fully transcoded before playback starts, enabling correct duration display and seeking. Uncheck for lower latency, at the cost of seeking on transcoded tracks.

cache directory

Directory where transcoded audio for the browser player is cached. Leave empty to use the system temp directory.

cache max size

Maximum size of the transcode cache in MB. Set 0 for unlimited.

cache idle TTL

How long (in hours) a cached transcode is kept after its last use. Set 0 to keep entries until the next restart.

AI Configuration

Configures the built-in AI chat assistant. Changes are applied immediately after saving — no restart is required. For provider setup examples (Google Gemini, OpenWebUI) and troubleshooting, see AI Configuration.

Caution

The AI feature is experimental and under active development — these settings may change with any release.

AI enabled

Master switch for the AI assistant feature.

AI provider

Selects the active provider: google (Gemini) or openai (OpenAI and OpenAI-compatible endpoints like OpenWebUI). Switching providers saves the current settings to a per-provider profile and restores the settings last used with the newly selected provider.

Base URL

Only for OpenAI-compatible endpoints; disabled for Google. Enter the API root, e.g. http://localhost:3000/api for OpenWebUI.

Note — Do not append /v1 or /chat/completions — these are added automatically.

API key

Provider API key. Required for Google; for OpenAI-compatible endpoints it depends on the server.

Model

The model to use. The list is fetched live from the provider and can be filtered by typing.

Send nextCP tools

If checked (default), nextCP/2 sends its built-in tools (device selection, radio playback, language switching) to the model. Uncheck if your endpoint provides its own server-side tools.

Conversation memory

If checked, recent messages of the conversation are sent as context with each request, so follow-up questions work. Increases token usage. Default: off.

Tool IDs

OpenWebUI only: comma-separated list of server-side tool IDs to attach to each request, or * to use all tools registered on the endpoint.

Server-side tools

OpenWebUI only: if the endpoint exposes tools, they are listed as checkboxes for granular selection.

Accounts

Spotify

Connect your Spotify account to enable discovery of artist album art. If the browser is connected to localhost, a one-step linking process is available. Otherwise the authCode must be copied manually into the provided code block.

Last.fm

The account can be connected, but the API is not used yet.

System Information

Build information is displayed here.