Nullsoft SHOUTcast DNAS Server v2.2.1

(Last Updated 29 November 2013)



Now that you have downloaded the SHOUTcast DNAS server, you will find all associated documentation, some configuration examples and related files to aid with getting the SHOUTcast DNAS Server up and running. You can check what changes and fixes have been made with this release by looking through the provided changelog.

The documentation and related files provided with the DNAS server are the correct for the version of the DNAS server version installed. You can also find online copies of the documentation via the wiki however these may not relate to the DNAS Server version installed. If in doubt use the local documentation provided with the DNAS server being used.


Core


sc_serv[.exe] - The SHOUTcast DNAS Server program file (this is required)

setup[.bat/.sh] - Command used to run the DNAS server in 'Setup Mode' which allows for quick setup of the DNAS Server (recommended if you need a simple setup or are new to setting up a DNAS server)

builder[.bat/.sh] - Command used to run the DNAS server in 'Configuration Builder' mode which allows for making more complex setups (use if 'Setup Mode' is not suitable or you want to control more of the DNAS server's features)


Documentation


These are all supporting documentation provided with the DNAS server for how to get it setup to what the JSON response for bandwidth usage should look like and everything in-betweeen it as anything relating to the DNAS server is included in the documentation.

Getting Started - Guide for setting up and configuring the DNAS Server for use

DNAS Server - Core documentation for the DNAS Server's options and features from how to run it to the public and private API methods it provides

Authhash Management - How to manage authhashes inside the DNAS Server

JSON Responses - Documentation showing the JSON responses available

XML Responses - Documentation showing the XML responses available


Examples



It is recommended to use the 'Setup Mode' and 'Configuration Builder' actions for most setup needs.

These examples are provided as a means to see what a working configuration file looks like under some of the common usage cases for a DNAS server.

To use these examples, you will need to copy the requried files (check the dependencies noted)into the folder where sc_serv[.exe] is and after reading and editing them as needed, then start the DNAS start with the one required (which may be easier if you rename the intended file as sc_serv.conf so the DNAS will automatically load it)..

examples/sc_serv_simple.confSimple configuration file for running a basic DNAS Server. This has no dependencies on the other examples.

examples/sc_serv_basic.confThis is used by the sc_serv_public.conf and sc_serv_relay.conf to show how core settings can be shared between configurations.

examples/sc_serv_public.confThis has a dependency upon sc_serv_basic.conf.

examples/sc_serv_relay.confThis has a dependency upon sc_serv_basic.conf.<

examples/sc_serv_debug.confThis can be included in other configuration files to enable the specified debugging options as needed. By default this will enable all debugging output which may not be useful if looking into a specific issue so edit this as needed.

examples/crossdomain.xmlExample crossdomain.xml file for use with the examples


Miscellaneous


These are supporting files mainly relating to the setup options and the configuration examples. If in doubt then do not alter any of the files as this may break other features (especially if altering the 'setup' and 'config_builder' folders.

setup folder - This contains files needed for the DNAS Server's 'Setup Mode'. Do not modify or run this separately as it will not work unless run within the DNAS server. To run the 'Setup Mode', run setup[.bat/.sh]

config_builder folder - This contains the files needed for the DNAS Server's 'Configuration Builder' mode. Do not modify or run this separately as it will not work unless run within the DNAS server. To run the 'Configuration Builder' mode, run builder[.bat/.sh]

control folder - Used with the configuration examples to hold the sc_serv.ban and sc_serv.rip files generated by the DNAS Server when it is running

logs folder - Used with the configuration examples to hold the DNAS Server log files


tos.txt - SHOUTcast Terms of Service (TOS) details (non-Windows only)

uninstall_shoutcast-dnas-v2.exe - Uninstaller for the DNAS Server (Windows only)