100% Client-Side Privacy
Adawaty Pro • adawaty-pro.com
48+ Offline Client-Side Converters & Technical Guides
Home / Subtitles, IPTV & Media / PLS / XSPF to M3U / TXT
Read Technical Guides →

PLS / XSPF to M3U / TXT

Convert Shoutcast .pls & XML .xspf audio playlists to M3U or TXT — 100% private client-side processing.

100% Client-Side JS

Active Converter

Smart Auto-Fix:
1. Source File(s) or Paste Input: No file selected
2. Live Output (Editable):
SHOUTcast .PLS & Xiph .XSPF Playlist Translation

PLS / XSPF to M3U / TXT: Converting Internet Radio & VLC XML Playlists

Technical Anatomy of .PLS (INI) and .XSPF (XML) Playlists

Two classic open-source playlist standards still circulate widely across internet radio portals and desktop media players: PLS (originating in Winamp and SHOUTcast) and XSPF (XML Shareable Playlist Format, maintained by the Xiph.Org Foundation and used as VLC's native save format).

A .pls file is an INI document opening with [playlist], pairing indexed keys like File1=http://..., Title1=Station Name, and Length1=-1 (where -1 denotes an infinite live stream), ending with NumberOfEntries=N and Version=2. By contrast, an .xspf file is an XML tree rooted at <playlist xmlns="http://xspf.org/ns/0/"> with <trackList><track><location> entries. Converting either format into universal #EXTM3U unlocks playback on modern mobile apps, car head units, and network audio streamers.

Raw .PLS Radio File vs. Universal #EXTM3U Output

# Input: SHOUTcast / SomaFM Station (groove.pls)
[playlist]
NumberOfEntries=2
File1=https://ice1.somafm.com/groovesalad-128-mp3
Title1=SomaFM: Groove Salad (#1)
Length1=-1
File2=https://ice2.somafm.com/groovesalad-128-mp3
Title2=SomaFM: Groove Salad (#2)
Length2=-1
Version=2

# Converted .M3U Output:
#EXTM3U
#EXTINF:-1,SomaFM: Groove Salad (#1)
https://ice1.somafm.com/groovesalad-128-mp3
#EXTINF:-1,SomaFM: Groove Salad (#2)
https://ice2.somafm.com/groovesalad-128-mp3

Real-World Software & Hardware Ecosystem

Audiophiles and home-automation tinkerers convert .pls and .xspf playlists exported from VLC, Winamp, SHOUTcast, Icecast, SomaFM, and Audacious for playback on Volumio, Moode Audio, Plexamp, Android Auto, Kodi, and MPD (Music Player Daemon).

Troubleshooting & Edge Cases

  • Percent-Encoded file:/// Paths in XSPF: VLC saves local MP3 paths as RFC 3986 URIs like file:///C:/Music/My%20Track.mp3. Check the converted paths if you move the .m3u across Windows and Linux drives.
  • XML Entities (&amp;) in Station Titles: XSPF escapes ampersands in radio station names (e.g., Jazz &amp; Blues); our XML decoder unescapes entities cleanly when writing #EXTINF titles.
  • Out-of-Order PLS Indices: Some hand-edited .pls files skip numbers (File1, File3). Matching entries by index key rather than assuming contiguous numbering prevents mismatched titles and URLs.

Playlist Format Comparison: .PLS vs. .XSPF vs. .M3U

FormatSyntax FamilyNative Origin
.PLSINI [playlist] numbered keysWinamp, SHOUTcast, Icecast, SomaFM
.XSPFXML <trackList><track>VLC Media Player, Xiph.Org, Clementine
.M3U / .M3U8Line-paired #EXTINF directivesUniversal (Kodi, Volumio, Android Auto, Smart TVs)

Consolidating Multiple Radio Stations into One M3U File

Many radio portals force you to download one tiny .pls file per station. Select 20 downloaded .pls files at once using Batch ZIP mode—or paste their contents sequentially into the left editor—to produce one unified radio_favorites.m3u file ready for Volumio, Moode Audio, or Home Assistant media players.

Frequently Asked Questions

How is a Winamp/Shoutcast .PLS file structured compared to .XSPF and .M3U?

.PLS uses an INI-style [playlist] section with numbered File1=, Title1=, Length1= keys and a NumberOfEntries footer. .XSPF (XML Shareable Playlist Format) is an open XML schema wrapping and nodes inside <trackList>.</p></div> <div class="p-3.5 rounded-xl bg-slate-50 dark:bg-slate-800/60 border border-slate-200 dark:border-slate-700"><div class="font-bold text-slate-900 dark:text-white">Why do internet radio directories like SomaFM and Icecast still distribute .PLS files?</div><p class="m-0 mt-1 text-xs text-slate-600 dark:text-slate-300 leading-relaxed">SHOUTcast and Icecast popularized .PLS in the Winamp era because it cleanly lists multiple fallback mirror streams (File1, File2, File3) for a single radio station. Converting to .M3U lets modern smart speakers, car stereos, and IPTV apps play those stations directly.</p></div> <div class="p-3.5 rounded-xl bg-slate-50 dark:bg-slate-800/60 border border-slate-200 dark:border-slate-700"><div class="font-bold text-slate-900 dark:text-white">Does converting VLC's .XSPF playlist to .M3U preserve track titles and local file URIs?</div><p class="m-0 mt-1 text-xs text-slate-600 dark:text-slate-300 leading-relaxed">Yes. The parser reads both <title> and <location> tags from every <track> element in the XML tree and writes clean #EXTINF:-1,Title and URI pairs into the output .M3U.</p></div> <div class="p-3.5 rounded-xl bg-slate-50 dark:bg-slate-800/60 border border-slate-200 dark:border-slate-700"><div class="font-bold text-slate-900 dark:text-white">Can I extract just the raw streaming URLs from a .PLS or .XSPF file as plain .TXT?</div><p class="m-0 mt-1 text-xs text-slate-600 dark:text-slate-300 leading-relaxed">Yes. Choose Export .TXT to dump every clean stream URL and station name without playlist directives—handy for pasting into Home Assistant, Sonos custom radio, or curl/FFmpeg scripts.</p></div></div> </div> <div class="pt-4 border-t border-slate-200 dark:border-slate-700 space-y-3"> <h3 class="text-base font-extrabold text-slate-900 dark:text-white">Related Converters & Tools</h3> <div class="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-4 gap-3"><a class='p-3 rounded-xl bg-slate-50 dark:bg-slate-800/60 border border-slate-200 dark:border-slate-700 hover:border-emerald-500 transition block no-underline' href='/tools/m3u-cleaner'><div class="text-xs font-black text-emerald-700 dark:text-emerald-400">M3U / M3U8 Cleaner →</div><div class="text-[11px] text-slate-500 dark:text-slate-400 mt-0.5">Deduplicate & inspect Extended M3U playlists</div></a> <a class='p-3 rounded-xl bg-slate-50 dark:bg-slate-800/60 border border-slate-200 dark:border-slate-700 hover:border-emerald-500 transition block no-underline' href='/tools/txt-csv-to-m3u'><div class="text-xs font-black text-emerald-700 dark:text-emerald-400">TXT / CSV to M3U →</div><div class="text-[11px] text-slate-500 dark:text-slate-400 mt-0.5">Build custom M3U playlists from spreadsheets</div></a> <a class='p-3 rounded-xl bg-slate-50 dark:bg-slate-800/60 border border-slate-200 dark:border-slate-700 hover:border-emerald-500 transition block no-underline' href='/tools/xml-to-excel-json'><div class="text-xs font-black text-emerald-700 dark:text-emerald-400">XML to Excel / JSON →</div><div class="text-[11px] text-slate-500 dark:text-slate-400 mt-0.5">Inspect raw XSPF or RSS XML feeds</div></a> <a class='p-3 rounded-xl bg-slate-50 dark:bg-slate-800/60 border border-slate-200 dark:border-slate-700 hover:border-emerald-500 transition block no-underline' href='/tools/cfg-ini-to-json-txt'><div class="text-xs font-black text-emerald-700 dark:text-emerald-400">CFG / INI to JSON →</div><div class="text-[11px] text-slate-500 dark:text-slate-400 mt-0.5">Convert INI-style config files to JSON</div></a></div> </div> <div class="pt-4 border-t border-slate-200 dark:border-slate-700 space-y-2.5"> <h3 class="text-base font-extrabold text-slate-900 dark:text-white">Deep-Dive Technical Guides on Adawaty Pro</h3> <div class="grid grid-cols-1 md:grid-cols-2 gap-3"><a class='p-3 rounded-xl bg-emerald-50/70 dark:bg-emerald-950/30 border border-emerald-500/25 hover:border-emerald-500 transition flex items-center justify-between gap-2 no-underline' href='/blog/m3u-m3u8-iptv-playlist-cleaning-guide'><span class="text-xs font-bold text-slate-800 dark:text-slate-100"><i class="fa-solid fa-book-open text-emerald-600 mr-1.5"></i>Organizing Streaming & Radio Playlists with Extended M3U</span><span class="text-xs font-black text-emerald-600 shrink-0">Read Guide →</span></a></div> </div> </section> </main> <footer class="bg-slate-900 text-slate-300 border-t border-slate-800 py-8 mt-14 text-xs"> <div class="app-container flex flex-wrap items-center justify-between gap-4"> <div> <div class="font-bold text-white">Adawaty Pro — adawaty-pro.com</div> <div class="text-slate-400 mt-1">All Rights Reserved © 2026 • 100% Client-Side File Conversion Platform</div> </div> <div class="flex flex-wrap gap-5 font-semibold"> <a class='text-slate-300 hover:text-emerald-400' href='/'>Home</a> <a class='text-slate-300 hover:text-emerald-400' href='/blog/'>Guides / Blog</a> <a class='text-slate-300 hover:text-emerald-400' href='/about'>About Us</a> <a class='text-slate-300 hover:text-emerald-400' href='/privacy-policy'>Privacy Policy</a> <a class='text-slate-300 hover:text-emerald-400' href='/terms'>Terms of Use</a> <a class='text-slate-300 hover:text-emerald-400' href='/contact'>Contact</a> </div> </div> </footer> <script src="../assets/converter-engine.js"></script> </body> </html> <script async id="netlify-rum-container" src="/.netlify/scripts/rum" data-netlify-rum-site-id="fcb8bdbb-8fa6-4c59-bfe6-4d31251de03c" data-netlify-deploy-branch="" data-netlify-deploy-context="production" data-netlify-cwv-token="eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzaXRlX2lkIjoiZmNiOGJkYmItOGZhNi00YzU5LWJmZTYtNGQzMTI1MWRlMDNjIiwiYWNjb3VudF9pZCI6IjZhZDkxNjQ4MTk1N2EyMjY2Yjg0YzQ2OSIsImRlcGxveV9pZCI6IjZiMDMzMzVkM2ZhYjliMmVlNWRiMWMwYSIsImlzcyI6Im5ldGxpZnkifQ.2P_RB-XctdjGEW5nbW1doIWC1LIZPHIoHEXiwRQaF1Q"></script> <script async src="/.netlify/scripts/hud?variant=public" data-nf-variant="public" data-netlify-site-id="fcb8bdbb-8fa6-4c59-bfe6-4d31251de03c" data-app-host="app.netlify.com" data-account-tier="free"></script>