Editing PLS (file format) (section)

==File format==
The format is case-sensitive and essentially that of an [[INI file]] structured as follows<ref>{{Cite web |title=configparser — Configuration file parser — Python 3.10.5 documentation |url=https://docs.python.org/3/library/configparser.html |access-date=2022-07-22 |website=docs.python.org}}</ref>

'''Header'''
*[playlist] : ''This tag indicates that it is a Playlist File''

'''Track Entry'''<br />
''Assuming track entry #X''
*FileX : ''Variable defining location of media file/stream (like [[M3U|.m3u/.m3u8]] playlists).''
*TitleX : ''Defines track title. (optional)''
*LengthX : ''Length in seconds of track. Value of -1 indicates indefinite (streaming). (optional)''
''If file metadata includes a title already, then the TitleX entry will not be displayed.''

'''Footer'''
*NumberOfEntries : ''This variable indicates the number of tracks and therefore equals the number used for the last track''
*Version : ''Playlist version. Currently only a value of 2 is valid.''

===Examples===
Example of a complete PLS file used for "streaming audio;" in this case, to connect to a particular online radio station and receive its audio stream:
<syntaxhighlight lang="ini">
[playlist]
File1=https://e20.yesstreaming.net:8279/
Title1=Here enter name of the station
NumberOfEntries=1
</syntaxhighlight>

Alternative Example containing local paths:
<syntaxhighlight lang="ini">
[playlist]

File1=https://e20.yesstreaming.net:8279/
Length1=-1

File2=example2.mp3
Title2=Just some local audio that is 2mins long
Length2=120

File3=F:\Music\whatever.m4a
Title3=absolute path on Windows

File4=%UserProfile%\Music\short.ogg
Title4=example for an Environment variable
Length4=5

NumberOfEntries=4
Version=2
</syntaxhighlight>

;Unix/BSD/Linux/OS X
In [[Unix|Unix-like]] operating systems absolute and relative file paths differ from Windows, because there are no drive letters, [[Environment variable]]s differ and [/] (forward slashes) are used as directory separators instead of [\] (backslashes). Therefore, playlists pointing to absolute paths or media files outside of the folder containing the playlist will only work for one type of operating system - either Windows or Unix-like. [[URL|URLs]] work the same for all types.

To make the second example from above work the 3rd and 4th path need to be changed to something like:
<syntaxhighlight lang="ini">
File3=/media/hdd/whatever.m4a
File4=~/Music/short.ogg
</syntaxhighlight>