VLC media player
From the project home page:
- VLC is a free and open source cross-platform multimedia player and framework that plays most multimedia files as well as DVD, Audio CD, VCD, and various streaming protocols.
- 1 Installation
- 2 Language
- 3 Skins
- 4 Web interface
- 5 Tips and tricks
- 6 Troubleshooting
- 6.1 Video broken or other issue after upgrade
- 6.2 Segmentation fault
- 6.3 Missing icons in dropdown menus
- 6.4 Failed to open VDPAU backend
- 6.5 VLC fails to open a second time after closing
- 6.6 No playback via SFTP of media files names containing spaces
- 6.7 Can't navigate DVD menus
- 7 See also
Install the package.
Notable variants are:
- AUR - Development branch.
- AUR - Without X support.
VLC does not offer an option to change language in its Preferences menu. But you can use the LANGUAGE= prefix. For instance, modify the
Exec=LANGUAGE=fr /usr/bin/vlc %U
to switch VLC interface to French.
VLC can be "skinned" for a different look and feel. You can get skins at the skins website.
To install a skin download it and move it to
Open up VLC, click Tools > Preferences. When the preferences window opens up you should be in the "Interface" tab
Choose the "Use custom skin" radio button, and select the downloaded skin.
Restart VLC for the change to take effect.
Run VLC with the parameter
--extraintf=http to use both the desktop and web interface. The
--http-host parameter specifies the address to bind to, which is
localhost by default. To set a password, use
--http-password, otherwise VLC will not allow you to log in.
$ vlc --extraintf=http --http-host 0.0.0.0 --http-port 8080 --http-password yourpasswordhere
To enable the web interface from the graphical interface, navigate to View > Add Interface > Web Interface. Set the password via Tools > Preferences > Show settings: All > Interface > Main interfaces > Lua > Lua HTTP > Password.
VLC defaults to port
/usr/share/vlc/lua/http/.hosts to allow remote connections. You will need to restart VLC in order for changes to take effect.
Tips and tricks
Twitch.tv streaming over VLC
Playing streamed content from a local DLNA server
If you find that trying to play uPNP/DLNA content (by going to View > Playlist > Local Network > Universal Plug'n'Play), that vlc fails to see the DLNA server on the local network, then make sure that the firewall is not blocking port 1900 UDP. It is essential that this port is open in order to play local uPNP/DLNA content.
Control using hotkeys or cli
Follow instructions in script to setup a socket for VLC.
Either run the script from the command line or register the script with keyboard shortcuts through your desktop.
Alternatively, you can use MPRIS to interact with VLC.
It is also possible to start vlc with an ncurses dialog
$ vlc -I ncurses
see the documentaion for more information
Preventing multiple instances
The default settings for VLC is to open a new instance of the program for each file that is opened. This can be annoying if you are using VLC for something like playing your music collection. You can disable this in Tools > Preferences > Interface > Instances > Allow only one instance. Optionally, tick Enqueue files when in one instance mode which keeps current file playing and adds any newly opened files to the current playlist.
Hardware video acceleration
VLC automatically tries to use an available API, but you can override it by going to Tools > Preferences > Input & Codecs and choosing the suitable option under Hardware-accelerated decoding, e.g.
Video Acceleration (VA) API for VA-API or
Video Decode and Presentation API for Unix (VDPAU) for VDPAU.
VLC's web interface can be started from systemd. First, you need to create a default user:
# useradd -c "VLC daemon" -d / -G audio -M -p \! -r -s /usr/bin/nologin -U vlcd
Now create the systemd service file:
[Unit] Description=VideoOnLAN Service After=network.target [Service] Type=forking User=vlcd ExecStart=/usr/bin/vlc --daemon --syslog -I http --http-port 8090 --http-password password Restart=on-abort [Install] WantedBy=multi-user.target
Starting with 3.0 release (Vetinari branch), VLC can stream to chromecast devices on the same wireless network.
- - VLC can find the chromecast device and it shows up in Playback > Renderer menu
- - enables streaming to the selected device in Playback > Renderer menu
Then, edit the file
/etc/nsswitch.conf and change the
hosts line to include
mdns_minimal [NOTFOUND=return] before
hosts: ... mdns_minimal [NOTFOUND=return] resolve [!UNAVAIL=return] dns ...
.localhosts try to use
Video broken or other issue after upgrade
Now and then VLC will have some issues with configuration even in minor releases. Before making bug reports, remove or rename your configuration located at
~/.config/vlc and confirm whether the issue is still there.
If using a ffmpeg variant from the AUR, be sure that you have upgraded it as well. Pacman will not upgrade it when necessary and a mismatch will break VLC.
Fault when initiating VLC
When starting VLC you can get a segfault, and ruling out general factors such as Microcode, a possible workaround to this is running the following:
# /usr/lib/vlc/vlc-cache-gen /usr/lib/vlc/plugins
Then reinstall VLC.
If that does not work, VLC has a segfault issue with
plugins.dat (see FS#57777), simply remove the file:
# rm /usr/lib/vlc/plugins/plugins.dat
Fault when playing a video
Sometimes you can open VLC and use it to play audio files, but it closes when you play a video. You'll also get a segfault. It occurs especially when you're using different graphic cards on one computer. Then Hardware video acceleration was wrongly configured, causing VLC unable referring to graphic devices. You can install the following dependencies to solve the problem.
For Nvidia graphic card users: install.
For Intel graphic card users: install.
This can happen under XFCE, there will be no more icons in dropdown menus, like the PCI card icon.
Execute these commands to reactivate these icons:
$ gconftool-2 --type boolean --set /desktop/gnome/interface/buttons_have_icons true $ gconftool-2 --type boolean --set /desktop/gnome/interface/menus_have_icons true
Failed to open VDPAU backend
Since your system probably does not support VDPAU you should tell VLC to use VA-API instead, see #Hardware video acceleration.
VLC fails to open a second time after closing
Manually set VLC to use the VA-API acceleration backend in Settings -> Input/Codecs. VLC seems to select VDPAU by default, which is broken for many people.
No playback via SFTP of media files names containing spaces
If VLC does not play any videos or audio files over SFTP make sure you haveinstalled.
If it refuses to play any media files containing spaces via SFTP and always asks for authentication change the Exec line in the
vlc.desktop file to:
Exec=/usr/bin/vlc --started-from-file %F
To navigate DVD menus an play episode by episode, optional VLC dependencyneeds to be installed.