VLC Fix Guide

How to Play Videos from a NAS or Network Share (SMB/UPnP)

Intermediate Last updated: Applies to: Desktop + Android TV · VLC 3.0.x

If your movies live on a NAS or another PC, VLC can stream them over the network without copying anything. Desktop VLC reads SMB shares and UPnP/DLNA servers directly; Android TV VLC has a dedicated network browser. This guide covers both, plus the performance settings that keep large 4K files from stuttering.

Step 1 — Play an SMB share on desktop VLC

  1. Press Ctrl+N and enter the share path — e.g. smb://server/share/movies or \\server\share\movies (Windows) — then click Play.

    The share opens.

  2. If prompted for credentials, enter the NAS/PC username and password. Tick "remember" only on trusted machines.

    The share is authenticated.

  3. Alternatively, use Playlist > Add Directory and browse to the mapped drive (Windows) or the /mnt mount (Linux).

    The folder is added as a playlist.

NoteVLC 3.0 uses libsmb2 on Linux/macOS and native SMB on Windows. If an SMB path fails, try the other syntax — server software varies.

Step 2 — Browse UPnP/DLNA servers

  1. In the sidebar (View > Playlist), open "Local Network" (Windows/Linux) or the Network panel.

    Discovered UPnP servers appear.

  2. Pick your NAS or media server (Plex, Jellyfin, MiniDLNA, Windows Media Server) and browse its folders.

    The server’s library is browsable.

  3. Add the server to "My places" for one-click access next time.

    The server is bookmarked.

Step 3 — Android TV: the network browser

  1. Open VLC on Android TV, go to the sidebar and choose "Local network" (or "Network" on newer builds).

    SMB/UPnP sources are listed.

  2. Select "Add server" → SMB, and type the NAS address, username and password.

    The share is added.

  3. Browse to the video and press OK to play — Android TV VLC plays 4K H.264/HEVC over Wi-Fi if the network is solid.

    The video plays from the share.

NoteOn Android TV, use a 5 GHz Wi-Fi band or Ethernet for 4K HEVC files — 2.4 GHz often causes buffering. See the Android TV black-screen fix if video fails while audio plays.

Step 4 — Performance: stop buffering on big files

  • Raise the file/network cache: Preferences > Input/Codecs > "File caching (ms)" to 2000–3000 for SMB, and "Network caching (ms)" to 3000 for streams.
  • On Windows, map the SMB share to a drive letter and open files from the mapped drive — VLC then uses the file access module, which is faster than the SMB module.
  • Check the NAS: enable SMB3, disable packet signing if performance is bad (with the security trade-off in mind), and avoid Wi-Fi repeaters.
  • For Linux, mounting with cifs (mount -t cifs //server/share /mnt -o username=…) gives VLC a normal file path and the best performance.

Frequently asked questions

How do I enter a network path in VLC?
Ctrl+N and type smb://server/share/folder/file.mkv. For Windows shares, \\server\share also works. UNC paths with spaces need no escaping in VLC.
VLC cannot see my NAS — what now?
Check that SMB is enabled on the NAS, the share is named correctly, and the device is on the same subnet. Firewalls (Windows Defender) frequently block SMB discovery — add an allow rule for port 445.
Is it safe to enter my NAS password in VLC?
Yes on your own machine — VLC stores it in its config file (protected by your OS login on Windows). Avoid ticking "remember" on shared computers.
Can VLC play files from Google Drive or OneDrive?
Not directly — VLC has no cloud clients. Sync the file locally or stream via a local DLNA/UPnP server instead.

Related guides

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