Configure the player using system.ini — My Music Player and My Music Player LE

Modified on Tue, 27 Oct at 5:45 PM

In addition to configuration through the front-panel user interface or the web server, the player can be configured using a configuration file. This allows a content update method to configure the player when neither physical access nor access to its web server is available. It also allows a large number of devices to be configured using a USB flash drive and a copy script.


Principle

During startup, the player applies the instructions in the system.ini configuration file previously copied to the SYSTEM folder on the Main Media, then deletes the file.

The configuration file is an unformatted plain-text file named system.ini. It can be created using a basic text editor such as Windows Notepad. Save it using ANSI encoding. Only the 7-bit ASCII character set is permitted, and special characters outside the list below are excluded. Some characters prohibited by Microsoft conventions for file and folder names are also excluded.


Characters permitted in the configuration file

0 1 2 3 4 5 6 7 8 9 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z a b c d e f g h i j k l m n o p q r s t u v w x y z ! # $ % & ' ( ) + , - . ; = @ [ ] ^ _ ` { } ~ (Space)

A configuration file contains seven types of sections:

  1. [multimedia]: general player settings.
  2. [system]: player system settings.
  3. [audio]: audio settings.
  4. [ftp]: FTP client settings.
  5. [network]: network settings.
  6. [webradio]: web radio settings.
  7. [webserver]: player web server settings.

Each section starts with its name between [ ] on a separate line, followed by one or more parameter lines. Only one parameter is accepted per line. Each parameter line contains the parameter name, followed by = and its value. Empty lines are ignored.

Parameters included in the configuration file overwrite the corresponding internal player settings. Other internal settings are not affected.


Example configuration file structure

[section name]
first parameter name=value assigned to the parameter
second parameter name=value assigned to the parameter
etc.

Note: To restore the player’s factory settings, perform a firmware update with settings reset


Configuration parameters

[multimedia] section

ParameterDefaultPossible valuesDescription
MainSourceNOMEDIAMy Music Player LE: NOMEDIA or USB. My Music Player: NOMEDIA, USB-EXT, USB-INT, SD-CARD or HDD-INT.Defines the connector used by the Main Media.
StartupPlaybackSourceOFFOFF, MUS, PLS, WEBRADIO, LAST or SCHEDULER; AUX-INPUT on My Music Player only.Playback source at player startup.
StartupPlaybackModeRNDRND, RND+RST, SEQ or SEQ+RST.Playback mode when MUS or PLS is selected for Autoplay.
StartupPlaybackID11 to 999 for MUS and PLS; 1 to 10 for WEBRADIO.Folder or web radio number when MUS, PLS or WEBRADIO is selected for Autoplay.
Cache32032 to 10240.Total web radio cache size in kB.
CacheMin200 to 99.Minimum percentage of the cache that must be filled before web radio playback resumes.
WRadioFailureFolderID11 to 999.Number of the MUSIC folder played when the web radio stream is lost.
WRadioFailureTimeOut2020 to 999.Stream stability duration in seconds before web radio playback starts.
CacheUnderrunPause00 (disabled) or 1 (enabled).Enables or disables pausing web radio playback when its cache is empty, instead of switching to a fallback folder.
CacheOverrunSkip00 (disabled) or 1 (enabled).Enables or disables skipping part of the received web radio stream when the server overloads the cache.


[system] section

ParameterDefaultPossible valuesDescription
BannerMy Music PlayerMaximum 16 characters.Default name on the first line of the front-panel home screen.
UserPassEmptyFour digits from 0 to 9.Password for user access to the front-panel Advanced menu.
AdminPassEmptyFour digits from 0 to 9.Password for administrator access to the front-panel Advanced menu.


[audio] section

ParameterDefaultPossible valuesDescription
MasterVolume00 to -64.Main volume attenuation.
VolumeOutRCA00 to -64.RCA audio output volume attenuation.
VolumeOutXLRAmp00 to -64.Volume attenuation of the XLR outputs on My Music Player or amplified outputs on My Music Player LE.
GainOutRCA00 to 9.Gain level of the RCA audio outputs.
GainOutXLRAmp00 to 9.Gain level of the XLR outputs on My Music Player or amplified outputs on My Music Player LE.
PlayerVolume00 to -64.Audio file playback volume attenuation.
WebradioVolume00 to -64.Web radio playback volume attenuation.
AuxVolume00 to -64.Auxiliary input playback volume attenuation (My Music Player only).
FadeOut00 to 5.Fade-out duration in seconds.
FadeIn00 to 5.Fade-in duration in seconds.


[ftp] section

In parameter names, x is the FTP client number from 1 to 10.

