App Settings

Server Configuration

Displays a card view of the detected media server.

field	purpose
Enable	Disabled Renderers 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 server are ONLINE. This attribute is read only.
IP	IP address of the device. This attribute is read only.
UDN	Unique Device Name, identifies the device on the network. This attribute is read only.
MY PLAYLIST - ObjectID	Enter the media server ObjectID of a folder containing playlists. Typically configured automatically by the UI. Once set, the playlists from that folder will appear in the sidebar. NOTE: If the servers database is recreated or reindexed, the ObjectID of the playlist folder may change and has to be set again.
ID3 Rating	If checked enables reading and writing star ratings to audio file metadata, if supported by the audio file format. NOTE: Only available for UMS media server (fork).

Renderer configuration

Displays a card view of the detected media renderer. Offline Renderers: May appear as offline if not yet discovered. Disabled Renderers: Will not be available for selection in certain pop-ups or lists.

device driver

If the media renderer is connected to a physical receiver or AV device with remote control capability (e.g., via RS232 or TCP/IP), a device driver can be used to control volume and balance directly. A Device driver for McIntosh devices is available for download.

field	purpose
amplifier type	Select the device driver i.e. MA9000 for McIntosh amplifiers.
amplifier driver connection	Enter the driver connection string. For MA9000 driver i.e. 192.168.112.37:12345.
amplifier on power default volume	Restores the amplifier volume to a predefined level when powered on, i.e. 10.
amplifier default balance	Restores the amplifier balance to a predefined level when powered on, i.e. -3.
UPnP/streamer max volume	If checked, restores the UPnP/streamer to max volume (100%) when powered on.

Server Actions

Here are additional UMS server actions available, if the active media server is an instance of UMS.

Button	Action
rescan media library	Rescans UMS media library. Attention: This can be resource consuming on large media libraries!
backup liked albums	Backs up UMS liked albums in a separate backup file on the UMS server. In case the UMS media library is deleted, liked albums can be restored afterwards.
restore liked albums	Restored liked albums from a backup file, if exists.
import rating from musicBrainz.org	Restores star rating from configured musicbrainz.org account below.

General Configuration

Property	description
device driver library path	Where to look for amplifier device drivers. Currently McIntosh amplifier like MA9000, MA12000 and other should work.
database path	Where to store internal settings.
unsecure server listening port	This is the port you connect to with your browser.
secure server listening port	This is the the https listening port. Secure listen port works only if P12 keystore path is configured.
P12 keyfile file location	Path to NextCP/2 keystore for using secure connections. File format has to be in P12 format.
P12 keyfile password	P12 keystore password.
path to restart script	Full path to the restart script. Read access to this resource is needed.NOTE: This feature is experimental and may not work.
Log4j config file	Where to look for a log4j2 config file.
Logging date format	To adjust logging date format. Use the Log4j2 syntax.
bind interface stream server	Leave empty for binding to all interfaces. Changes require restart. NOTE: If NextCP/2 is running inside a docker container, select the host interface here!
Generate UPnP code	If set ti TRUE, JUPnP UPnP access wrapper are generated for discovered UPnP services.
path for generated UPnP code	This is the folder where generated UPnP code will be saved to.

AI Configuration

Configures the built-in AI chat assistant. NOTE: The AI feature is experimental and under active development — settings may change with any release. Changes are applied immediately after saving — no restart is required. For provider setup examples (Google Gemini, OpenWebUI) and troubleshooting see AI Configuration.

field	purpose
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, i.e. 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 connection linking process is available. If the browser is not connected to localhost, the authCode must be copied manually into the provided code block.

Last FM

Account can be connected, but API is not used yet.

System Information

Build information are displayed here.