Difference between revisions of "Setup Start Parameter"

From MSX - Wiki
Jump to navigation Jump to search
 
(16 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
Create a JSON file with the [[Start Object]] and host it under URL <code>http://{SERVER}/msx/start.json</code>. The <code>{SERVER}</code> part is entered via the Media Station X application as hostname or IP address.
 
Create a JSON file with the [[Start Object]] and host it under URL <code>http://{SERVER}/msx/start.json</code>. The <code>{SERVER}</code> part is entered via the Media Station X application as hostname or IP address.
  
'''Note: Since version 0.1.88, you can also load the start parameter via HTTPS (i.e. <code>https://{SERVER}/msx/start.json</code>) by setting the security lock during setup. Please note that the security lock is only applied to the start parameter file, for the other JSON files, you must always indicate full URLs that have to start with the protocol (i.e. <code>http://</code> or <code>https://</code>). Please also note that if the Media Station X application is loaded via HTTPS (i.e. https://msx.benzac.de), the security lock must always be set and all JSON files and plugins must be provided via HTTPS (the application will automatically update the protocol from <code>http://</code> to <code>https://</code> for these URLs). In a secure context, it is also recommended to provide all media content (i.e. videos, audio files, and images) via HTTPS to avoid mixed content issues (the application will not update the protocol for these URLs).'''
+
'''Note: Since version 0.1.88, you can also load the start parameter via HTTPS (i.e. <code>https://{SERVER}/msx/start.json</code>) by setting the security lock during setup. Please note that the security lock is only applied to the start parameter file, for the other JSON files, you must always indicate full URLs that have to start with the protocol (i.e. <code>http://</code> or <code>https://</code>). Please also note that if the Media Station X application is loaded via HTTPS (i.e. https://msx.benzac.de), the security lock must always be set and all JSON files and plugins must be provided via HTTPS (the application will automatically update the protocol from <code>http://</code> to <code>https://</code> for these URLs). In a secure context, it is also recommended to provide all media content (i.e. videos, audio files, and images) via HTTPS to avoid mixed content issues (the application will not update the protocol for these URLs). Since version 0.1.140, you can adjust the protocol update settings with a URL parameter. Please see the <code>secure</code> parameter from the [[URL Parameters]].'''
  
 
If the JSON file is hosted, please go to your corresponding application store, install and launch the '''Media Station X''' application, navigate to '''Settings''' → '''Start Parameter''' → '''Setup''', and follow the setup instructions. Once you have completed the start parameter setup, your content is loaded every time you start the application.
 
If the JSON file is hosted, please go to your corresponding application store, install and launch the '''Media Station X''' application, navigate to '''Settings''' → '''Start Parameter''' → '''Setup''', and follow the setup instructions. Once you have completed the start parameter setup, your content is loaded every time you start the application.
  
Please see [https://msx.benzac.de/info/?tab=PlatformSupport Platform Support] for corresponding application stores.
+
For corresponding application stores, please visit: https://msx.benzac.de/info/?tab=PlatformSupport.
  
 
== Example Screenshot (Setup Start Parameter) ==
 
== Example Screenshot (Setup Start Parameter) ==
{|
+
[[File:start.png|thumb|640px|none|For this example screenshot, the requested URL is <code>http://192.168.0.10:8080/msx/start.json</code>.]]
| https://msx.benzac.de/info/img/start.png
+
 
|-
+
== Example Screenshot (Complete Start Parameter) ==
| For this example screenshot, the requested URL is <code>http://192.168.0.10:8080/msx/start.json</code>.
+
[[File:complete.png|thumb|640px|none|After the start parameter has been successfully loaded, you can set it up. For this example screenshot, the start parameter is a menu with URL <code>http://192.168.0.10:8080/msx/menu.json</code>.]]
|}
+
 
 +
== Example Screenshot (Configured Start Parameter) ==
 +
[[File:holiday.png|thumb|640px|none|After the start parameter has been set up, your content is loaded every time you start the application. If your content can not be loaded, you will get an error message at startup. You can change or reset the start parameter at any time via the settings.]]
 +
 
 +
== Content Examples ==
 +
[[File:screens2.png|thumb|640px|none|Some example screenshots of how you can customize your content.]]
 +
 
 +
== See also ==
 +
* [[Start Object]]
 +
* [[Setup Precondition]]

Latest revision as of 16:36, 9 August 2021

Create a JSON file with the Start Object and host it under URL http://{SERVER}/msx/start.json. The {SERVER} part is entered via the Media Station X application as hostname or IP address.

Note: Since version 0.1.88, you can also load the start parameter via HTTPS (i.e. https://{SERVER}/msx/start.json) by setting the security lock during setup. Please note that the security lock is only applied to the start parameter file, for the other JSON files, you must always indicate full URLs that have to start with the protocol (i.e. http:// or https://). Please also note that if the Media Station X application is loaded via HTTPS (i.e. https://msx.benzac.de), the security lock must always be set and all JSON files and plugins must be provided via HTTPS (the application will automatically update the protocol from http:// to https:// for these URLs). In a secure context, it is also recommended to provide all media content (i.e. videos, audio files, and images) via HTTPS to avoid mixed content issues (the application will not update the protocol for these URLs). Since version 0.1.140, you can adjust the protocol update settings with a URL parameter. Please see the secure parameter from the URL Parameters.

If the JSON file is hosted, please go to your corresponding application store, install and launch the Media Station X application, navigate to SettingsStart ParameterSetup, and follow the setup instructions. Once you have completed the start parameter setup, your content is loaded every time you start the application.

For corresponding application stores, please visit: https://msx.benzac.de/info/?tab=PlatformSupport.

Example Screenshot (Setup Start Parameter)[edit]

For this example screenshot, the requested URL is http://192.168.0.10:8080/msx/start.json.

Example Screenshot (Complete Start Parameter)[edit]

After the start parameter has been successfully loaded, you can set it up. For this example screenshot, the start parameter is a menu with URL http://192.168.0.10:8080/msx/menu.json.

Example Screenshot (Configured Start Parameter)[edit]

After the start parameter has been set up, your content is loaded every time you start the application. If your content can not be loaded, you will get an error message at startup. You can change or reset the start parameter at any time via the settings.

Content Examples[edit]

Some example screenshots of how you can customize your content.

See also[edit]