Install VLC on Linux and Fix Common Playback Problems

Check the installed version with vlc --version. Pick one installation method; having the distro package, Snap and Flatpak installed at once leads to confusion about which one opens your files.

Which version to install

Install on each distribution

Ubuntu, Debian and Linux Mint

sudo apt update
sudo apt install vlc

On Ubuntu, VLC is in the universe component; if apt can't find it, enable universe (see Unable to locate package). Ubuntu's ubuntu-restricted-extras adds codecs for other players, but VLC brings most of its own.

Fedora

Current Fedora releases include VLC in the official repositories, built without patent-encumbered codecs. For full format support, either enable RPM Fusion and add the extra plugins:

sudo dnf install \
  https://mirrors.rpmfusion.org/free/fedora/rpmfusion-free-release-$(rpm -E %fedora).noarch.rpm
sudo dnf install vlc vlc-plugins-freeworld
sudo dnf swap ffmpeg-free ffmpeg --allowerasing

or install the Flathub build instead. The Fedora reference covers RPM Fusion and hardware decoding drivers in more detail. If vlc-plugins-freeworld isn't found, check the current package names with dnf search vlc.

Arch Linux

sudo pacman -S vlc vlc-plugins-all

Arch splits VLC's plugins into separate packages. vlc-plugins-all pulls everything; install individual vlc-plugin-* packages if you want a smaller setup.

openSUSE

sudo zypper install vlc
# for full codecs, add the Packman repository (see the openSUSE wiki), then
sudo zypper dup --from packman --allow-vendor-change

Flatpak and Snap (any distribution)

flatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
flatpak install flathub org.videolan.VLC
# or
sudo snap install vlc

Linux Mint disables Snap by default, so use the apt package or Flatpak there.

Common tasks

Make VLC the default video player

In GNOME Settings → Apps → Default Apps (or KDE System Settings → Default Applications), choose VLC for Video and Music. From the terminal:

xdg-mime default vlc.desktop video/mp4 video/x-matroska video/webm
# for Flatpak, the desktop file is org.videolan.VLC.desktop

Play DVDs

Commercial DVDs are usually encrypted with CSS and need libdvdcss. Check the legal situation where you live first.

# Debian, Ubuntu, Mint: builds libdvdcss locally
sudo apt install libdvd-pkg
sudo dpkg-reconfigure libdvd-pkg
# Fedora: from RPM Fusion's tainted repository
sudo dnf install rpmfusion-free-release-tainted
sudo dnf install libdvdcss
# Arch
sudo pacman -S libdvdcss

Blu-ray discs need libbluray plus keys VLC doesn't provide; most commercial Blu-rays won't play without them.

Hardware-accelerated decoding

Under Tools → Preferences → Input / Codecs, set Hardware-accelerated decoding to Automatic (or VA-API). It needs a working VA-API driver: intel-media-driver for recent Intel GPUs, Mesa's VA-API drivers for AMD. Check the driver with vainfo (package vainfo or libva-utils). On Fedora, H.264/HEVC decoding on AMD needs mesa-va-drivers-freeworld from RPM Fusion.

Fixing common problems

No sound in VLC

1. Check whether other apps have sound. If nothing does, it's a system issue: see fixing no sound on Linux.
2. In VLC, Audio → Audio Device: pick the right output. Make sure Audio → Mute isn't on.
3. Tools → Preferences → Audio: set Output module to Automatic or PulseAudio; current distributions run PipeWire, which accepts PulseAudio clients.
4. Check VLC's own stream in pavucontrol or your desktop's sound settings, where per-app volume can be muted.

Video stutters, tears or shows green artefacts

• Toggle hardware decoding (above). Broken drivers cause artefacts; missing drivers cause high CPU and stutter.
• Tools → Preferences → Video → Output: try Automatic, then OpenGL video output or XVideo.
• For network files, raise Tools → Preferences → Show settings: All → Input / Codecs → Network caching.

"VLC is unable to open the MRL" or codec not supported

For local files, the codec is missing (Fedora/openSUSE without RPM Fusion/Packman) or the file is damaged; check with ffprobe file.mkv. For Snap and Flatpak, the sandbox may block the path:

# Snap: allow access to external drives and network mounts
sudo snap connect vlc:removable-media
# Flatpak: grant access to a folder (Flatseal offers a GUI for this)
flatpak override --user --filesystem=/mnt/media org.videolan.VLC

VLC won't start or crashes on launch

# see the error
vlc --verbose=2
# reset preferences (keeps a backup)
mv ~/.config/vlc ~/.config/vlc.bak
# reinstall if plugins are missing or damaged
sudo apt install --reinstall vlc        # or dnf reinstall / pacman -S

If it only crashes with hardware decoding enabled, disable it with vlc --avcodec-hw=none and fix the VA-API driver. Running VLC as root is blocked on purpose; start it as your normal user.

Frequently asked questions