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