MacOS

2009-12-08T15:48:00Z

Bobbyshou:

<div style="width:820px;border: 1px solid #ffc9c9>
{{vlc_MacOS_toc}}
<div style="padding: .4em .9em .9em">

==Graphical Interface==
Many people who want to use [[VLC media player]] on Mac OS X will be intending to use the standard graphical interface that is provided by vlc. The standard interface consists of the eight menus in the menu bar and the 'VLC - Controller' window that opens up by default. This section outlines what vlc can do for you (at V0.8.6a current active is V{{VLC:latest version}}) and will be completed as I check the use of menu options.

The eight menu bar options are listed below along with the main interesting capabilities under each menu item:

* [[vlc_MacOS_VLC|VLC]] which allows you to check for an updated application, to access the preferences and to add an interface.
* [[vlc_MacOS_File|File]] which allows you to open a media file or an associated file such as subtitles. It also has a wizard to allow the streaming of video or the capturing of a streamed video to a file.
* [[vlc_MacOS_Edit|Edit]] which does nothing vlc specific.
* [[vlc_MacOS_Playback|Playback]] allows you do do all the things you might expect from a videoplayer, some of these features are duplicated graphically in the 'Controller' window.
* [[vlc_MacOS_Audio|Audio]] allows you to control the audio level as well as the output device and the audio track to use from the input.
* [[vlc_MacOS_Video|Video]] allows you to control the video display on your screen as well as which device to display on and which video source to show in that display.
* [[vlc_MacOS_Window|Window]] allows you to display seven helper windows that will display information about vlcs activity and control more detail of that activity.
* [[vlc_MacOS_Help|Help]] gives access to the help that came with the installation, the help info on the VideoLAN site and access to interaction mechanisms with the vlc developers.

In general, for many users, they find that they can get what they want from vlc 'straight out of the box' and have very little need of the menu options until they have been using vlc for a while and now want to try something 'more fancy'.

==Keyboard Shortcuts==
You can find most of the keyboard shortcuts by taking a look at the menus. Additional hotkeys are defined in the section "Hotkeys" of your VLC preferences.

Some handy key combo's are:

* You can use the spacebar to start/pause the video.
* When playing video, holding down the Apple key and pressing the F key enters and exits fullscreen. When in fullscreen you can also use the escape key to exit the fullscreen state.
* When playing video, holding the Apple and Shift keys and pressing the left/right arrow keys, jumps the video backward/forward about a minute.
* When playing video, holding the Apple and Ctrl keys and pressing the left/right arrow keys, jumps the video backward/forward about ten seconds.
* When you are watching a DVD and the video window is the front-most window you can use the arrow keys and the enter key to navigate the DVD menus.

* F - Decrease Audio Delay in milliseconds
* G - Increase Audio Delay in milliseconds
* H - Decrease Subtitle Delay
* J - Increase Subtitle Delay

==Latest developments==

===Streaming Wizard===
A streaming wizard is available since the VLC media player 0.8.4 release. This is available under the "File" menu.

=== Command line ===

You can run VLC on Mac OS X using a terminal application (for example Terminal.app in /Applications/Utilities) with the following command: ./VLC.app/Contents/MacOS/VLC [your options, "--intf=rc" for example]. On most Bourne-like shells, you can set an alias to just vlc with the following command: alias vlc='/Applications/VLC.app/Contents/MacOS/VLC'. It can be helpful to add this command to your shell setup file.

This option can also be activated from the "VLC" menu.

=== No Dock ===
Note that you can replace the "VLC" at the end of the path with "clivlc" to suppress the launch of any Mac-like interface.
VLC won't even appear in the Dock then.

When [[transcoding]], clivlc should be used if running VLC from the command line crashes with a Bus error.

==Need Help?==
View the [[FAQ on MacOSX only issues]] or the [[Common Problems]] pages.
[[Category:Operating systems]]

</div>
</div>

Windows

2009-12-08T15:30:33Z

Bobbyshou: /* How to associate media files to VLC */

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.

==Keyboard shortcuts in the Windows (directx) video output==
:''See also: [[QtHotkeys]]''

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 filesAlternatively, you can:

#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 optio to VLC==

VLC hasn't got a module to associate files so that if you click on a file VLC automatically opens. The developers are working on this, and one should be available in the next full release. But you can do it yourself by choosing one of these three options:

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

#In Windows Explorer, ''right''-click a file you wish to open.
#Clicking Open With from the context menu that pops up.
#Clicking the VLC's program name.
#*If VLC is not displayed, click Browse to locate it on your hard drive.

ns 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.

===Edit the registry===
'''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 to go back in normal view.

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

<body>

== Related article ==
* [[Common Problems]]
* [[VLC command-line help]]
* [[VLCSout]] - converting between formats

[[Category:Operating systems]]

<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

[[Category:Operating systems]]

VideoLAN Wiki - User contributions [en]

MacOS

Windows