ParameterDefaultPossible valuesDescription
MediaUpdatePassEmptyMaximum 32 characters.Password for the copy script’s compressed ZIP file.
FTPWaitRetry50 to 999.Wait in seconds before reconnecting the player to an FTP server after disconnection.
FTPTries50 to 99.Number of connection attempts before cancelling the FTP update.
FTPPassive00 (disabled) or 1 (enabled).Enables or disables passive mode, which determines how the FTP connection port is established.
FTPxNameEmptyMaximum 255 characters.Arbitrary name of the FTP client.
FTPxHostEmptyMaximum 255 characters.FTP server address (URL).
FTPxPort211 to 65535.FTP connection port number.
FTPxUserEmptyMaximum 255 characters.Username for FTP server access.
FTPxPassEmptyMaximum 255 characters.Password for FTP server access.
FTPxFolderEmptyMaximum 255 characters.Path on the FTP server from which the update is performed.
FTPxModeSyncSync or Script.Content update mode with the FTP server.
FTPxSyncIncludeEmptyMaximum 255 characters.List of file and folder paths to include in FTP synchronization.
FTPxSyncExcludeEmptyMaximum 255 characters.List of file and folder paths to exclude from FTP synchronization.


[network] section

ParameterDefaultPossible valuesDescription
Dhcp10 (disabled) or 1 (enabled).Enables or disables automatic network configuration via DHCP.
IpAddr0.0.0.0000.000.000.000 to 255.255.255.255.Player’s static IP address when DHCP is disabled.
IpMask0.0.0.0000.000.000.000 to 255.255.255.255.Subnet mask address when DHCP is disabled.
Gateway0.0.0.0000.000.000.000 to 255.255.255.255.Network gateway IP address when DHCP is disabled.
Dns10 (disabled) or 1 (enabled).Enables or disables automatic DNS domain name resolution.
PrimaryDns0.0.0.0000.000.000.000 to 255.255.255.255.Primary DNS server IP address when automatic DNS is disabled.
AlternativeDns0.0.0.0000.000.000.000 to 255.255.255.255.Secondary DNS server IP address when automatic DNS is disabled.


[webradio] section

In parameter names, x is the web radio number from 1 to 10.

ParameterDefaultPossible valuesDescription
WRadioxNameEmptyMaximum 255 characters.Arbitrary web radio name.
WRadioxIpEmptyMaximum 255 characters.Web radio MP3 stream or M3U playlist address.


[webserver] section

ParameterDefaultPossible valuesDescription
UserNameuserMaximum 32 characters.Username of the user account.
UserPassuserMaximum 32 characters.Password of the user account.
AdminNameadminMaximum 32 characters.Username of the administrator account.
AdminPassadminMaximum 32 characters.Password of the administrator account.


Example configuration file

[multimedia]
StartupPlaybackSource=SCHEDULER
WRadioFailureFolderID=45

[audio]
PlayerVolume=-10
WebradioVolume=0
FadeIn=2
FadeOut=2

[ftp]
FTP1Name=My Server
FTP1Host=ftp.server.access.com
FTP1Port=21
FTP1User=PlayerAccess
FTP1Pass=PWD123
FTP1Folder=Group1/
FTP1Mode=Sync
FTP1SyncInclude=
FTP1SyncExclude=

[webradio]
WRadio1Name=Rock Radio
WRadio1Ip=http://my.webradio.com/rock-stream.mp3
WRadio2Name=Soul Radio
WRadio2Ip=http://other.webradio.eu/live/soul-stream.mp3

[webserver]
AdminPass=AdminAccess
AdminName=123456
UserName=ClientAccess
UserPass=AbCdEf


In this example:

  1. Startup playback follows the Scheduler programming: [multimedia], StartupPlaybackSource=SCHEDULER.
  2. The MUS045 music folder is played when the web radio stream is lost: [multimedia], WRadioFailureFolderID=45.
  3. Audio files are played with a volume attenuation of -10, while web radios are played without attenuation: [audio], PlayerVolume=-10 and WebradioVolume=0.
  4. Fade-in and fade-out between playback sources each last 2 seconds: [audio], FadeIn=2 and FadeOut=2.
  5. FTP client 1 is configured in [ftp]:
    • Name: My Server — FTP1Name=My Server.
    • Server address: ftp.server.access.com — FTP1Host=ftp.server.access.com.
    • Connection port: 21 — FTP1Port=21.
    • Username: PlayerAccess — FTP1User=PlayerAccess.
    • Password: PWD123 — FTP1Pass=PWD123.
    • Server path: Group1/ — FTP1Folder=Group1/.
    • Content update mode: FTP synchronization — FTP1Mode=Sync.
    • Included paths: empty — FTP1SyncInclude=.
    • Excluded paths: empty — FTP1SyncExclude=.
  6. Web radios 1 and 2 are configured in [webradio]:
    • Web radio 1 name: Rock Radio — WRadio1Name=Rock Radio.
    • Web radio 1 stream address: http://my.webradio.com/rock-stream.mp3 — WRadio1Ip=http://my.webradio.com/rock-stream.mp3.
    • Web radio 2 name: Soul Radio — WRadio2Name=Soul Radio.
    • Web radio 2 stream address: http://other.webradio.eu/live/soul-stream.mp3 — WRadio2Ip=http://other.webradio.eu/live/soul-stream.mp3.
  7. Player web server access is configured in [webserver]:
    • Administrator password: AdminAccess — AdminPass=AdminAccess.
    • Administrator username: 123456 — AdminName=123456.
    • User username: ClientAccess — UserName=ClientAccess.
    • User password: AbCdEf — UserPass=AbCdEf.

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article