Difference between revisions of "PLS"

From VideoLAN Wiki
Jump to navigation Jump to search
m (Added page to Category:File and protocol types, c/e, added wikilinks)
m (Add wikilink to Character encoding)
 
(3 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
'''.pls''' files are a type of [[playlist]]. This playlist is a text document with the following format:
 
'''.pls''' files are a type of [[playlist]]. This playlist is a text document with the following format:
<span style="color:#A00"><B>[playlist]</B></span>
+
<syntaxhighlight lang="ini">
  <span style="color:#A00"><B>NumberOfEntries=</B></span>4
+
[playlist]
  <span style="color:#A00"><B>File1=</B></span>/fs/My Music/Eloy/02 Journey into 1358.mp3
+
  NumberOfEntries=4
  <span style="color:#A00"><B>File2=</B></span><nowiki>http://some.website.com/music.mp3</nowiki>
+
  File1=/fs/My Music/Eloy/02 Journey into 1358.mp3
  <span style="color:#a00"><B>File3=</B></span>//NETWORKCOMPUTER/Videoclips/A12345.mp4
+
  File2=http://some.website.com/music.mp3
  <span style="color:#080"><B>Title3=</B></span>A Short Videoclip
+
  File3=//NETWORKCOMPUTER/Videoclips/A12345.mp4
  <span style="color:#A00"><B>File4=</B></span>''any url to file''
+
  Title3=A Short Videoclip
 +
  File4=''any url to file''
 +
</syntaxhighlight>
  
The [[VLC media player]] requires the parameter in dark red. The parameter "Title(n)" is optional, but if presented with it, VLC will display the title in its [[Titlebar]], and in case of video material the title will be briefly displayed on the screen at the beginning. The tile may not be displayed if a non-Latin [[character set]] is used, e.g., containing diacritical marks like ñ, é, ö, etc. If such characters are required the file should be saved in [[UTF-8]] format (quality text editors generally offer this option)
+
The VLC media player requires the parameter in dark red. The parameter "Title(n)" is optional, but if presented with it, VLC will display the title in its Titlebar, and in case of video material the title will be briefly displayed on the screen at the beginning. The tile may not be displayed if a non-Latin character set is used, e.g., containing diacritical marks like ñ, é, ö, etc. If such characters are required the file [[Character encoding|should be saved in UTF-8 format]] (quality text editors generally offer this option)
  
 
===Troubleshooting ===
 
===Troubleshooting ===
If an existing playlist does not work, check that it has the "NumberOfEntries" parameter at the beginning (some media players do not require it). Also make sure that the file is saved as an [[ANSI]]-text file and that the last line is finished off with a line break.
+
If an existing playlist does not work, check that it has the "NumberOfEntries" parameter at the beginning (some [[media player]]s do not require it). Also make sure that the file is saved as an ANSI-text file and that the last line is finished off with a line break.
  
[[Category:File and protocol types]]
 
 
[[Category:Playlist]]
 
[[Category:Playlist]]

Latest revision as of 03:29, 24 March 2019

.pls files are a type of playlist. This playlist is a text document with the following format:

 [playlist]
 NumberOfEntries=4
 File1=/fs/My Music/Eloy/02 Journey into 1358.mp3
 File2=http://some.website.com/music.mp3
 File3=//NETWORKCOMPUTER/Videoclips/A12345.mp4
 Title3=A Short Videoclip
 File4=''any url to file''

The VLC media player requires the parameter in dark red. The parameter "Title(n)" is optional, but if presented with it, VLC will display the title in its Titlebar, and in case of video material the title will be briefly displayed on the screen at the beginning. The tile may not be displayed if a non-Latin character set is used, e.g., containing diacritical marks like ñ, é, ö, etc. If such characters are required the file should be saved in UTF-8 format (quality text editors generally offer this option)

Troubleshooting

If an existing playlist does not work, check that it has the "NumberOfEntries" parameter at the beginning (some media players do not require it). Also make sure that the file is saved as an ANSI-text file and that the last line is finished off with a line break.