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:
[multimedia]: general player settings.[system]: player system settings.[audio]: audio settings.[ftp]: FTP client settings.[network]: network settings.[webradio]: web radio settings.[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
| Parameter | Default | Possible values | Description |
|---|---|---|---|
| MainSource | NOMEDIA | My 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. |
| StartupPlaybackSource | OFF | OFF, MUS, PLS, WEBRADIO, LAST or SCHEDULER; AUX-INPUT on My Music Player only. | Playback source at player startup. |
| StartupPlaybackMode | RND | RND, RND+RST, SEQ or SEQ+RST. | Playback mode when MUS or PLS is selected for Autoplay. |
| StartupPlaybackID | 1 | 1 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. |
| Cache | 320 | 32 to 10240. | Total web radio cache size in kB. |
| CacheMin | 20 | 0 to 99. | Minimum percentage of the cache that must be filled before web radio playback resumes. |
| WRadioFailureFolderID | 1 | 1 to 999. | Number of the MUSIC folder played when the web radio stream is lost. |
| WRadioFailureTimeOut | 20 | 20 to 999. | Stream stability duration in seconds before web radio playback starts. |
| CacheUnderrunPause | 0 | 0 (disabled) or 1 (enabled). | Enables or disables pausing web radio playback when its cache is empty, instead of switching to a fallback folder. |
| CacheOverrunSkip | 0 | 0 (disabled) or 1 (enabled). | Enables or disables skipping part of the received web radio stream when the server overloads the cache. |
[system] section
| Parameter | Default | Possible values | Description |
|---|---|---|---|
| Banner | My Music Player | Maximum 16 characters. | Default name on the first line of the front-panel home screen. |
| UserPass | Empty | Four digits from 0 to 9. | Password for user access to the front-panel Advanced menu. |
| AdminPass | Empty | Four digits from 0 to 9. | Password for administrator access to the front-panel Advanced menu. |
[audio] section
| Parameter | Default | Possible values | Description |
|---|---|---|---|
| MasterVolume | 0 | 0 to -64. | Main volume attenuation. |
| VolumeOutRCA | 0 | 0 to -64. | RCA audio output volume attenuation. |
| VolumeOutXLRAmp | 0 | 0 to -64. | Volume attenuation of the XLR outputs on My Music Player or amplified outputs on My Music Player LE. |
| GainOutRCA | 0 | 0 to 9. | Gain level of the RCA audio outputs. |
| GainOutXLRAmp | 0 | 0 to 9. | Gain level of the XLR outputs on My Music Player or amplified outputs on My Music Player LE. |
| PlayerVolume | 0 | 0 to -64. | Audio file playback volume attenuation. |
| WebradioVolume | 0 | 0 to -64. | Web radio playback volume attenuation. |
| AuxVolume | 0 | 0 to -64. | Auxiliary input playback volume attenuation (My Music Player only). |
| FadeOut | 0 | 0 to 5. | Fade-out duration in seconds. |
| FadeIn | 0 | 0 to 5. | Fade-in duration in seconds. |
[ftp] section
In parameter names, x is the FTP client number from 1 to 10.
| Parameter | Default | Possible values | Description |
|---|---|---|---|
| MediaUpdatePass | Empty | Maximum 32 characters. | Password for the copy script’s compressed ZIP file. |
| FTPWaitRetry | 5 | 0 to 999. | Wait in seconds before reconnecting the player to an FTP server after disconnection. |
| FTPTries | 5 | 0 to 99. | Number of connection attempts before cancelling the FTP update. |
| FTPPassive | 0 | 0 (disabled) or 1 (enabled). | Enables or disables passive mode, which determines how the FTP connection port is established. |
| FTPxName | Empty | Maximum 255 characters. | Arbitrary name of the FTP client. |
| FTPxHost | Empty | Maximum 255 characters. | FTP server address (URL). |
| FTPxPort | 21 | 1 to 65535. | FTP connection port number. |
| FTPxUser | Empty | Maximum 255 characters. | Username for FTP server access. |
| FTPxPass | Empty | Maximum 255 characters. | Password for FTP server access. |
| FTPxFolder | Empty | Maximum 255 characters. | Path on the FTP server from which the update is performed. |
| FTPxMode | Sync | Sync or Script. | Content update mode with the FTP server. |
| FTPxSyncInclude | Empty | Maximum 255 characters. | List of file and folder paths to include in FTP synchronization. |
| FTPxSyncExclude | Empty | Maximum 255 characters. | List of file and folder paths to exclude from FTP synchronization. |
[network] section
| Parameter | Default | Possible values | Description |
|---|---|---|---|
| Dhcp | 1 | 0 (disabled) or 1 (enabled). | Enables or disables automatic network configuration via DHCP. |
| IpAddr | 0.0.0.0 | 000.000.000.000 to 255.255.255.255. | Player’s static IP address when DHCP is disabled. |
| IpMask | 0.0.0.0 | 000.000.000.000 to 255.255.255.255. | Subnet mask address when DHCP is disabled. |
| Gateway | 0.0.0.0 | 000.000.000.000 to 255.255.255.255. | Network gateway IP address when DHCP is disabled. |
| Dns | 1 | 0 (disabled) or 1 (enabled). | Enables or disables automatic DNS domain name resolution. |
| PrimaryDns | 0.0.0.0 | 000.000.000.000 to 255.255.255.255. | Primary DNS server IP address when automatic DNS is disabled. |
| AlternativeDns | 0.0.0.0 | 000.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.
| Parameter | Default | Possible values | Description |
|---|---|---|---|
| WRadioxName | Empty | Maximum 255 characters. | Arbitrary web radio name. |
| WRadioxIp | Empty | Maximum 255 characters. | Web radio MP3 stream or M3U playlist address. |
[webserver] section
| Parameter | Default | Possible values | Description |
|---|---|---|---|
| UserName | user | Maximum 32 characters. | Username of the user account. |
| UserPass | user | Maximum 32 characters. | Password of the user account. |
| AdminName | admin | Maximum 32 characters. | Username of the administrator account. |
| AdminPass | admin | Maximum 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:
- Startup playback follows the Scheduler programming:
[multimedia],StartupPlaybackSource=SCHEDULER. - The
MUS045music folder is played when the web radio stream is lost:[multimedia],WRadioFailureFolderID=45. - Audio files are played with a volume attenuation of
-10, while web radios are played without attenuation:[audio],PlayerVolume=-10andWebradioVolume=0. - Fade-in and fade-out between playback sources each last 2 seconds:
[audio],FadeIn=2andFadeOut=2. - 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=.
- Name:
- 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.
- Web radio 1 name:
- 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.
- Administrator password:
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article