Open main menu
Home
Random
Recent changes
Special pages
Community portal
Preferences
About Wikipedia
Disclaimers
Incubator escapee wiki
Search
User menu
Talk
Dark mode
Contributions
Create account
Log in
Editing
PLS (file format)
Warning:
You are not logged in. Your IP address will be publicly visible if you make any edits. If you
log in
or
create an account
, your edits will be attributed to your username, along with other benefits.
Anti-spam check. Do
not
fill this in!
{{Short description|Multimedia playlist file format}} {{Infobox file format | name = Playlist | extension = {{mono|.pls}} | mime = {{mono|audio/x-scpls}} | owner = | creatorcode = | genre = [[Playlist]] | containerfor = | containedby = | extendedfrom = | extendedto = }} '''PLS''' is a computer [[file format]] for a multimedia [[playlist]]. It is typically used by media players for [[streaming media]] over the Internet, but may also be used for playing local media. For online streaming, typically the .PLS [[Computer file|file]] would be downloaded just once from the media source—such as from an online radio station—for immediate or future use. While most computers and players automatically recognize the .PLS format, the first time a PLS file is used on a computer, the media player's settings may need to be changed to recognize ([[file association|"associated" with]]) .PLS files. PLS was originally developed for use with the museArc<ref>[https://web.archive.org/web/20010125041500/http://www.winamp.com/download/docs/index.jhtml;$sessionid$PF5EUWAABIEFJTN24UKBCYY?filenumber=120&language=english&layout=normal&prevlayout=normal Nullsoft Winamp Online Documentation: The Playlist and Playlist Editor]</ref> audio player software by codeArts, and was later used by [[SHOUTcast]] and [[Icecast]] for [[streaming media]] over the Internet. ==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> ==Compatible media player software== {{category see also|Media players|Tag editors}} [[iTunes]], [[VLC media player]], [[GNOME Videos]], [[RealPlayer]], [[Winamp]], [[Yahoo! Music Jukebox]], [[MediaMonkey]], [[Windows Media Player]], [[AIMP]], [[Kodi (software)|Kodi]], [[Rhythmbox]], [[foobar2000]], [[Audacious (software)|Audacious]] and more than 30 others are able to interpret (open) PLS files. [[Media Player Classic]] with the [[K-Lite Codec Pack|K-Lite]] codec installed does work with PLS format, but still requires the appropriate [[MIME]] or [[file association|file extension associations]]. ==See also== Other playlist file formats: * [[M3U]] — The most common playlist format * [[XML Shareable Playlist Format]] (XSPF) — Xiph.Org Foundation ==References== {{Reflist}}<ref>{{cite web |title=PLS File Extension |url=https://fileinfo.com/extension/pls |access-date=2025-05-09 |website=FileInfo.com}}</ref> <ref>{{cite web |title=PLS File Extension - What is a .pls file and how do I open it? |url=https://filext.com/file-extension/PLS |access-date=2025-05-09 |website=FILExt}}</ref> <ref>{{cite web |title=PLS File Extension – Open .PLS Files |url=https://www.reviversoft.com/en/file-extensions/pls |access-date=2025-05-09 |website=ReviverSoft}}</ref> <ref>{{cite web |title=PLS |url=https://wiki.hydrogenaud.io/index.php?title=PLS |access-date=2025-05-09 |website=Hydrogenaudio Knowledgebase}}</ref>{{Unreferenced section|date=September 2015}} ==External links== * [http://forums.winamp.com/showthread.php?threadid=65772 Unofficial PLS file specification], 2001, winamp.com * [http://gonze.com/playlists/playlist-format-survey.html#PLS A survey of playlist formats], 2003 * [http://schworak.com/blog/e41/extended-pls-plsv2/ PLSv2 play list specification], 2010/2012 * [http://openplsinwmp.codeplex.com/ Open PLS in WMP] [[Category:Playlist file formats]] [[Category:Digital audio]]
Edit summary
(Briefly describe your changes)
By publishing changes, you agree to the
Terms of Use
, and you irrevocably agree to release your contribution under the
CC BY-SA 4.0 License
and the
GFDL
. You agree that a hyperlink or URL is sufficient attribution under the Creative Commons license.
Cancel
Editing help
(opens in new window)
Pages transcluded onto the current version of this page
(
help
)
:
Template:Category see also
(
edit
)
Template:Cite web
(
edit
)
Template:Infobox file format
(
edit
)
Template:Reflist
(
edit
)
Template:Short description
(
edit
)
Template:Unreferenced section
(
edit
)