Difference between revisions of "M3U/PLS Files"
Line 6: | Line 6: | ||
There is also a launcher service that allows you to launch the Media Station X application directly with an M3U playlist: https://msx.benzac.de/info/m3u.html. | There is also a launcher service that allows you to launch the Media Station X application directly with an M3U playlist: https://msx.benzac.de/info/m3u.html. | ||
− | '''Note: For HTTP Live Streaming (HLS) files (i.e. M3U8 files), please use the video/audio action (e.g. <code>video:http://link.to.hls.m3u8</code>), because these URLs are only suitable for converting simple playlist files. Please note that this is an online service. Therefore, only publicly available playlist files can be converted. Please also note that no URLs or | + | '''Note: For HTTP Live Streaming (HLS) files (i.e. M3U8 files), please use the video/audio action (e.g. <code>video:http://link.to.hls.m3u8</code>), because these URLs are only suitable for converting simple playlist files. Please note that this is an online service. Therefore, only publicly available playlist files can be converted. Please also note that no URLs or playlist files are stored persistently on MSX servers. There is only a session-based storage for performance reasons. Generally, it is more recommended to host JSON files instead of converting playlist files as they provide much more functionality.''' |
== Syntax == | == Syntax == |
Revision as of 12:56, 21 September 2022
It is possible to convert M3U/PLS files to JSON files (i.e. Media Station X content pages) with following URLs.
- M3U:
http://msx.benzac.de/services/m3u.php?headline={HEADLINE}&background={BACKGROUND}&type={TYPE}&mode={MODE}&url={URL}
- PLS:
http://msx.benzac.de/services/pls.php?headline={HEADLINE}&background={BACKGROUND}&type={TYPE}&mode={MODE}&url={URL}
There is also a launcher service that allows you to launch the Media Station X application directly with an M3U playlist: https://msx.benzac.de/info/m3u.html.
Note: For HTTP Live Streaming (HLS) files (i.e. M3U8 files), please use the video/audio action (e.g. video:http://link.to.hls.m3u8
), because these URLs are only suitable for converting simple playlist files. Please note that this is an online service. Therefore, only publicly available playlist files can be converted. Please also note that no URLs or playlist files are stored persistently on MSX servers. There is only a session-based storage for performance reasons. Generally, it is more recommended to host JSON files instead of converting playlist files as they provide much more functionality.
Syntax[edit]
Parameter | Type | Default Value | Mandatory | Since Version | Description |
---|---|---|---|---|---|
headline |
string |
"Playlist" |
No | 0.1.30 |
The headline of the content page. It is recommended to encode the value to ensure that it is evaluated correctly (e.g. |
background |
string |
null |
No | 0.1.30 |
The background image of the content page. It is recommended to encode the value to ensure that it is evaluated correctly (e.g. |
type |
string |
"audio" |
No | 0.1.30 |
The type of the content page items.
|
mode |
string |
"default" |
No | 0.1.30 |
The mode of the content page.
|
url |
string |
null |
Yes | 0.1.30 |
The URL of the M3U/PLS file. It is recommended to encode the value to ensure that it is evaluated correctly (e.g. |
Example[edit]
Screenshot[edit]
Code[edit]
{
"headline": "Playlist Examples",
"menu": [{
"type": "separator",
"label": "Playlist Data"
}, {
"icon": "movie",
"label": "Videos",
"extensionLabel": "Default",
"data": "http://msx.benzac.de/services/m3u.php?type=video&url=http://msx.benzac.de/info/data/m3u/videos.m3u"
}, {
"icon": "movie",
"label": "Videos",
"extensionLabel": "Extended",
"data": "user:http://msx.benzac.de/services/m3u.php?type=video&mode=extended&url=http://msx.benzac.de/info/data/m3u/videos.m3u"
}, {
"icon": "music-note",
"label": "Audios",
"extensionLabel": "Default",
"data": "http://msx.benzac.de/services/m3u.php?type=audio&url=http://msx.benzac.de/info/data/m3u/audios.m3u"
}, {
"icon": "music-note",
"label": "Audios",
"extensionLabel": "Extended",
"data": "user:http://msx.benzac.de/services/m3u.php?type=audio&mode=extended&url=http://msx.benzac.de/info/data/m3u/audios.m3u"
}, {
"type": "separator"
}, {
"label": "Playlist Actions",
"data": {
"template": {
"type": "control",
"layout": "0,0,12,1",
"color": "msx-glass"
},
"items": [{
"icon": "msx-white-soft:movie",
"label": "Show video playlist",
"action": "content:http://msx.benzac.de/services/m3u.php?type=video&url=http://msx.benzac.de/info/data/m3u/videos.m3u"
}, {
"icon": "msx-white-soft:movie",
"label": "Start video playlist",
"action": "playlist:http://msx.benzac.de/services/m3u.php?type=video&url=http://msx.benzac.de/info/data/m3u/videos.m3u"
}, {
"icon": "msx-white-soft:music-note",
"label": "Show audio playlist",
"action": "content:http://msx.benzac.de/services/m3u.php?type=audio&url=http://msx.benzac.de/info/data/m3u/audios.m3u"
}, {
"icon": "msx-white-soft:music-note",
"label": "Start audio playlist",
"action": "playlist:http://msx.benzac.de/services/m3u.php?type=audio&url=http://msx.benzac.de/info/data/m3u/audios.m3u"
}, {
"icon": "msx-white-soft:image",
"label": "Show slideshow",
"action": "content:http://msx.benzac.de/services/m3u.php?type=image&url=http://msx.benzac.de/info/data/m3u/images.m3u"
}, {
"icon": "msx-white-soft:image",
"label": "Start slideshow",
"action": "slideshow:http://msx.benzac.de/services/m3u.php?type=image&url=http://msx.benzac.de/info/data/m3u/images.m3u"
}]
}
}]
}