Difference between revisions of "Documentation:Installing VLC"

From VideoLAN Wiki
Jump to navigation Jump to search
(added Linux CentOS (EL5))
(→‎SUSE: New section with link to https://www.videolan.org/vlc/download-suse.html)
 
(144 intermediate revisions by 24 users not shown)
Line 1: Line 1:
−
{{RightMenu|documentation play howto toc}}
+
{{RightMenu|Documentation TOC}}
  
−
==Installing VLC==
+
There are VLC binaries available for the many [[OS]]es, but not for all supported ones. If there are no binaries for your OS or if you want to change the default settings, you can compile VLC from [[GetTheSource|source]].
  
−
There are VLC binaries available for the many OSes, but not for all supported ones. If there are no binaries for your OS or if you want to change the default settings, you can compile VLC from sources.
+
== [[File:Windows logo2.jpg|100x100px|alt=Windows logo]] Windows ==
  
−
===Windows===
+
=== 95, 98, ME ===
  
−
VLC works under Windows 95/98/ME/2000/XP.
+
You can install VLC on Windows 95, 98, or ME operating systems by using [http://kernelex.sourceforge.net/wiki/Main_Page KernelEx].
−
Download the self-extracting package from the [http://www.videolan.org/vlc/download-windows.html VLC Windows download page]. Launch the '''.exe''' to install VLC.
 
  
−
===Mac OS X===
+
=== 2000, XP, Vista, 7, 8, 10 ===
  
−
Download the Mac OS X package from the [http://www.videolan.org/vlc/download-macosx.html VLC MacOS X download page]. Double-click on the icon of the package: an icon will appear on your Desktop, right beside your drive(s). Open it and drag the VLC application from the resulting window to the place where you want to install it (it should be '''/Applications''').
+
==== Recommended ====
  
−
===BeOS===
+
The normal and recommended way to install VLC on a Windows operating system is via the installer package.
  
−
Download the Zip file from the [http://www.videolan.org/vlc/download-beos.html VLC BeOS download page]. Unzip the file in a directory to install VLC.
+
'''Step 0: Download and launch the installer'''
  
−
===Debian GNU/Linux===
+
Download the installer package from the [https://www.videolan.org/vlc/download-windows.html VLC download page for Windows]. After you download the installer package, double click on the file to begin the install process. If you're using Windows Vista, 7, 8 or 10 and have UAC (User Account Control) enabled, the operating system may prompt you to grant VLC administrator permissions. Click '''Yes''' to continue the installation process.
  
−
====Debian stable (sarge)====
+
'''Step 1: Select an installer language'''
  
−
Add the following lines to your '''/etc/apt/sources.list''':
+
Before you can continue, you must select the language that you want the installer to use to display information to you. After you select a language, click '''OK'''.
−
deb http://download.videolan.org/pub/videolan/debian stable main
 
−
deb-src http://download.videolan.org/pub/videolan/debian stable main
 
  
−
Then, for a normal install, do:
+
[[File:Step-1-select-language.png]]
  
−
# '''apt-get update'''
+
'''Step 2: Review the Welcome screen'''
−
# '''apt-get install vlc libdvdcss2'''
 
  
−
====Debian testing (etch)====
+
The VLC installer recommends that you close all other applications before continuing the installation process. When you're ready to proceed with the installation process, click '''Next'''.
  
−
You should not be using Debian testing unless you perfectly know what you are doing. It is almost impossible to support Debian testing and there are no plans to do it.
+
[[File:Step-2-welcome.png]]
  
−
For more informations on Debian testing, please look: [http://www.debian.org/devel/testing testing page].
+
'''Step 3: Read License agreement'''
  
−
====Debian unstable (sid)====
+
Read the Terms of Service. Once you're done reading, click '''Next'''.
  
−
Add the following lines to your '''/etc/apt/sources.list''':
+
[[File:Step-3-licence.png]]
  
−
deb http://download.videolan.org/pub/videolan/debian sid main
+
'''Step 4: Select components'''
−
deb-src http://download.videolan.org/pub/videolan/debian sid main
 
  
−
Then, for a normal install, do:
+
Use this menu to customize your install. Choose all of the components you wish to install and whether you want VLC to be your default media player or not. Once you are done, click '''Next'''.
  
−
# '''apt-get update'''
+
[[File:Step-4-components.png]]
−
# '''apt-get install vlc libdvdcss2'''
 
  
−
===Linux Mandrake===
+
'''Step 5: Pick a location'''
  
−
There are VLC packages for Mandrake 9.1 and cooker.
+
Click '''Browse...''' to choose the destination installation folder. After you've identified the desired folder, click '''Install'''.  
  
−
To install them, add the following sources for either Mandrake 9.1 or Cooker (you can use [http://plf.zarb.org/~nanardon/ Easy urpmi] for that): ''contrib'' from the core distribution and ''plf'' (Penguin Liberation Front) from the external add-ons.
+
[[File:Step-5-install-location.png]]
  
−
Then install the required packages with '''urpmi''':
+
'''Step 6: Now installing'''
  
−
# '''urpmi libdvdcss2 libdvdplay0 wxvlc vlc-plugin-a52 vlc-plugin-ogg vlc-plugin-mad'''
+
Wait as VLC is installed on your machine. It shouldn't take too long. Then click "Show details" to see more information about the progress of the installation.
  
−
===Linux CentOS (EL5)===
+
[[File:Step-6-installing.png]]
  
−
1. download and install the lastest rpmforge-release rpm (eg rpmforge-release-0.3.6-1.el5.rf.i386.rpm)
+
'''Step 7: Installation complete'''
  
−
2. either;
+
Once installation is complete, you may choose to run VLC or read VLC's release notes. Click '''Finish''' to complete the installation process and close the installer.
  
−
yum install vlc
+
[[File:Step-7-completed.png]]
  
−
or (if you have epel-release installed);
+
==== Alternative ====
  
−
yum --disablerepo='epel' install vlc
+
If you want to perform an unattended (or silent) installation of VLC, you can do so via a [[command-line interface]]. Type in "''filename''" /L="''languagecode''" /S. For example, the English installation would look something like '''vlc-2.0.1-win32.exe /L=1033 /S'''.
  
 +
'''PowerShell'''
  
−
===Linux Redhat===
+
Installing VLC using PowerShell is as easy.
  
−
Download the RPM package ''vlc'' and the packages listed in the ''required libraries and codecs'' section (the other packages are optional) from the [http://www.videolan.org/vlc/download-redhat.html VLC Red Hat download page] and put them all into the same directory.
+
[[File:Step-8-silent-installation-ps.png|669px]]
  
−
Then install the RPM packages you have downloaded:
+
'''Command Prompt'''
  
−
# '''rpm -U *.rpm'''
+
You can also install VLC using the command prompt.
  
−
If you have not installed all the RPM packages included with your distribution, you may be asked to install a few of them first.
+
[[File:Step-9-silent-installation-cmd.png]]
  
−
===Compile the sources by yourself (for every other OS)===
+
== [[File:Applelogo.jpg|100x100px|alt=macOS logo]] macOS ==
  
−
For more detailed information on compiling VLC by yourself, please have a look at the documentation on our [http://developers.videolan.org developers website].
+
#Download the macOS package from the [https://www.videolan.org/vlc/download-macosx.html VLC macOS download page].
 +
#Double-click on the icon of the package: an icon will appear on your Desktop, right beside your drives.
 +
#Open it and drag the VLC application from the resulting window to the place where you want to install it (it should be '''/Applications''').
  
−
==Uninstalling VLC==
+
Note: You may need to delete older versions of VLC on your computer before you can successfully install the latest version.
  
−
===Windows===
+
== Linux ==
 +
=== [[File:Debian-logo.jpg|100x100px]] Debian ===
 +
Download page: https://www.videolan.org/vlc/download-debian.html
  
−
Click on the ''Uninstall VLC'' icon that was created during installation.
+
'''A standard install without libdvdcss:'''
 +
{{prompt|root}} apt-get update
 +
{{prompt|root}} apt-get install vlc <optional extra components>
  
−
===Mac OS X===
+
Or search for <code>vlc</code> with the graphical package manager you like best. It should be in the main Debian repository in the section ''Video software''. Additional plugins are available and most require manual selection, e.g. <code>vlc-plugin-access-extra</code>, <code>vlc-plugin-notify</code> and <code>vlc-plugin-jack</code>.
  
−
Drag the VLC application to your trash can. You can also remove the configuration file and the cache files in '''~/Library/Preferences/VLC/'''. There is an AppleScript on the disk-image which lets you do this automatically.
+
'''For a standard install with libdvdcss:'''
  
−
===BeOS===
+
A simple install of the [[libdvdcss]] package can be found here: https://download.videolan.org/debian/stable/, but for future bug fixes add the following lines to your '''/etc/apt/sources.list''':
 +
<syntaxhighlight lang="apt_sources">
 +
deb https://download.videolan.org/debian/stable stable main
 +
deb-src https://download.videolan.org/debian/stable stable main
 +
</syntaxhighlight>
  
−
Delete the '''vlc-version''' directory. You can also remove the configuration file '''/boot/home/config/settings/vlcrc'''.
+
Then:
 +
{{prompt|root}} apt-get update
 +
{{prompt|root}} apt-get install vlc libdvdcss2 <optional extra components>
  
−
===Debian GNU/Linux===
+
This will allow you to decrypt [[DVD]]s.
  
−
Remove the packages that you installed:
+
==== [[File:Ubuntulogo.png|100x100px|alt=Ubuntu logo]] Ubuntu ====
 +
Links: [https://www.videolan.org/vlc/download-ubuntu.html Download page] &bull; Launchpad ([https://launchpad.net/ubuntu/+source/vlc/ Source] &bull; [https://bugs.launchpad.net/ubuntu/+source/vlc/+bugs?field.searchtext=&orderby=-users_affected_count&search=Search&field.status%3Alist=NEW&field.status%3Alist=CONFIRMED&field.status%3Alist=TRIAGED&field.status%3Alist=INPROGRESS&field.status%3Alist=FIXCOMMITTED&field.status%3Alist=INCOMPLETE_WITH_RESPONSE&field.status%3Alist=INCOMPLETE_WITHOUT_RESPONSE&assignee_option=any&field.assignee=&field.bug_reporter=&field.bug_commenter=&field.subscriber=&field.tag=&field.tags_combinator=ANY&field.status_upstream-empty-marker=1&field.upstream_target=&field.has_cve.used=&field.omit_dupes.used=&field.omit_dupes=on&field.affects_me.used=&field.has_patch.used=&field.has_branches.used=&field.has_branches=on&field.has_no_branches.used=&field.has_no_branches=on&field.has_blueprints.used=&field.has_blueprints=on&field.has_no_blueprints.used=&field.has_no_blueprints=on Bugs sorted by most users] &bull; [https://answers.launchpad.net/ubuntu/+source/vlc Questions])
  
−
# '''apt-get remove --purge vlc libdvdcss2'''
+
Launch the Ubuntu Software Center and go to '''All Software → Sound &amp; Video''' then in search VLC Player. After it will come click on it and it will automatically install
  
−
===GNU/Linux Redhat, Mandrake and SuSE===
+
You need to check that a universe mirror is listed in your '''/etc/apt/sources.list''' file.
 +
{{$}} sudo apt-get update
 +
{{$}} sudo apt-get install vlc vlc-plugin-pulse mozilla-plugin-vlc
  
−
Uninstall the RPM packages that you installed:
+
As given by https://help.ubuntu.com/community/RestrictedFormats/PlayingDVDs:
 +
{{$}} sudo apt install libdvd-pkg && sudo dpkg-reconfigure libdvd-pkg
 +
will install a packaged version of [[libdvdcss]] without the need for third-party repos.
  
−
# '''rpm -e vlc-version vlc-mad-version wxvlc-version libdvdcss2-version libdvdpsi1-version'''
+
=== Red Hat ===
 +
<!-- Help formatting at https://www.mediawiki.org/wiki/Help:Images -->
 +
<gallery>
 +
File:Redhat2.jpg|alt=Red Hat logo
 +
File:Centos.png|alt=CentOS logo
 +
<!-- wanted: Scientific Linux logo -->
 +
</gallery>
  
−
===If you compiled VLC from sources===
+
Adapted (annotated) from https://www.videolan.org/vlc/download-redhat.html:
  
−
Go to the directory containing VLC sources and execute
+
Red Hat/CentOS/Scientific Linux have almost the same setups (they're all derived from Red Hat). Red Hat and derivatives have [https://fedoraproject.org/wiki/EPEL#Quickstart different instructions] if EPEL (Extra Packages for Enterprise Linux) is not set up. Red Hat Network (RHN) users should verify that they have enabled the ''optionals'' and ''extras'' channels for RHN subscriptions.
  
−
# '''make uninstall'''
+
If you want to have DVD playback ability, you will need to install the libdvdcss package too ([https://www.videolan.org/vlc/download-redhat.html source]).
  
−
You can then remove the VLC sources.
+
For the latest version (up to the now-current version 3.0.6) use [https://rpmfusion.org/RPM%20Fusion RPM Fusion], otherwise VLC branches 2.0.x and 2.2.x are available:
 +
Red Hat/CentOS/Scientific Linux 7: (vlc-2.2.x – branch available for x86_64 architectures)
 +
{{$}}> su -
 +
    #> yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
 +
    #> yum install https://download1.rpmfusion.org/free/el/rpmfusion-free-release-7.noarch.rpm
 +
    #> yum install vlc
 +
    #> yum install vlc-core            # (for minimal headless/server install)
 +
    #> yum install python-vlc npapi-vlc # (optionals)
 +
 
 +
Red Hat/CentOS/Scientific Linux 6: (vlc-2.0.x branch – available for i686 and x86_64 architectures)
 +
{{$}}> su -
 +
    #> yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm
 +
    #> yum install https://download1.rpmfusion.org/free/el/rpmfusion-free-release-6.noarch.rpm
 +
    #> yum install vlc
 +
    #> yum install vlc-core            # (for minimal headless/server install)
 +
    #> yum install python-vlc npapi-vlc # (optionals)
 +
 
 +
=== SUSE ===
 +
Download page: https://www.videolan.org/vlc/download-suse.html
 +
 
 +
== FreeBSD ==
 +
Download page: https://www.videolan.org/vlc/download-freebsd.html
 +
 
 +
Install vlc from the packages collection:
 +
 
 +
{{prompt|root}} pkg install vlc
 +
 
 +
== Compile the sources by yourself  ==
 +
For more detailed information on compiling VLC, please see [[Compile VLC]].  
  
 
{{Documentation}}
 
{{Documentation}}

Latest revision as of 06:34, 29 March 2019

VLC User Guide

Quick Start Guide
Installing VLC
History
Usage
Interface
Open Media
Audio
Video
Playback
Playlist
Subtitles
Video and Audio Filters
Snapshots
Hotkeys
Uninstalling VLC
Troubleshooting
Advanced usage
Using VLC inside a webpage
Command line
Alternative Interfaces
Misc

Appendix
Building Pages for the HTTP Interface
Format String
Building Lua Playlist Scripts
View this alone

There are VLC binaries available for the many OSes, but not for all supported ones. If there are no binaries for your OS or if you want to change the default settings, you can compile VLC from source.

Windows logo Windows

95, 98, ME

You can install VLC on Windows 95, 98, or ME operating systems by using KernelEx.

2000, XP, Vista, 7, 8, 10

Recommended

The normal and recommended way to install VLC on a Windows operating system is via the installer package.

Step 0: Download and launch the installer

Download the installer package from the VLC download page for Windows. After you download the installer package, double click on the file to begin the install process. If you're using Windows Vista, 7, 8 or 10 and have UAC (User Account Control) enabled, the operating system may prompt you to grant VLC administrator permissions. Click Yes to continue the installation process.

Step 1: Select an installer language

Before you can continue, you must select the language that you want the installer to use to display information to you. After you select a language, click OK.

Step-1-select-language.png

Step 2: Review the Welcome screen

The VLC installer recommends that you close all other applications before continuing the installation process. When you're ready to proceed with the installation process, click Next.

Step-2-welcome.png

Step 3: Read License agreement

Read the Terms of Service. Once you're done reading, click Next.

Step-3-licence.png

Step 4: Select components

Use this menu to customize your install. Choose all of the components you wish to install and whether you want VLC to be your default media player or not. Once you are done, click Next.

Step-4-components.png

Step 5: Pick a location

Click Browse... to choose the destination installation folder. After you've identified the desired folder, click Install.

Step-5-install-location.png

Step 6: Now installing

Wait as VLC is installed on your machine. It shouldn't take too long. Then click "Show details" to see more information about the progress of the installation.

Step-6-installing.png

Step 7: Installation complete

Once installation is complete, you may choose to run VLC or read VLC's release notes. Click Finish to complete the installation process and close the installer.

Step-7-completed.png

Alternative

If you want to perform an unattended (or silent) installation of VLC, you can do so via a command-line interface. Type in "filename" /L="languagecode" /S. For example, the English installation would look something like vlc-2.0.1-win32.exe /L=1033 /S.

PowerShell

Installing VLC using PowerShell is as easy.

Step-8-silent-installation-ps.png

Command Prompt

You can also install VLC using the command prompt.

Step-9-silent-installation-cmd.png

macOS logo macOS

  1. Download the macOS package from the VLC macOS download page.
  2. Double-click on the icon of the package: an icon will appear on your Desktop, right beside your drives.
  3. Open it and drag the VLC application from the resulting window to the place where you want to install it (it should be /Applications).

Note: You may need to delete older versions of VLC on your computer before you can successfully install the latest version.

Linux

Debian-logo.jpg Debian

Download page: https://www.videolan.org/vlc/download-debian.html

A standard install without libdvdcss: 

# apt-get update
# apt-get install vlc <optional extra components>

Or search for vlc with the graphical package manager you like best. It should be in the main Debian repository in the section Video software. Additional plugins are available and most require manual selection, e.g. vlc-plugin-access-extra, vlc-plugin-notify and vlc-plugin-jack.

For a standard install with libdvdcss:

A simple install of the libdvdcss package can be found here: https://download.videolan.org/debian/stable/, but for future bug fixes add the following lines to your /etc/apt/sources.list: 

 deb https://download.videolan.org/debian/stable stable main
 deb-src https://download.videolan.org/debian/stable stable main

Then: 

# apt-get update
# apt-get install vlc libdvdcss2 <optional extra components>

This will allow you to decrypt DVDs.

Ubuntu logo Ubuntu

Links: Download page • Launchpad (Source • Bugs sorted by most users • Questions)

Launch the Ubuntu Software Center and go to All Software → Sound & Video then in search VLC Player. After it will come click on it and it will automatically install

You need to check that a universe mirror is listed in your /etc/apt/sources.list file. 

$ sudo apt-get update
$ sudo apt-get install vlc vlc-plugin-pulse mozilla-plugin-vlc

As given by https://help.ubuntu.com/community/RestrictedFormats/PlayingDVDs: 

$ sudo apt install libdvd-pkg && sudo dpkg-reconfigure libdvd-pkg

will install a packaged version of libdvdcss without the need for third-party repos.

Red Hat

  • Red Hat logo
  • CentOS logo

Adapted (annotated) from https://www.videolan.org/vlc/download-redhat.html:

Red Hat/CentOS/Scientific Linux have almost the same setups (they're all derived from Red Hat). Red Hat and derivatives have different instructions if EPEL (Extra Packages for Enterprise Linux) is not set up. Red Hat Network (RHN) users should verify that they have enabled the optionals and extras channels for RHN subscriptions.

If you want to have DVD playback ability, you will need to install the libdvdcss package too (source).

For the latest version (up to the now-current version 3.0.6) use RPM Fusion, otherwise VLC branches 2.0.x and 2.2.x are available: Red Hat/CentOS/Scientific Linux 7: (vlc-2.2.x – branch available for x86_64 architectures) 

$> su -
    #> yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
    #> yum install https://download1.rpmfusion.org/free/el/rpmfusion-free-release-7.noarch.rpm
    #> yum install vlc
    #> yum install vlc-core             # (for minimal headless/server install)
    #> yum install python-vlc npapi-vlc # (optionals)

Red Hat/CentOS/Scientific Linux 6: (vlc-2.0.x branch – available for i686 and x86_64 architectures) 

$> su -
    #> yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm
    #> yum install https://download1.rpmfusion.org/free/el/rpmfusion-free-release-6.noarch.rpm
    #> yum install vlc
    #> yum install vlc-core             # (for minimal headless/server install)
    #> yum install python-vlc npapi-vlc # (optionals)

SUSE

Download page: https://www.videolan.org/vlc/download-suse.html

FreeBSD

Download page: https://www.videolan.org/vlc/download-freebsd.html

Install vlc from the packages collection: 

# pkg install vlc

Compile the sources by yourself

For more detailed information on compiling VLC, please see Compile VLC.

This page is part of official VLC media player Documentation (User Guide • Streaming HowTo • Hacker Guide • Modules)
Please read the Documentation Editing Guidelines before you edit the documentation
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
Retrieved from "https://wiki.videolan.org/index.php?title=Documentation:Installing_VLC&oldid=60393"