Difference between revisions of "Documentation:Installing VLC"

From VideoLAN Wiki
Jump to navigation Jump to search
(→‎SUSE: New section with link to https://www.videolan.org/vlc/download-suse.html)
 
(142 intermediate revisions by 22 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/7.
+
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.
 
  
Unattended/silent installation: Use "filename" /L="languagecode" /S.
+
=== 2000, XP, Vista, 7, 8, 10 ===
Example for english installation: vlc-1.1.0-win32.exe /L=1033 /S
 
  
===Mac OS X===
+
==== Recommended ====
  
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''').
+
The normal and recommended way to install VLC on a Windows operating system is via the installer package.
  
===BeOS===
+
'''Step 0: Download and launch the installer'''
  
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.
+
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 GNU/Linux===
+
'''Step 1: Select an installer language'''
  
====Debian stable (sarge)====
+
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'''.
  
Add the following lines to your '''/etc/apt/sources.list''':
+
[[File:Step-1-select-language.png]]
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:
+
'''Step 2: Review the Welcome screen'''
  
# '''apt-get update'''
+
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'''.
# '''apt-get install vlc libdvdcss2'''
 
  
====Debian testing (etch)====
+
[[File:Step-2-welcome.png]]
  
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.
+
'''Step 3: Read License agreement'''
  
For more informations on Debian testing, please look: [http://www.debian.org/devel/testing testing page].
+
Read the Terms of Service. Once you're done reading, click '''Next'''.
  
====Debian unstable (sid)====
+
[[File:Step-3-licence.png]]
  
Add the following lines to your '''/etc/apt/sources.list''':
+
'''Step 4: Select components'''
  
deb http://download.videolan.org/pub/videolan/debian sid main
+
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'''.  
deb-src http://download.videolan.org/pub/videolan/debian sid main
 
  
Then, for a normal install, do:
+
[[File:Step-4-components.png]]
  
# '''apt-get update'''
+
'''Step 5: Pick a location'''
# '''apt-get install vlc libdvdcss2'''
 
  
===Linux Mandrake===
+
Click '''Browse...''' to choose the destination installation folder. After you've identified the desired folder, click '''Install'''.
  
There are VLC packages for Mandrake 9.1 and cooker.
+
[[File:Step-5-install-location.png]]
  
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.
+
'''Step 6: Now installing'''
  
Then install the required packages with '''urpmi''':
+
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.
  
# '''urpmi libdvdcss2 libdvdplay0 wxvlc vlc-plugin-a52 vlc-plugin-ogg vlc-plugin-mad'''
+
[[File:Step-6-installing.png]]
  
===Linux CentOS (EL5)===
+
'''Step 7: Installation complete'''
  
1. download and install the latest rpmforge-release rpm (eg rpmforge-release-0.3.6-1.el5.rf.i386.rpm)
+
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.
  
2. either;
+
[[File:Step-7-completed.png]]
  
yum install vlc
+
==== Alternative ====
  
or (if you have epel-release installed);
+
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'''.
  
yum --disablerepo='epel' install vlc
+
'''PowerShell'''
  
 +
Installing VLC using PowerShell is as easy.
  
===Linux Redhat===
+
[[File:Step-8-silent-installation-ps.png|669px]]
  
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.
+
'''Command Prompt'''
  
Then install the RPM packages you have downloaded:
+
You can also install VLC using the command prompt.
  
# '''rpm -U *.rpm'''
+
[[File:Step-9-silent-installation-cmd.png]]
  
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:Applelogo.jpg|100x100px|alt=macOS logo]] macOS ==
  
===Compile the sources by yourself (for every other OS)===
+
#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''').
  
For more detailed information on compiling VLC by yourself, please have a look at the documentation on our [http://developers.videolan.org developers website].
+
Note: You may need to delete older versions of VLC on your computer before you can successfully install the latest version.
  
==Uninstalling VLC==
+
== Linux ==
 +
=== [[File:Debian-logo.jpg|100x100px]] Debian ===
 +
Download page: https://www.videolan.org/vlc/download-debian.html
  
===Windows===
+
'''A standard install without libdvdcss:'''
 +
{{prompt|root}} apt-get update
 +
{{prompt|root}} apt-get install vlc <optional extra components>
  
Click on the ''Uninstall VLC'' icon that was created during installation.
+
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>.
  
===Mac OS X===
+
'''For a standard install with libdvdcss:'''
  
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.
+
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>
  
===BeOS===
+
Then:
 +
{{prompt|root}} apt-get update
 +
{{prompt|root}} apt-get install vlc libdvdcss2 <optional extra components>
  
Delete the '''vlc-version''' directory. You can also remove the configuration file '''/boot/home/config/settings/vlcrc'''.
+
This will allow you to decrypt [[DVD]]s.
  
===Debian GNU/Linux===
+
==== [[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])
  
Remove the packages that you installed:
+
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
  
# '''apt-get remove --purge vlc libdvdcss2'''
+
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
  
===GNU/Linux Redhat, Mandrake and SuSE===
+
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.
  
Uninstall the RPM packages that you installed:
+
=== 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>
  
# '''rpm -e vlc-version vlc-mad-version wxvlc-version libdvdcss2-version libdvdpsi1-version'''
+
Adapted (annotated) from https://www.videolan.org/vlc/download-redhat.html:
  
===If you compiled VLC from sources===
+
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.
  
Go to the directory containing VLC sources and execute
+
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]).
  
  # '''make uninstall'''
+
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)
  
You can then remove the VLC sources.
+
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 (SourceBugs sorted by most usersQuestions)

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

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 GuideStreaming HowToHacker GuideModules)
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.