View source for Windows

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&nbsp;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

[[Category:Operating systems]]