How to view and save the VLC log to find out why a file won't play

Published Sources checked By helps.wiki editorial team

VLC does not keep an error log on disk by default. It shows a live message log in the Messages window (Tools > Messages, or Ctrl+M on Windows and Linux), and that log is lost when you close the player. Open it, play the problem file, and click Save as... before closing VLC.

Applies to:VLC media player (desktop: Windows, Linux)Third-party guides describe 2.x and 3.x; 4.x and macOS not verified
On this page

What it means

"VLC error log" is not an error code. It means the diagnostic output VLC produces while it plays something. That output usually says why a file, stream or device failed to open, which is why support forums ask you to "post your messages log".

By default VLC holds these messages only in memory. They appear in the Messages window and on the console, and they are gone when VLC closes. If you want a record, you have to save it yourself.

I could not find a current official VideoLAN page that covers this, so the steps below come from third-party guides (It's FOSS and an older Dedoimedo article). Menu names may differ slightly between versions, so check them against your install. This article covers Windows and Linux. On macOS the Messages window is reached through a different menu, and that path is not verified here.

Symptoms and causes

You are likely dealing with this problem if:

  • A file will not play, or VLC shows a message such as "VLC is unable to open the MRL" or "Your input can't be opened".
  • Audio and video are out of sync, or frames are dropped.
  • A network stream will not connect.
  • Someone asks you to post your messages log.

The usual causes, most common first:

Damaged or invalid file container
The log may contain a line like avi error: avi module discarded (invalid file), which points to a broken file or index.
Damaged or mismatched stream
Lines such as garbage at input, trying to resync... or this does not look like an MPEG PS stream suggest the data is corrupt or not the format VLC expected.
No suitable module or decoder
A line like no stream_filter module matching "any" could be loaded means VLC found nothing that could handle the input.
Harmless warnings
Files that play fine often log warnings about bad frames or junk data too, so a single warning is not proof of the cause.

How to fix it

Work through these in order. They start with the quickest, safest checks and move to deeper repairs; stop as soon as the problem is gone.

1.Read the log in the Messages window (Windows and Linux)

Easy

This is the quickest way to see what VLC says while a file fails.

  1. Open VLC and choose Tools > Messages, or press CtrlM. On macOS the window is not under Tools; look for Messages in the menu bar of your version, as this article has not verified the macOS path.
  2. Set the verbosity to Errors, Warnings or Debug. Debug shows the most detail. (Older versions describe this as a 0 to 2 scale: 0 errors, 1 warnings, 2 debug.)
  3. Start playing the problem file or stream and read the output that appears.

2.Save the log before closing VLC

Easy

VLC does not save logs automatically, so the content is lost when the player closes.

  1. With the log showing the failure, click Save as... in the Messages window.
  2. Choose a location and file name, then attach or paste the saved file when asking for help.

3.Interpret what the log says

Easy

The log is only useful if you separate the real failure from background noise.

  1. Look for errors that repeat. Ignore isolated warnings.
  2. If you have a similar file that plays, compare its log with the failing one to spot what is different.
  3. If the log points to a damaged container, download the file again, re-mux it, or convert it.

Check that it worked

  • The Messages window shows output while you play the file, and your saved log file opens and contains text.
  • You can point to repeated error lines that explain the failure.

If it still fails

  • Post the saved log, with the Debug level used, on the VideoLAN forum together with your VLC version and operating system.
  • Check whether the same file plays in another player, which helps tell a damaged file from a VLC problem.

Questions

Does VLC keep logs after I close it?

Not by default. The Messages window content is lost on close unless you saved it.

Sources

  1. How to Check VLC Log Files · It's FOSS
  2. VLC secrets: Logging and how it helps with bad files · Dedoimedo
  3. Documentation:Command_lineOfficial · VideoLAN Wiki

Browse