VLC is unable to open the MRL: what it means and how to fix it

By the FixMP4 engineering team · · 7 min read

"Your input can't be opened: VLC is unable to open the MRL '...'. Check the log for details." means VLC could not reach the address it was given. The MRL (Media Resource Locator) is VLC's word for a path or URL. Because the error happens before VLC looks at the video data, it is rarely about corruption. It is about where the file is, who is allowed to read it, or whether a stream is online. This guide works through the causes from the most common to the least, and shows how to tell when the file itself is the issue after all.

Step 0: read the log

VLC prints the real reason in its log, and it takes ten seconds to see it:

  1. Open Tools, Messages (Ctrl+M on Windows and Linux; Window, Messages on Mac).
  2. Set Verbosity to 2 (debug).
  3. Try opening the file or stream again and scroll to the red and orange lines.

Typical lines and what they mean:

Log fragmentMeaning
"cannot open file ... (No such file or directory)"The path is wrong or the file moved
"Permission denied" or "Access is denied"The account running VLC may not read it
"connection refused", "cannot connect", "HTTP 403/404"The stream server is down or blocks VLC
"lua demux error" with a YouTube linkVLC's YouTube script is outdated
"no access modules matched"Unknown protocol or a typo in the URL

Local files: the common causes

The file is not where VLC thinks it is

Opening an item from the Recent media list or a saved playlist uses the old path. If the file was renamed, moved or the drive letter changed (USB sticks and card readers are notorious for this), VLC reports an MRL error. Open the file fresh with Media, Open File, or drag it into the window.

Cloud placeholders (OneDrive, iCloud, Google Drive, Dropbox)

Files that show a cloud icon are only placeholders until they are downloaded. VLC may try to read the placeholder before the sync client has fetched the data, and fail. Right-click the file, choose Always keep on this device (OneDrive) or the equivalent, wait for the download to finish and try again. For large recordings, copy the file to a normal local folder first.

Paths that are too long or contain unusual characters

Deeply nested folders, emoji, some non-Latin characters or a trailing space in a folder name can trip up path handling on older VLC builds. Copy the file to a short path such as C:\Video\test.mp4 and open it from there. If that works, rename the original folders.

Permissions

Files copied from another computer, an old Windows installation, or a backup drive can be owned by a different account. Check the file's Properties, Security tab, and give your account read access, or copy it into your own user folder. On macOS, VLC needs permission for Desktop, Documents, Downloads and removable volumes under System Settings, Privacy & Security, Files and Folders. Without it, VLC sees the file name but cannot read the contents.

Network shares

For files on a NAS or a shared folder, map the share to a drive letter or copy the file locally. Opening \\server\share paths directly works in most cases, but credentials, SMB versions and sleeping drives cause MRL errors that disappear as soon as the file is local.

Streams and links

  • IPTV, RTSP cameras, HTTP streams: test the URL in a browser or another player. If nothing connects, the source is offline or the URL has expired. Many IPTV and camera links contain a token that is only valid for a short time.
  • Firewalls and antivirus: allow VLC through the firewall when it asks, and check that security software is not blocking it from making connections.
  • YouTube and other sites: VLC uses a small Lua script to find the actual video inside the page. When the site changes, the script breaks. Update VLC first; if a fix is not released yet, the VideoLAN project publishes the updated youtube.lua in its source repository, which replaces the file in VLC's lua\playlist folder.
  • Typos: a missing "://" or an extra space at the end of the URL produces "no access modules matched".

When the file is the problem

Sometimes VLC does open a damaged file and then gives up, which users also describe as "VLC can't open it". Compare the symptoms:

  • MRL error appears instantly: access problem, follow the sections above.
  • VLC opens, the timeline stays at 00:00 and nothing plays: the file is reachable but VLC cannot find any streams in it.
  • VLC asks about a broken or missing index: that is for AVI files; VLC can rebuild AVI indexes but not MP4 or MOV ones.

For MP4, MOV and M4A recordings that were cut off by a dead battery, an app crash or a full card, the "nothing plays" symptom almost always means a missing moov atom: the index that maps every frame was never written. VLC is tolerant, but without that table it cannot know where the frames are. See our page on whether VLC can repair a video for what its built-in repair options do and do not cover.

To confirm, check the size: a 10-minute 1080p phone clip should be several hundred MB. A file that large with no playable streams still holds its frames. Load it into the FixMP4 repair tool, which works locally in the browser tab; when the camera or phone needs it, add a few seconds of healthy footage shot on that same device so the codec parameters can be copied. You can watch the recovered footage in a free preview before paying, and the rebuilt MP4 then opens in VLC like any normal file. The core guide to fixing "moov atom not found" explains the same problem from FFmpeg's point of view.

Quick fixes, in order

  1. Read the log (Tools, Messages, verbosity 2).
  2. Reopen the file from its current location; do not use Recent media.
  3. Download cloud files and copy the file to a short local path.
  4. Fix permissions, or grant VLC folder access on macOS.
  5. For streams, test the URL elsewhere, update VLC and its scripts.
  6. If VLC opens the file but plays nothing, treat it as a damaged recording and repair the MP4 file from a copy.

Keep VLC itself healthy

If every file fails with MRL errors, reset VLC's preferences (Tools, Preferences, Reset Preferences) and update to the current release from videolan.org. Avoid VLC builds bundled with download sites; they are often old or modified. If problems persist, compare with other player-side messages in our guide to MP4 files that won't play on Windows.

Frequently asked questions

What is an MRL in VLC?

MRL stands for Media Resource Locator. It is the address VLC tries to open, such as file:///C:/Videos/clip.mp4 for a local file or an http, rtsp or udp address for a stream. The error means VLC could not even reach or read that address.

Does "unable to open the MRL" mean my video is corrupted?

Usually not. The error appears before VLC reads the content, so it typically points at the path, permissions, a missing file or a stream that is offline. A damaged file normally opens and then shows nothing, stops, or plays with errors.

Why does VLC fail to open YouTube links with an MRL error?

VLC relies on a small script to understand YouTube pages, and it breaks whenever YouTube changes its site. Updating VLC or replacing the youtube.luac script with the current version from the VideoLAN repository usually fixes it.

How do I see why VLC cannot open the MRL?

Open Tools, Messages, set verbosity to 2 (debug) and try again. The log names the exact module and system error, for example access denied, no such file, or connection refused.

Have a broken recording right now?

Diagnose it and hear or watch a free repaired preview. Nothing is uploaded.

Open the repair tool
  • VLC
  • MRL
  • unable to open
  • playback
  • network stream