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 address of the device. Read only.

UDN

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

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 (version 16 or newer).

The sidebar’s MY PLAYLISTS section has no setting here any more: it lists the playlists you liked, wherever they are stored — see Music Library.

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.

The driver is picked on the renderer’s card; the tune button next to it opens its settings in a dialog of their own. A renderer whose driver is not configured yet says so on the card.

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.

Device details

Every media server and media renderer can be asked what it is and what it can do: the info button next to a device in the server and renderer selection popups, or details on its card here in the settings.

Device

Manufacturer, model and model number — for UMS the model number is its version —, serial number, address, UDN and, if the device offers one, a link to its own web interface.

Features

Media servers only: every capability nextCP/2 knows, the ones this server offers highlighted. This is the answer to “why does nextCP/2 not offer me X with this server”. The line below lists the criteria the server can be searched on.

Services

Every UPnP service the device announces, with its version; unfold one to see its actions and the state variables it sends events for. A service whose description could not be read shows no actions and says so.

copy as text

Puts the whole dialog into the clipboard, for a bug report or a forum post.

The capabilities are read from what a device announces, not from its version, so a server that is one release behind, a build with a feature switched off and a development build that is ahead of both each answer for themselves. What each capability enables is listed under What depends on the media server.

Server Actions

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

Rating Actions

backup ratings

Writes every rating the media server holds — star ratings and the likes of albums and playlists — to a backup file on the server, so they survive a library that has to be rebuilt.

restore ratings

Reads that backup back into the media server’s library.

Other Actions

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

Audio format for the browser player

How audio is delivered to This Device. Automatic (default) streams lossless where the browser can decode it and transcodes where it cannot; Always lossless never transcodes; Always transcoded always does, which saves bandwidth. When automatic has fallen back to transcoded audio — no FLAC support in this browser, or a failed playback — a note below the field says so and offers to try lossless again.

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.

Audio Addict Radio Network

Credentials of a paid Audio Addict subscription (DI.fm, Radio Tunes, Jazz Radio, …). nextCP/2 does not stream these networks itself — it passes the account on to the media server, which then offers their stations under Radio Networks in the sidebar.

username

Account name of the subscription.

password

Account password. It is stored encoded in the nextCP/2 configuration and handed to the media server.

prefer european server

If checked, the media server picks a European streaming server.

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.

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.

MusicBrainz

Username and password of your musicbrainz.org account. With it, star ratings of tracks carrying a MusicBrainz Track ID can be written to that account, and import rating from musicBrainz.org under Server Actions reads them back.

Last.fm

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

System Information

Build information is displayed here.