VLC Fix Guide

VLC Playlist Won’t Save / Opens Empty — Fixes

Crash & Startup Issues Last updated: Applies to: All platforms · VLC 3.0.x

A playlist that will not save — or saves but opens empty — is frustrating because the media library itself is fine. VLC stores the current playlist in memory and writes .xspf (XML) files when you export or when the session closes. When that fails, the cause is usually a locked file, a corrupt .xspf, or a path issue with special characters. This guide covers recovery and the save methods that always work.

Why does this happen?

  • File locked by another process — the playlist file is open in a player or sync tool, so VLC cannot overwrite it.
  • Corrupt .xspf — a half-written file (crash during save) makes VLC skip or empty the playlist on load.
  • Media database mismatch — playlist entries reference media IDs that no longer exist in the database after a VLC update.
  • Path/encoding issues — entries with unusual characters or network paths that fail to resolve when reloaded.
  • Auto-save disabled or failing — "Save playlist on exit" is off, or the exit crashed before the write completed.

How to fix it

Fix 1Save the playlist to a specific file

Works regardless of auto-save state

  1. Build your playlist, then go to Media > Save Playlist to File (or Ctrl+Y).

    The save dialog opens.

  2. Choose a location and keep the .xspf extension (or pick .m3u8 for broader compatibility).

    The playlist file is written.

  3. To load it later: Media > Open File and select the playlist file — or drag it into the playlist window.

    The playlist loads.

NoteManual export is the reliable path. .m3u8 is the most portable format if you use other players too.

Fix 2Free a locked playlist file

Fixes "file in use" save failures

  1. Close other players (Windows Media Player, foobar, sync tools) that might hold the file.

    All locks are released.

  2. On Windows, use Task Manager > Performance > Open Resource Monitor to find which process holds the file.

    The locking process is identified.

  3. End or close that process, then retry the save in VLC.

    The save succeeds.

NoteCloud-sync folders (OneDrive/Dropbox) are frequent lockers — exclude your playlist folder from real-time sync if this recurs.

Fix 3Recover or rebuild a corrupt .xspf

Restores a playlist that opens empty

  1. Open the .xspf in a text editor — it should start with <?xml version="1.0" encoding="UTF-8"?> and contain <trackList>.

    The file structure is visible.

  2. If the XML is truncated or malformed, open the most recent backup (VLC keeps none by default — check your editor’s temp files or your backup).

    A backup is located.

  3. If no backup exists, rebuild: keep the list in VLC open, fix the cause, and re-export immediately.

    The playlist is re-exported.

NoteFor critical playlists, export a backup copy every few weeks — .xspf is plain text, easy to archive.

Fix 4Use the media library instead of a plain playlist

Immune to most playlist-file issues

  1. Go to the Library view (the cone/music icon or View > Media Library).

    The media library opens.

  2. Create a "Playlist" inside the library (right-click > New Playlist) and drag items in.

    The library playlist is created.

  3. Library playlists live in the media database (ml.xspf) and survive crashes — export them via right-click > Export when you need a portable copy.

    Library playlists are saved.

NoteLibrary playlists survive reinstallation if you back up the ml.xspf file — but note that ml.xspf also holds play counts and recently played data.

Fix 5Reset VLC preferences to defaults

Clears corrupted settings that cause crashes, black screens and audio issues

  1. Close VLC completely.

    No VLC process is running.

  2. Open a command prompt (Win+R → cmd) or terminal.

    A command line is available.

  3. Run: vlc --reset-config (Windows/Linux) — on macOS delete ~/Library/Preferences/org.videolan.vlc instead.

    VLC preferences are restored to defaults.

  4. Launch VLC and re-apply only the settings you actually need.

    VLC starts with clean settings.

NoteThis erases all custom preferences (including shortcuts and skins). Export your config first under Tools > Preferences > All > Interface if you want a backup.

Advanced fixes

Fix 1Repair the media database index

Fixes playlists whose entries reference missing media

  1. Close VLC and back up %APPDATA%\vlc\ml.xspf (Windows) or ~/Library/Application Support/org.videolan.vlc/ml.xspf (macOS).

    A backup exists.

  2. Delete ml.xspf and restart VLC — the library rebuilds by scanning your configured folders.

    The database is rebuilt.

  3. Re-import your exported playlists (Media > Open File).

    Playlists load against the fresh database.

NoteRebuilding loses play counts and "recently played" — acceptable when playlists were the problem.

How to avoid it in the future

  • Export important playlists to .m3u8 periodically.
  • Keep playlist files out of real-time cloud-sync folders.
  • Use the media library’s playlists for anything long-lived.
  • Close VLC with a normal exit (not force-kill) so auto-save can run.

Frequently asked questions

What is the difference between .xspf and .m3u8?
.xspf is VLC’s native XML format (full metadata); .m3u8 is a simple text list of paths. Use .m3u8 for portability, .xspf for VLC-only playlists with metadata.
Where does VLC store the current playlist?
In memory, plus the media library database (ml.xspf) for library playlists. The current in-memory list is only persisted when you export or exit cleanly with auto-save enabled.
Can I recover a playlist after a crash?
If you had exported it, yes — open the .xspf/.m3u8. Otherwise, library playlists may survive via ml.xspf; plain session playlists do not.
Why do my playlists lose entries after updating VLC?
A VLC update can rebuild the media database; entries referencing old media IDs drop out. Re-import your exported playlists after major updates.

Summary

Save the playlist to a specific file — Works regardless of auto-save state. If it does not help, work through the remaining fixes in order: each targets a different layer of the problem. Most users resolve this issue by fix 3 at the latest. Keep VLC updated (current stable: 3.0.23) and revisit this guide when a new VLC version ships.

Related guides

Edited by the VLC Fix Guide Tech Team — 10+ years of media software troubleshooting