NextCP/2
This is a web-based UPnP control point focused on audio playback. Most control point applications run on a single device. This control point allows besides a local installation, simultaneous access from any device with a current Chrome based web-browser if installed on a server device like NAS, file-server, Raspberry PI.
The responsive user interface will adapt to most mobile devices. Tablets should be used in landscape mode for best experience. Phones should be used in portrait mode. Browser can be used in any width but look best not larger than 1600px.
Quick Install Guide
Download current release into a folder of your choice. Make sure to use Java JDK 15. Start the application by calling java -jar nextcp2-release.jar. For Windows user an exe file is provided for download (experimental). For Linux/Unix systems with systemd service manager installed a service template can be downloaded here for starting nextcp/2 as a service.
After launching the application navigate with your browser to http://server-ip-address:8085. If the application is started on the local machine browse to http://127.0.0.1:8085. If port 8085 is already in use, edit the file nextcp2config.json located next to your jar file and change property embeddedServerPort to an available port. Further configuration can be done within the application itself. Please refer to GitHub for detailed configuration documentation.
After first startup it is recommended to configure a default client configuration which means choosing a default media server and a default media renderer by navigating to App Settings. Create NEW PROFILE and rename it to a meaningful name, select server and renderer, then press the save button.
In case of using the recommended Universal Media Server (UMS) as media server, unlock API features by editing UMS configuration file UMS.conf and add Restart UMS. Locate UMS server in the Media Server section and enter the configured API key. Press save. Reload the page for changes to be visible.
User Interface
Introduction
This control point put's it focus on providing the best user experience for audio enthusiasts. Controlling other content is also supported but with less UI awareness.
Since most audio UI friendly features use functionality beyond the UPnP specification, special media server API support is required to unlock all features. Currently only Universal Media Server (UMS) supports all features and is therefore the recommended media server.
Additional features supported by UMS
Music Library
While navigating through the media server folders, the displayed layout will change in regard to the content. Folders are subtitled by their name, playlists, images and radio stations are additionally highlighted.
Enter text in search content box to filter displayed items and containers.
Album View
While browsing into an container that consists only of tracks of the same album the view switches to a track based display. Controls functions: Clicking on a title will play the selected track, not adding this item to the current playlist.
In case an album is identified by MusicBrainz-ReleaseId, liking this album is activated by displaying a heart symbol next to the album title. Liked albums have a filled heart symbol otherwise the symbol is outlined. Liked album can then be quick accessed by clicking on My Albums in the side bar.
Songs can be rated 1 to 5 by clicking on the desired star symbol. The rating can be send to musicBrainz.org if the account is configured in app settings. For UMS server: the rating information will be stored in the file itself if the audio file format is supported and audio_update_rating_tag = true property is set in UMS.conf.
Clicking on the three dots will open song options dialog. For UMS server: the song can be added to a server based playlist, if managed_playlist_folder = PATH_TO_FOLDER property is set in UMS.conf and the PATH_TO_FOLDER folder has playlists. If the song is already in this playlist, an error message will appear.
Multi Disc Support
Copy all audio files of your multi disc release in one folder. Songs will be sorted by disk and then by track ID, if songs are tagged with correct numberOfThisDisc ID3 comments.
Multi Disc Support
Playlist view
Browsing into server based playlists switches the display to a track view with small album covers. Clicking on switch view will change the display to an full sized album view.
playlist view
UPnP search
Entering text into the global search box initiates a search done by the media server. Known media server with compatible UPnP search capabilities are Minimserver and Universal Media Server (since 10.6.0). Text will be matched against tracks, albums, playlists and artists. Artist covers are looked up from Spotify, if account is connected. search result
Player Queue
Displays playlist of currently active media player. The active song is highlighted. nextCP/2 supports native OpenHome playlists, as well as self managed playlist for regular UPnP devices without internal playlist support.
Click on any music item to listen to it - playback will continue after the song ends.
Playlist
Now Listening
Displays currently active player song. Song can be added to server playlist or star rated.
Playlist
Radio
First rows consist of self managed Radio stations read from nextCP/2 configuration file. Next section displays radio stations provided by the active player. Click on the play symbol to play an online resource or radio station. Track and album information are updated if supported by the media renderer device.
Radio and online resources
My Albums
Quick access for liked albums. This requires UMS as media renderer.
Radio and online resources
App Settings
Client profiles
Save and select a profile for default media server and media renderer. These defaults are browser specific saved. Repetitive access to the app with the same browser will result in loading the same defaults. A message informs if a default device is not online.
Server Configuration
Card view of discovered media server. Server may be offline, if not yet found. Disabled server will not show up for selection in some popups or lists.
For a discovered UMS server the UMS.conf configured API key should be entered for unlocking all features. Otherwise most audio convenience functions will not work!
Media renderer configuration
Card display of discovered media renderer. Renderer may be offline, if not yet found. Disabled renderer will not show up for selection in some popups or lists.
If the media renderer is attached to a physical receiver / AV-device with remote control capability (in example by a RS232 or TCP/IP port), select a compatible device driver and enter a device driver configuration string. Device driver for McIntosh devices is available for download. It is recommended to set the media renderer volume to 100% if a device driver is selected. The device driver notices a device power on state and will apply a default volume on the physical device after powering up.
If a streaming device is attached to an amplifier, a device device driver can be selected for controlling the amplifier power and volume state instead of the streamer volume and power state. A default volume percentage can be applied to the external amplifier on power up. The streaming device volume can be set to 100% on power up, if UPnP max volume is enabled.
Active Media Server
Here are additional UMS server actions available, if the active media server is an instance of UMS.
  • 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.
  • sync : Restores star rating from stored musicbrainz.org account.
General Settings
  • 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.
  • server listening port : IP port to connect.
  • Log4j config file : Where to look for a log4j2 config file.
  • Logging date format : To adjust logging date format.
  • Generate UPnP code : If enabled, cling UPnP access wrapper are generated for discovered UPnP services.
  • path for generated UPnP code : Directory to store generated UPnP code.
  • Accounts
    Spotify
    Connect to Spotify account for discovering artists album art. If browser is connected to localhost, one step connection linking is availbale. Otherwise the authCode has to be copies manually in the code block.
    Last FM
    Account can be connected, but API is not used yet.
    System Information
    By now, only the build number is displayed.
    Issues
    There might be some usage issues. Feel free to leave a ticket.
    Compatibility
    Browser
    This software is tested with the current Chrome browser on desktop and mobile devices, but should also work with other chromium based browsers like Safari.
    Content Delivery Server (media server)
    By now, only universal media server supports all features and is the recommended media server. This software has also been tested with
    Player (media renderer)
    This software has been tested with