VideoLAN Wiki - User contributions [en]

Windows

2010-10-05T10:02:09Z

Mexxx:

The '''Windows port''' of VLC usually starts up with the [[Qt]] interface which is used in the [[Linux]] one as well. The user can decide to use the [[Skins]] interface instead to be able to modify the interface according to his or her mood.

== Frequently Asked Questions ==
There are some user-maintained FAQs (as distinct from the official VLC FAQ that may be found [http://www.videolan.org/support/faq.html here]):
* [[WindowsFAQ-1.0.x|Version 1.0 and newer]]
* [[WindowsFAQ-0.9.x|Version 0.9.x]]
* [[WindowsFAQ-0.8.x|Version 0.8.x]]

==Keyboard shortcuts in the Windows (directx) video output==
:''See also: [[QtHotkeys]], [[How to set global hotkeys]]''.

Note: these shortcuts are only default settings and can be customized (along with many others). To tweak hotkeys settings, go to Settings->Preferences->Interface->Hotkeys settings

{| class="wikitable"
| F
| Fullscreen
|-
| Space
| Play/Pause
|-
| T
| Show position (time)
|-
| S
| Stop
|-
| Ctrl+Q
| Quit
|-
| +/-
| Faster/Slower
|-
| N/P
| Next/Previous
|-
| Shift+Left/Shift+Right
| Jump very short
|-
| Alt+Left/Alt+Right
| Jump short
|-
| Ctrl+Left/Ctrl+Right
| Jump medium
|-
| Ctrl+Alt+Left/Ctrl+Alt+Right
| Jump long
|-
| Ctrl+Up/Ctrl+Down
| Volume up/down
|-
| M
| Mute
|-
| Ctrl+M
| Show DVD-menu
|-
| Left/Right<br/>Up/Down<br/>Enter
| DVD-menu navigation keys
|}

==How to store streaming station presets==

To use VLC as a streaming client, store your station presets under the Media Library on the Playlist panel (''not'' the bookmarks and ''not'' the actual playlist itself).
#Open the playlist panel (Ctrl-L or click on the Playlist button).
#Click on the Plus button at the bottom of the panel. (A dropdown menu will appear.)
#Select "Advanced Open" from the dropdown menu. (A new panel, named Open Media, will appear.)
#Select the "Networking" tab on the Open Media panel.
#Enter the full URL of the streaming station in the Address field. e.g. http://mystation.org:8000/mystream.ogg
#Click the Enqueue button at the bottom of the panel.

==How to associate media files to VLC==

This should be done through the VLC settings interface, choose "Tools | Preferences " and then click on the "Set up Associations..." button.
Select any file extension that you wish to open with VLC, then click "Apply". This should change all media files icons to the VLC cone, and double-clicking any of them should open VLC and immediately start playing the media.

If this seems to have no effect on the UI, and/or double-clicking the file icon does not start VLC, check that you have correctly set Windows preferences through "Start | Default Programs" (on Vista; see the relevant item on Windows XP or newer Windows OS; possibly this is not applicable to Windows 2000).
In that UI click on "Set default programs", select the "VLC media player" item and check the description (it will usually say "All default settings for this program are active"). Then choose your own course of actions by either clicking on "Set this program as default" or "Choose default settings for this program".

Other ways to achieve the same effects are as follows (not really recommended).

===Use Windows Explorer's context menu===

#In Windows Explorer, ''right''-click a file you wish to open.
#Click "Open With" in the context menu that pops up.
#Click "VLC media player" to use VLC just this once, or click "Default program..."
#Click the name of the program (VLC) which you want to be used to open the file.
#*If VLC is not displayed, click Browse to locate it on your hard drive.

Alternatively:
#In Windows Explorer, ''right''-click the file you want to open with VLC.
#Click Properties in the context menu that pops up.
#On the General tab, click Change.
#Click the name of the program (VLC) which you want to be used to open the file.

Either of these options affects all files that have the same filename extension (the letters after the filename's period) as the file you selected. For example, if you change the program that opens ''goober.avi'', then all ''.avi'' files will be opened with VLC.

===Rerun the installer===
#Reinstall VLC and choose the "associate files" option when it comes up. ''Please note'' that on Vista and newer OSes this will not cure the "Windows Media Player won't go away" symptom, and you should go the "Set default program" route instead, as described above.

===Edit the registry===
'''''Warning''''': this instruction set is outdated and should ''not'' be used. Direct registry editing should be avoided anyway unless you're desperate and you really ''really'' know what you're doing.

'''Warning''': use this technique only if you really know what you are doing! And be sure to back-up your registry first.

#Open a text editor, like Notepad (but not WordPad).
#Copy this text below.
#Modify the strings ''C:\\Program Files\\VideoLAN\\VLC\\vlc.exe'' to match your VLC installation.
#Save as ''vlc.reg''.
#Execute ''vlc.reg'' (adding this data to your registry).
#Enjoy VLC :)

Text to copy:
<pre>
Windows Registry Editor Version 5.00

[HKEY_CLASSES_ROOT\.ASF]
@="VlcFile"

[HKEY_CLASSES_ROOT\.ASX]
@="VlcFile"

[HKEY_CLASSES_ROOT\.AVI]
@="VlcFile"

[HKEY_CLASSES_ROOT\.DIVX]
@="VlcFile"

[HKEY_CLASSES_ROOT\.MPEG]
@="VlcFile"

[HKEY_CLASSES_ROOT\.MPG]
@="VlcFile"

[HKEY_CLASSES_ROOT\.VOB]
@="VlcFile"

[HKEY_CLASSES_ROOT\.WMV]
@="VlcFile"

[HKEY_CLASSES_ROOT\VlcFile]
@="VLC File"

[HKEY_CLASSES_ROOT\VlcFile\DefaultIcon]
@="C:\\Program Files\\VideoLAN\\VLC\\vlc.exe,0"

[HKEY_CLASSES_ROOT\VlcFile\shell\Open]
[HKEY_CLASSES_ROOT\VlcFile\shell\Open\command]
@="C:\\Program Files\\VideoLAN\\VLC\\vlc.exe \"%L\""
</pre>

'''Note''': This associates ''asf'', ''asx'', ''avi'', ''divx'', ''mpeg'', ''mpg'', ''vob'' and ''wmv'' files. If you get the idea, you can associate any file you want.

==How To Start VLC Server with http Interface==
VLC ships with a little HTTP server integrated. It is used both to stream using HTTP, and for the HTTP remote control interface.

===VLC Server Preferences Settings===
1. Set up the http interface details in the VLC server application. Open VLC then select Settings > Preferences. Click on the Advanced Settings button in the lower right hand corner of the dialog box to see all the options that are available.

2. In the left hand window click on the + button next to Interface. This will display three choices. Control interfaces, Hotkeys settings, and Main Interfaces. Click on the plus button next to Main interfaces. This will display four settings HTTP, RC, Skins, wxWidgets. Click on HTTP to dispaly the "HTTP remote control interface settings".

3. Host address: Enter the port number that you want to use. Default is 8080.

4. Source directory: c:\Program Files\VideoLan\VLC\http\ or enter the path where you have elected to install the application.

5. Character set: UTF-8 default

6. If you are NOT using handlers or SSL certificates the setup is complete.

7. Click on the Save button in the lower left hand corner.

8. Remember to edit the .hosts file in the vlc/http directory, will only allow localhost, edit to enable other hosts.

===Command Line Startup===

The VLC appplication can be run in a server or client environment. For complicated
video and audio streaming on a LAN, one should consider dedicating a machine to act
as the VLC server.

To start the VLC application in a server mode with the http interface automatically
set, use the following command line in your desktop shortcut. This assumes the default
location for installation was selected.

<nowiki>"C:\Program Files\VideoLAN\VLC\vlc.exe" --extraintf http --intf wx</nowiki>

===Testing the Interface===

From another computer, connect to the VLC server computer using your browser to the URL

<nowiki>http://server_ip_address:8080, such as http://192.168.0.186:8080</nowiki>

The Main VLC Interface page will be displayed,

See [[Web_Interface]] for additional information

==VLC Plugin for Internet Explorer==

This section will provide guidelines to incorporate the VLC ActiveX plugin to be used to view streaming audio and video from a VLC server.

How to embed the ActiveX Plugin in a Web Page: [[ActiveX/HTML]]

Supported ActiveX Function Calls: [[ActiveX]]

==VLC Plugin for Firefox (Mozilla)==
The Mozilla plugin
(Excerpted from the [[Documentation:Play_HowTo/Advanced_Use_of_VLC#The_Mozilla_plugin|VLC User Guide]])

'''Install'''

There are at least two ways to install the VLC Mozilla Plugin. One way is to to check the "Install Firefox Plugin" when you install VLC.

If the standard exe installation does not install the mozilla plugin directory then download zip version which includes the required data and continue with the next installation (2nd way of installing of the plugin)

The second way involves several steps:

1. Quit Firefox or Mozilla

2. Copy the two files in VLC_Installation_folder\mozilla (usually C:\Program Files\VideoLAN\VLC\mozilla) to your mozilla plugins directory (Usually C:\Program Files\Mozilla\plugins or C:\Program Files\Mozilla Firefox\plugins).

3. Restart Firefox or Mozilla

'''Use the plugin'''

If you open a link to a video file handled by the VLC plugin (To get the list of handled types, browse to about:plugins) or a page with an embedded video, the plugin should open and read the video.

'''Build HTML pages that use the plugin (VLC version > 0.8.5)'''

Check the [[Documentation:WebPlugin|WebPlugin]] documentation for information on the Javascript API. It's substantially changed since v0.8.5.

'''Build HTML pages that use the plugin (VLC version up to 0.8.5)'''

Additionally to viewing video on all pages, you can build custom pages that will use the advanced features of the plugin, using Javascript functions to control playback or extract information from the plugin.

The vlc plugin for Firefox/Mozilla supports the following function calls:

play() : Start playing media in the plugin.
pause() : Pause playback.
stop() : Stop media playback.
fullscreen() : Switch the video to full screen.
set_volume(vol) : Set the volume. vol has to be an int in the 0-200 range.
get_volume() : Get the current volume setting.
mute() : Toggle volume muting.
set_int_variable(var_name, value) :
set_bool_variable(var_name, value) :
set_str_variable(var_name, value) :
get_int_variable(var_name) :
get_bool_variable(var_name) :
get_str_variable(var_name) :
clear_playlist() : Clear the playlist.
add_item(mrl>) : Append an item whose location is given by the Media Resource Locator to the playlist.
next()
previous()
isplaying() : return true if the plugin is playing something.
get_length() : Get the media's length in seconds.
get_position() : Get the current position in the media in percent.
get_time() : Get the current position in the media in seconds.
seek(seconds,is_relative) : If is_relative is true, seek relatively to current time, else seek from beginning of the stream. Seek time is specified in seconds.

Here are a few examples of HTML pages that use the Mozilla plugin.
Example 1

In this example, the plugin will read an HTTP stream inside the web page. If the user goes fullscreen, he will have to press f or escape to go back in normal view.

<pre>
<html>
<head><title>Demo of VLC mozilla plugin</title></head>

<body>

<h1>Demo of VLC mozilla plugin - Example 2</h1>

<embed type="application/x-vlc-plugin"
name="video2"
autoplay="no" loop="no" hidden="yes"
target="udp:@239.255.12.42" />
<br />
<a href="javascript:;" onclick='document.video2.play()'>Play video2</a>
<a href="javascript:;" onclick='document.video2.stop()'>Stop video2</a>
<a href="javascript:;" onclick='document.video2.fullscreen()'>Fullscreen</a>

</body>
</html>
</pre>

More example code, as well as a working implementation using Javascript, XHTML, and PHP that auto-detects browsers (the code is good, but the stream doesn't work) can be found at http://altair.videolan.org/~dionoea/vlc-plugin-demo/

<h1>Demo of VLC mozilla plugin - Example 2</h1>

<pre>
<embed type="application/x-vlc-plugin"
name="video2"
autoplay="no" loop="no" hidden="yes"
target="udp:@239.255.12.42" />
<br />
<a href="javascript:;" onclick='document.video2.play()'>Play video2</a>
<a href="javascript:;" onclick='document.video2.stop()'>Stop video2</a>
<a href="javascript:;" onclick='document.video2.fullscreen()'>Fullscreen</a>
</pre>

More example code, as well as a working implementation using Javascript, XHTML, and PHP that auto-detects browsers (the code is good, but the stream doesn't work) can be found at http://altair.videolan.org/~dionoea/vlc-plugin-demo/

== Related article ==
* [[Common Problems]]
* [[VLC command-line help]]
* [[VLCSout]] how to create a DVD

== Portable VLC ==
A version of VLC in a portable format exists. It is useful, for example, if you want to put it on a USB stick and use it on computers you don't own. It can also be very useful on your own computer: if you have to reinstall Windows, you won't need to reinstall VLC, it will be up and running almost instantly:<br>
http://portableapps.com/apps/music_video/vlc_portable

<h1>External Links</h1>
[http://pckeeper.zeobit.com/ PC Keeper]

[[Category:Operating systems]]

Documentation:Installing VLC

2010-08-30T09:38:32Z

Mexxx: /* External Links */

{{RightMenu|documentation play howto toc}}

==Installing VLC==

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.

===Windows===

VLC works under Windows 95/98/ME/2000/XP/7.
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.
Example for english installation: vlc-1.1.0-win32.exe /L=1033 /S

===Mac OS X===

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''').

===BeOS===

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.

===Debian GNU/Linux===

====Debian stable (sarge)====

Add the following lines to your '''/etc/apt/sources.list''':
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:

# '''apt-get update'''
# '''apt-get install vlc libdvdcss2'''

====Debian testing (etch)====

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.

For more informations on Debian testing, please look: [http://www.debian.org/devel/testing testing page].

====Debian unstable (sid)====

Add the following lines to your '''/etc/apt/sources.list''':

deb http://download.videolan.org/pub/videolan/debian sid main
deb-src http://download.videolan.org/pub/videolan/debian sid main

Then, for a normal install, do:

# '''apt-get update'''
# '''apt-get install vlc libdvdcss2'''

===Linux Mandrake===

There are VLC packages for Mandrake 9.1 and cooker.

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.

Then install the required packages with '''urpmi''':

# '''urpmi libdvdcss2 libdvdplay0 wxvlc vlc-plugin-a52 vlc-plugin-ogg vlc-plugin-mad'''

===Linux CentOS (EL5)===

1. download and install the latest rpmforge-release rpm (eg rpmforge-release-0.3.6-1.el5.rf.i386.rpm)

2. either;

yum install vlc

or (if you have epel-release installed);

yum --disablerepo='epel' install vlc

===Linux Redhat===

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.

Then install the RPM packages you have downloaded:

# '''rpm -U *.rpm'''

If you have not installed all the RPM packages included with your distribution, you may be asked to install a few of them first.

===Compile the sources by yourself (for every other OS)===

For more detailed information on compiling VLC by yourself, please have a look at the documentation on our [http://developers.videolan.org developers website].

==Uninstalling VLC==

===Windows===

Click on the ''Uninstall VLC'' icon that was created during installation.

===Mac OS X===

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.

===BeOS===

Delete the '''vlc-version''' directory. You can also remove the configuration file '''/boot/home/config/settings/vlcrc'''.

===Debian GNU/Linux===

Remove the packages that you installed:

# '''apt-get remove --purge vlc libdvdcss2'''

===GNU/Linux Redhat, Mandrake and SuSE===

Uninstall the RPM packages that you installed:

# '''rpm -e vlc-version vlc-mad-version wxvlc-version libdvdcss2-version libdvdpsi1-version'''

===If you compiled VLC from sources===

Go to the directory containing VLC sources and execute

# '''make uninstall'''

You can then remove the VLC sources.

==External Links==

[http://www.mac-how.net/ Mac-How]Everything about Macintosh OS

{{Documentation}}

Documentation:Installing VLC

2010-08-30T09:37:52Z

Mexxx:

VLCKit

2010-08-12T15:49:45Z

Mexxx:

=== Build the framework ===

* open <code>./vlc/projects/macosx/framework/VLCKit.xcodeproj</code>
* make sure the VLCKit target is selected
* rightclick on target and build

this should autatically build vlc itself at the same time in projects/macosx/framework/build/vlc_build_dir
== Basic usage in your application ==
The code should speak by itself
// Set up a videoView by hand. You can also do that in the nib file
videoView = [[VLCVideoView alloc] initWithFrame:[[window contentView] bounds]];
[[window contentView] addSubview:videoView];
[videoView setAutoresizingMask: NSViewHeightSizable|NSViewWidthSizable];

// Init the player object
player = [[VLCMediaPlayer alloc] initWithVideoView:videoView];

[player setMedia:[VLCMedia mediaWithPath:@"/to/my/movie"]];
[player play];

== Sample code ==
You should be able to find sample code in:
* <code> ./vlc/projects/macosx/framework/Examples </code>: This is the folder that contains the VLC.framework basics usage.

* <code> ./vlc/projects/macosx/vlc_app </code>: This is the VLC application that uses the framework intensivly, this is much more advanced.

=== Additional resources ===
* [http://mackeeper.zeobit.com/mac-recovery-software Data Recovery Software for Mac]