VideoLAN Wiki - User contributions [en]

What can VLC do?

2011-03-05T21:38:55Z

Popol0909: /* Listen to online radio */ Typos, added bulleted list

This area of the wiki contains a list with the possibilities {{VLC}} gives you. It was made to help people better realize the potential {{VLC}} has. Some entries will simply mention the possibility, others try to explain how to do it as well. Let me start by apologising for my horrible spelling, but I hope you will be able to decipher the texts anyway.

== Mediaplayer ==

=== Compact Disc (CD) Images ===
If you have a [[CD-DA]] (audio CD), [[SVCD]], or [[VCD]] packaged inside a CD-image, in some cases [[VLC media player]] can play this without you having to mount it or extract it. You can simply choose "open file" and pick the CD-image. For CD-image support vlc has to be [[compile]]d using [[libcdio]] (<tt>--enable-libcdio</tt>) and the various plugins which use libcdio need to be selected (<tt>--enable-cddax</tt>, <tt>--enable-vcdx</tt>). Some of these enablements may not be the default for your OS.

The kinds of Compact Disc formats supported are CDRWIN's BIN/CUE format, cdrdao's TOC format, and a limited set of Nero (NRG) formats.

(''[[libcdio]] also supports ISO-9660 image reading but at present there is no VLC access plugin which uses it. DVD's images follow the UDF format and at present there is no support in libcdio for that, although some limited progress has been made in that direction. It is possible that will get added in the future; volunteers are most welcome).

=== How to enable/use subtitles ===
Before you try to enable [[subtitle]]s make sure the subtitles you have are in a format that VLC can read! You can find the list of compatible subtitle formats [http://www.videolan.org/vlc/features.html here].
If VLC has detected any sort of subtitles available, you will be able to turn them on under the menu: ''Video->Subtitles track->Track 1''

Auto detection of subtitle files uses a 'fuzzy' logic which you can specify. If this is wrongly specified you may end up with more subtitle file options than really exist or miss some that are provided. By default it allows any file in the right place which exactly matches the video name, and may have some extra characters. If you are not seeing the number of subtitle options you expect you might want to allow more 'fuzziness' by changing the preference in video/subtitles/subtitle autodetection where help is available if you 'hover' over the field.

If you mainly use .srt subtitles or .sub, you can get them turned on automatically when they are detected, by setting the ''Input/Codecs->Advanced->Choose subtitle track'' to 0, it will automatically turn on the subtitle track. You can also experiment with the ''Choose subtitle language'' on the same page. But if you experiment a bit with the settings you should be able to get subtitles turned on automatically.

'''Notes:''' On Mac OS X, the "Video->Subtitles track" menu item is permanently disabled for some reason. You must manually specify the location of the subtitles file in the "Subpictures" pane of the preferences.

Unfortunately the default font for (srt-)subtitles doesn't include unicode characters (hexadezimal number) 2011 (non-breaking-hyphen), 2012 (figure dash) and 2a2f (cross-product) ...

=== Playing windows media files ===
VLC should be able to succesfully play both audio and video in wma and wmv 1 and 2, for the newest version (wmv3) only the windows version of vlc will be able to play it, since no opensource implementation of wmv3 have been made so far, so the windows vlc plays it by using the windows api. DRM files however can not be played on any OS.

=== How to adjust picture brightness/colors/contrast.. ===
'''If you are using the wxwindows userinterface:'''
You can adjust the typical values to tweak the picture of your video source by turning on the extended GUI. This is done in the menu: ''Settings->Extended GUI''. That will give you some extended control options for the video picture as well as an equalizer for the audio. Before it actual works though, you have to enable the filters under the preferences->video

'''If you use Mac OS X or a skinned version of VLC:'''
You need to enter the preference menu: ''Settings->Preferences''. Once you have the preferences window open you go to: Video->Filters->Image adjust. Here you can adjust the different values. Note before they take effect you need to turn on the "Image adjust" filter in: Video->Filters

=== How to control the aspect ratio of the video ===
Using VLC, you can override the source aspect ratio. This is available both as a command line option and as an option in the Preference dialog in the graphical interface. The aspect ratio can be specified both in ratio format (16:9) or as a decimal number (1.33).

'''Command Line'''

When invoking VLC from the command line, use the option --aspect-ratio. For instance,

vlc --aspect-ratio 1:5

'''Graphical Interface'''

If using the graphical interface, the setting is In the Video section of the Preferences dialog. You may specify the aspect ratio in the field labeled "Source aspect ratio."

Here is a list of the more common aspect ratios.

* Fullscreen: 1.33 or 4:3
* Widescreen: 1.78 or 16:9
* Typical DVD: 1.85
* Cinemascope: 2.35

===Be remotely controlled===
VLC provides a series of interfaces which allow it to be controlled in various ways such as via telnet, a web browser, several iPhone apps desktop widgets and more. [[How_to#Remote_Control_for_VLC | Details are here]].

=== Announce What's Playing to IRC ===
Announce the currently playing track to mirc (an irc client). This is often referred to as a "now playing" script. To be able to get this functionality with vlc one approach would be to use the HTTP interface. With it you can create a simple file which will display "'Artist' with the song 'Title' from the album 'Album' the genre is 'Genre'" on a page in ur browser. You can then pull that page from mirc with standard sockets and thereby use the text in a script in mirc. Below I will provide some VERY simple and very ugly examples on how you could use this. The examples are tested with vlc 0.8.5 and mirc 6.12. I can't guarantee the code work with any other versions (although it most likely will). Ok so here we go. You start with create a test.html file in the http interface directory (C:\Program Files\VideoLAN\VLC\http) inside this file paste the following to ONE line or it will not work:

<pre>
ANNOUNCE <vlc id="value" param1="'ARTIST' vlc_get_meta"/>
with the song <vlc id="value" param1="'TITLE' vlc_get_meta"/>
from the album <vlc id="value" param1="'ALBUM' vlc_get_meta"/>
, The genre is <vlc id="value" param1="'Genre' vlc_get_meta"/>
</pre>
-or for streaming server info-
<pre>
ANNOUNCE <vlc id="value" param1="'TITLE' vlc_get_meta"/>
with the song <vlc id="value" param1="'NOW_PLAYING' vlc_get_meta"/>
</pre>

Remember to leave an empty line behind the actual line of code, vlc/mirc seems to want this.
Then you must create a script in mirc under remote (alt+r) and paste in the following:

<pre>
alias now {
sockopen vlc_meta_info 127.0.0.1 8082
}

on *:SOCKOPEN:vlc_meta_info: {
sockwrite -n $sockname GET /test.html HTTP/1.1
sockwrite -n $sockname Host: localhost
;sockwrite -n $sockname Connection: Keep-Alive
sockwrite -n $sockname $crlf
sockwrite -n $sockname $null
}

on *:sockread:vlc_meta_info: {
if ($sockerr > 0) return
:nextread
sockread %temp
if ($sockbr == 0) return
if (%temp == $null) %temp = ---
if (ANNOUNCE isin %temp) {
%temp = $remove(%temp,ANNOUNCE )
describe $active is listening to %temp
}
goto nextread

sockclose vlc_meta_info
}
</pre>

Only things u might want to change is the port the http interface listens on, thats the first line and is port 8082 in my case. You might also want some other text than "is listening to" just change as you see fit.

Thats pretty much it. You should enable the http interface in vlc by default if u wanna use this on a regular basis. This is done under preferences in "Interface->Main interfaces"

Then with all this done (and vlc restarted) you can type /now in mirc and it will display ur currently playing track.

This was made for mp3 tracks, so if it doesn't work with other types of media let me know.
You can reach me at: jonas (at) vrt.dk
(Im also regularly in the freenode videolan channel, nickname E-bola)

== Now Playing Script for mIRC by Jckf ==
Script and help for Inf3rn0's Now Playing script here: [http://home.no/inf3rn0/NowPlaying/ NowPlaying]

Based on E-Bola's Now Playing script.

Note: If anybody still uses this and wants to contact me, don't look for anyone named Inf3rn0. Look for Jckf ;)

== Streaming - client ==

=== Listen to online radio ===
You can of course always simply find a link to a radiostream and then open it as you would any other network stream in VLC. But if you would like to '''browse a list of online radios''', you can try the list of '''shoutcast''' radio stations VLC can download for you:
*First you need to open the playlist window: View->Playlist.
*Once you have the playlist window open chose: ''Manage->Service discovery->Shoutcast radio listings''. After 10 seconds or so the playlist should have become populated by radio station entries. You obviously require internet access for this to work!
*If you want the stations sorted alphabetically, you can chose: ''Sort->Sort by title''. Also note shoutcast have many thousands streams available, per default in 0.8.2 250 stations are downloaded, this can be changed in the preferences under: Playlist->Service discovery->Shoutcast. Note that the more stations you want to add, the longer delay you will see when the station list is downloaded, parsed, and added to the playlist. Also note you should see 2 "Folder nodes" in the playlist under shoutcast called Genres and bitrate where the stations will be listed under their respective areas. Note that most stations claim to be multi genre, so a station might be listed under both Top40, pop and rock.

=== Online Radio Addition ===
For VLC 1.0.2 "Goldeneye" under Linux, I got the Shoutcast listing by (from the VLC tools) Media/Services Discovery/Shoutcast Radio listings. After checking that option, the playlist was populated with the Shoutcast list.

== Streaming - server ==

=== VLM ===

The VLM is the Video On Demand part of the VLC streaming server features. It lets you setup a bunch of entries and then let users ask for those streams and it then gives them to the users, it has A LOT of possibilities and I will try to cover them all here.

You can divide VLM entries into 2 general categories VOD and broadcast entries.

== More ==
[[timeshift|Timeshifting]] 
[[3D]]

Documentation Talk:Documentation

2011-02-18T12:53:27Z

Popol0909:

I will be importing all the "Play HowTo" and "Streaming HowTo" to the wiki in an attempt to have uptodate docs. Please don't add or edit pages before the import is done (should be done tomorrow). [[User:Dionoea|Dionoea]] 00:49, 7 November 2006 (CET)

== Comedian spammer? ==
Removed following line from the Documentation page: ''Documentation is like sex: when it is good, it is very, very good; and when it is bad, it is better than nothing.''. It was an addition from what looks like spammer, [[User:Thresh]]. I didn't want to just delete it ... ;) --[[User:Popol0909|Popol0909]] 12:50, 18 February 2011 (UTC)

Documentation Talk:Documentation

2011-02-18T12:50:20Z

Popol0909:

I will be importing all the "Play HowTo" and "Streaming HowTo" to the wiki in an attempt to have uptodate docs. Please don't add or edit pages before the import is done (should be done tomorrow). [[User:Dionoea|Dionoea]] 00:49, 7 November 2006 (CET)

Removed following line from the Documentation page: ''Documentation is like sex: when it is good, it is very, very good; and when it is bad, it is better than nothing.''. It was an addition from what looks like spammer, [[User:Thresh]]. I didn't want to just delete it ... ;) --[[User:Popol0909|Popol0909]] 12:50, 18 February 2011 (UTC)

Documentation:Documentation

2011-02-18T12:43:26Z

Popol0909: I will place this line in the talk page ... ;)

__NOTOC__


{|style="width:100%;margin-top:0px;background-color:#fcfcfc;border:1px solid #ccc"
|style="width:56%;color:#000"|
{|style="width:280px;border:solid 0px;background:none"
|-
|style="width:280px;text-align:center;white-space:nowrap;color:#000" |
<div style="font-size:162%;border:none;margin: 0;padding:.1em;color:#000">Welcome to [[Documentation:Documentation|VideoLAN's Documentation]],</div>
<div style="top:+0.2em;font-size: 95%">The reference documentation on VideoLAN's projects.</div>
<div id="articlecount" style="width:100%;text-align:center;font-size:85%;">Articles under the [http://www.gnu.org/copyleft/gpl.html GNU General Public License] only.</div>
|}
|style="width:11%;font-size:95%;color:#000" valign="top"|
*[[VideoLAN|VideoLAN]]
*[[VLC|VLC media player]]
*[[Documentation:Documentation|Documentation]]
|style="width:14%;font-size:95%" valign="top"|
*[http://www.videolan.org Main Site]
*[http://forum.videolan.org Forum]
*[http://planet.videolan.org News from developers]
|style="width:18%;font-size:95%" valign="top"|
*[http://www.videolan.org/developers/ Developer's website]
*[http://nightlies.videolan.org Latest builds]
*[http://trac.videolan.org Trac, Bugs, SVN and roadmap]
|}


''Pages in the "Documentation" namespace are part of the official VLC media player documentation.''

''All pages in this namespace are licensed under the [http://www.gnu.org/copyleft/gpl.html GNU General Public License].''

'''Note: Parts of this documentation are currently outdated or incomplete. If you have good knowledge of a particular subject and feel that it could be documented better, please update the appropriate wiki page.'''

== [[Documentation:Play HowTo|VLC Usage Documentation]] ==

User documentation for everyone.

*[[Documentation:Play HowTo/Introduction to VLC|Introduction to VideoLAN and VLC]]

'''       Overview and history of the VideoLAN project.'''

*[[Documentation:Play HowTo/Installing VLC|Installation]]

'''       Installation instructions for a variety of computers.''' 

*[[Documentation:Play HowTo/Basic Use|VLC Usage]]
**How to play audio/video materials with the VLC media player. (For versions 0.9 and newer)
**[[Documentation:Play HowTo/Basic Use/Interface|Interface]]
***Short introduction to the interface of the VLC Media Player
**[[Documentation:Play HowTo/Basic Use/Audio|Audio]]
***Playing audio (e.g. visualization, selection of devices)
**[[Documentation:Play HowTo/Basic Use/Video|Video]]
***Playing video (e.g. cropping, screen-/snapshots)
**[[Documentation:Play HowTo/Basic Use/Playback|Playback]]
***Navigation through media files (e.g. chapters, bookmarks)
**[[Documentation:Play HowTo/Basic Use/Playlist|Playlist]]
***Creating and managing playlists
**[[Documentation:Play HowTo/Basic Use/Subtitles|Subtitles]]
***Selection of subtitles
**[[Documentation:Play HowTo/Basic Use/Video and Audio Filters|Video and Audio Filters]]
***Usage of VLC's filters (equalizer, video filters)
**[[Documentation:Play HowTo/Basic Use/Snapshots|Snapshots]]
***How to create snap-/screenshots
**[[Documentation:Play HowTo/Basic Use/Hotkeys|Hotkeys]]
***Configuration of VLC's hotkeys
**[[Documentation:Play HowTo/Basic Use/Basic troubleshooting|Troubleshooting]]
***Solutions for some common problems
*[[Documentation:Play HowTo/Advanced Use of VLC|Advanced Use]]
**Advanced instruction on streams, filters, plug-ins and more.
*[[Documentation:WebPlugin|Using VLC inside a webpage]]
**How to build webpages that use the VLC Web plugin.
*[[VLC Uninstall|Uninstallation]]
**Uninstallation instructions.

== [[Documentation:Streaming HowTo|VLC Streaming Documentation]] ==

This document explains how to stream, transcode and save streams using the VideoLAN solution. '''OUTDATED'''

'''NOTE: See [[Documentation:Streaming HowTo New|Streaming HowTo New]] for more updated information regarding streaming (WIP).'''

== [[Documentation:Hacker's Guide|The Hacker's Guide to VLC]] ==

This document will detail the inner workings of VLC and its source code.

== [[Documentation:Modules|The VLC Modules Index]] ==

This document references most of the VLC modules and their options as well as some example uses.

{{Documentation}}

User talk:J-b

2011-02-18T12:36:48Z

Popol0909: /* Spam account */

==TODO==
.tooney zone
''Please give me some TODOs here''

''Give your name and don't delete anything''
* Qt4 - jb
* Qt4 contribs - Xtophe
* Branch nightlies - Xtophe
* World domination

==Talk Here==

Hi jibbynou, I've just resuscitated the [[Frequently Asked Questions]] (formerly [[FAQ]]). I don't know if/where you want to link it from: up to you :-) -- [[User:Yoann|Yoann]] 19:44, 1 March 2007 (CET)

Plop jibbynou, you can now use <nowiki>{{RightMenu|documentation toc}}</nowiki>. See [[Template:RightMenu]] and [[Template:Documentation_toc]]. -- [[User:Yoann|Yoann]] 18:27, 21 May 2007 (CEST)

Hello, how can i contribute in ASM programing.

== Win32 V. 0.8.6i Crash On Snapshot! ==

As of 8//8/08 I have discovered what looks like a bug inside of 0.8.6i when trying to right click and choose snapshot from the playing video. It crashed the application, and bogs down windows. This happened on windows XP Home sp2, Intel p4 2.53GHz 1GB ram. All updates on machine are current, and it also has the latest quicktime, windows media player, and winamp installed.

-Sincerely
AfterBurn
: this was fixed in updated binary.

== Win32 Contribs 20070220 ==

There is some missing reference to gsm_ms_encoder and gsm_ms_decoder. I have tried to compile the libgsm, but there is no such method. Could you provide this library or give a hint, where to find it?
Besides when using your contrib some libraries need to be put in some directory named /home/videolan/j-b..... (sorry, I don't remember the path exactly (not sitting in front of the machine where I used your contrib - I will look it up on Sunday). Why does the vlc bootstrap/configure/compile reference this path which looks like it is your build path?

Thx in advance for answering my questions and keep up the good work!

:Well, this contrib may be broken because of the support and non-support of GSM in ffmpeg. This should be changed. Use another (older contrib), and I should do a new one in a few days.
::Thanks very much. I have now just added pseudo-methods for these two missing methods and it worked for me. --[[User:Hxp|Hxp]] 14:36, 14 March 2007 (CET)

== ALERT!!! PEOPLE CHARGING FOR VLC PLAYER!!!!! ==

If you download VLC player at this link http://www.vlc-mediaplayer.info/uk/ it will try to charge you £2 (via SMS) to install.
: Fixed.

== Thanks for the welcome ==

Thanks for the welcome message, Jean-Baptiste.

I've already made one suggestion [[Documentation Talk:EditingGuidelines|over here]].

As I get to know VLC, I'll try to make more contributions to the documentation wiki. I've also run a MediaWiki-based wiki for a couple of years:

http://www.screenpedia.org

But I wouldn't call myself a ''professional'' wiki admin!

Regards,

--[[User:Jeremy Butler|Jeremy Butler]] 18:12, 9 July 2007 (CEST)

== MacOS wiki ==

No probs J-b. Je vais faire ca que je pouvais, et que je comprends ! [[User:Facius|Facius]] 14:39, 8 October 2007 (CEST)

Deux petits questions:

Est-ce que mon idee de stocker les images hors du wiki reste bien ?

Est-ce q'on sais pourquoi le Template Ed n'est pas present ? [[User:Facius|Facius]] 14:42, 8 October 2007 (CEST)

: Il faut réactiver les images alors. Je vais le faire. [[User:J-b|jb]] 18:34, 9 October 2007 (CEST)
: Ed ? waht's that ?

== Bureaucrat ==

Hi, could I be a bureaucrat? I'm already a sysop, and I'll feel complete if I'm a bureaucrat. (Even though I'll probably never make anyone a sysop) [[User:The thing|The thing]] ([[User talk:The thing|Talk]] • [[Special:Contributions/The thing|Contribs]]) 21:13, 8 August 2008 (CEST)
: Done [[User:J-b|jb]] 19:51, 18 August 2008 (CEST)

== Error in article ==

Hi,
I'm using your guide to compile VLC ([[User:J-b#My_VLC]]) under Ubuntu 8.10 but is outdated: 
"''configure: WARNING: --with-ffmpeg-tree is deprecated. Use PKG_CONFIG_PATH instead.''" 
And, therefore, an error occurs when it tries to compile ''libavcodec'': 
"''checking for AVCODEC... no 
configure: error: Could not find libavcodec or libavutil. Use --disable-avcodec to ignore this error.''" 
It would be better to delete that wiki page or update it. 
Thank you anyway for your effort and work. 
A greeting.

----

'''Add''': 
Missing an important parameter in the config of ffmpeg: --enable-postproc

The name of postproc is different in ffmpeg svn version over the name that looks VLC (¿?): 
''VLC'': 
checking for POSTPROC... yes 
checking libpostproc/postproc.h usability... no 
checking libpostproc/postproc.h presence... no 
checking for libpostproc/postproc.h... no 
checking postproc/postprocess.h usability... no 
checking postproc/postprocess.h presence... no 
checking for postproc/postprocess.h... no 

<s>Solution: 
The real path/name in ffmpeg svn version is libpostproc/postprocess.h. 
The temporal solution is change the name to the file ''postprocess.h'' > ''postproc.h''

These options no longer exist:'' --with-ffmpeg-mp3lame --with-ffmpeg-faac''

For some reason I do not understand, VLC does not recognize x264 as compiled... 
Solution: 
This solves both the problem of x264 as of ffmpeg libraries: 
export PKG_CONFIG_PATH=extras/ffmpeg/libavcodec:extras/ffmpeg/libavdevice:extras/ffmpeg/libavformat:extras/ffmpeg/libavutil:extras/ffmpeg''/libswscale:extras/ffmpeg/libpostproc:extras/x264:/usr/lib/pkgconfig;./configure --prefix=/usr --enable-snapshot --enable-dbus-control --enable-musicbrainz --enable-shared-libvlc --enable-mozilla --enable-lirc --enable-live555 --with-live555-tree=extras/live --enable-x264 --enable-shout --enable-taglib --enable-v4l --enable-cddax --enable-dvb --enable-vcdx --enable-realrtsp --enable-xvmc --enable-svg --enable-dvdread --enable-dv --enable-theora --enable-faad --enable-twolame --enable-real --enable-flac --enable-tremor --enable-dirac --enable-skins2 --enable-qt4 --enable-aa --enable-caca --enable-esd --enable-portaudio --enable-jack --enable-xosd --enable-galaktos --enable-goom --enable-ggi --disable-cddax --disable-vcdx --enable-mkv --enable-dca --disable-qt --disable-kde --enable-a52 --enable-xvideo --disable-fribidi....''

Obviously, some parameters that I put into this config can (and should) change depending on the needs of each.</s>

----
Edits: 
There is a bug in the code of VLC that does not link the code of ffmpeg correctly.

: The solution is on my blog. [[User:J-b|jb]] 12:15, 30 December 2008 (CET)

== Websites' Status ==

Hello, I was just wondering if you were contemplating an upgrade of this wiki to MediaWiki 1.14 as I noticed that you are still on 1.11 which seems rather counterproductive.

I was also wondering if you had considered using [http://www.mediawiki.org/wiki/Extension:PHPBB/Users_Integration Extension:PHPBB] from mediawiki.org to allow unified login between your forum and wiki especially as you were considering OpenID.

Also do tell me if I can be of any help with the site as the code for the various VideoLAN projects is a little over my head so I'd love to help with this (I'm fairly familiar with working on community sites if not media player code).

(also something appears to be wrong with Trac: (though I'm sure this has already been noted)
<pre>:Report execution failed: invalid reference to FROM-clause entry for table "t" LINE 9: LEFT OUTER JOIN ticket_custom diff ON t.id=diff.ticket AND... ^ HINT: There is an entry for table "t", but it cannot be referenced from this part of the query.)</pre>
on the page: [http://trac.videolan.org/vlc/report/11] )

Oh and IRCWeb isn't working as of the time of writing: http://krishna.videolan.org/cgi-bin/irc/irc.cgi (can't reach server) (once again, probably noted)

Once again, tell me if I can be of any use, otherwise, thanks for the great work on VLC and the other VideoLAN projects and I'll try and help with the wiki where I can!

--[[User:Tek|Tek]] 14:42, 16 May 2009 (CEST)

== sudo make install lines? ==

Minor suggestion:

Add sudo make install lines prior to all 4 builds (vlc, live555, x264, and ffmpeg) --[[User:Neo_The_User|Neo_The_User]] 12:26 (US Central) 05/16/2009

== Audio Interface ==
Hello JB,

Problem regarding the audio interface:

I'm using a professional audio interface (Layla 24)on 1.7G AMD system w/2G of ram and am experiencing audio severe audio breakup. Interestingly the Windows media player works fine with the same files as does all of the pro-audio apps. I have tried all of the output options including direct X but default and WIN32 of course are the only ones that give any audio output. Those are rather distorted however. Any Suggestions or if you need more input We can meet on Skype for faster input.

I am experienced in audio and perhaps (I hold an advanced degree in Electro-Acoustics) I can help with some of the audio interface problems.

Ed Wolfrum

== Spam account ==

[[User:Jheena789]] seems to be a spam account. See http://wiki.videolan.org/index.php?title=Common_Problems&diff=16884&oldid=16872. [[User:Popol0909|Popol0909]] 15:36, 21 August 2010 (UTC)

== Correction needed ==
Would you please correct this annoying typo: [[VideoLAN_Wiki_talk:Rules#WikiMedia_is_not_MediaWiki]] ? Or better yet, make this page read/write for everyone. 
Pourriez vous corriger cette coquille svp: [[VideoLAN_Wiki_talk:Rules#WikiMedia_is_not_MediaWiki]] ? Ou mieux encore, mettre la page correspondante en lecture-écriture pour tous. 
Merci d'avance.--[[User:Popol0909|Popol0909]] 12:36, 18 February 2011 (UTC)

Documentation:VLC for dummies

2011-02-18T12:27:54Z

Popol0909: /* See also */ Ajusted link

{{Languages}}

= VLC for dummies =

== Introduction ==
Thank you for visiting this page to find out what VLC is all about. '''Please Note''': this page is ''Under Construction'' and might change in the near future.

VLC media player (or VLC for short) is a FREE and Open Source Software Media Player. Features that make VLC the preferred media player for a lot of people is its excellent support for various Audio and Video CODECs, the fact that it's cross platform and the open way of development.

This page will describe the steps to perform the basic steps of using VLC. For more Advanced Users see the [[Documentation:Play HowTo|VLC Play HowTo]] for a complete user guide, or [[Documentation:Streaming HowTo|VLC Streaming HowTo]] for the advanced streaming features that VLC is capable of.

== Understanding the VLC interface (1.0.2) ==
'''Taskbar Icon'''

When you start the VLC media player, the application appears on the screen and a small icon [[Image:Vlc-win-taskbar.png]] appears in your taskbar [Found next to your system clock on Windows]. Clicking once on the icon in the taskbar will hide the VLC media player, and clicking on it again will show it again. Hiding the icon does not close the application which continues to run in the background.

'''Note:''' These screenshots are taken from the MS Windows XP version. On other systems, they might appear slightly different.

The main interface of VLC media player looks as shown in the following figure.
[[Image:Interface.png|center|Windows 1.0.2 GUI]]

If you close the main interface by using the close button in the window, you will be able to open the VLC media player again by using the icon in the taskbar.

By simply right clicking on this icon brings up a list of things to do:

Features like ''stopping'' or ''pausing playback'' or ''change track''.

'''Starting VLC media player'''

To start VLC media player:
#Select Programs from the Start menu.
#Select VideoLAN and select VLC media player.

'''Stopping VLC media player'''

To quit the application, right click on the icon in the tray and select '''Quit'''.

Or

Click the '''Close''' button in the main interface of the application.

The main interface contains a couple of sections:

'''Menu bar'''

The menu bar at the top contains all the options.

'''Track slider'''

The track slider is below the menu bar. It shows the progress of playing of the media file. You can drag the track slider left to rewind or right to forward the track being played. When a video file is played, the video appears between the menu bar and track slider.

'''Note:''' When a media file is streamed, the track slider will not move because you are streaming at real time. Unlike a track which will end in a predetermined time.

'''Control buttons'''

The buttons below the slider help in controlling the play. Firstly, the Play Button, followed by Previous Media in the Playlist, stop playback, Next Media in the playlist.

The next 3 buttons are: Toggle the Video in fullscreen, show playlist and Show Extended Settings.

'''Volume control'''

To the right of the control buttons is the volume control. The small speaker icon is a button to quickly mute or un-mute all sound. The slider to the right of it allows you to modify the volume to louder or softer. The percentage gives the amount of amplification.

'''Data field'''

In the bottom of the window, some additional information, like track name and length of the track will be displayed for convenience.

== Playing a media file (to be written) ==
The basic steps to play media are very simple.

First, open VLC media player by double clicking the program on the desktop or from the start menu.
Next, click on the menu button on the top left of the program and choose one of the first four options,
all of the options allow you to play media files.

The first option is the simple one.

The second is the advanced one.

The third is just like the first, but with fewer options.

The fourth allows you to play media files directly from CD or DVD.

==See also==
*[[QtHotkeys]] (Qt is the default graphical interface)
*[[Hotkeys table]]
*[[How to set global hotkeys]]

User:Popol0909

2011-02-18T12:24:46Z

Popol0909:

This user can contribute in French (primary language) and English.

== Useful links ==
Administrators list/Liste des administrateurs (WikiSysop, Administrators, Bureaucrats, ...): 
[[Developers_Corner]]

Pages utiles:
[[VLC command-line help]]

QtHotkeys

2011-02-18T12:21:13Z

Popol0909: /* See also */

This page is just a reminder of what the keyboard hotkeys are in the Qt4 Interface.

;Ctrl + A : Advanced controls
;Ctrl + B : Bookmarks
;Ctrl + C : Open capture device
;Ctrl + D : Open disc
;Ctrl + E : Extended settings
;Ctrl + F : Open Folder/Directory
;Ctrl + H : hide/show menus (a.k.a Minimal view; like in Acrobat Reader)
;Ctrl + I : Media Information
;Ctrl + J : Codecs Information
;Ctrl + L : Hide/Show playlist
;Ctrl + M : Messages
;Ctrl + N : Open network stream
;Ctrl + O : Open File
;Ctrl + P : Preferences
;Ctrl + Q : Quit
;Ctrl + R : Convert/Save
;Ctrl + S : Streaming
;Ctrl + T : Goto Time
;Ctrl + U : Dock/Undock playlist
;Ctrl + V : Paste Location/Paste MRL
;Ctrl + W : VLM configurator
;Ctrl + X : Load playlist
;Ctrl + Y : Save playlist
;Ctrl + Z : Switch to skins (requires restart)
;+ : faster
;- : slower
;ESC : leave fullscreen/close dialogue
;space : play/pause
;Enter : select menu entry (dvd)
;Arrows : navigate menus (dvd)
;A : cycle aspect ratio
;B : cycle audio track
;C : cycle cropping ratio
;D : cycle deinterlace filters
;E : next frame (1.0 and over)
;F : toggle fullscreen
;G : subdelay down
;H : subdelay up
;I : interface show
;J : audiodelay down
;K : audiodelay up OR next subtitle-track (or none) (??????????????)
;L : loop
;M : mute
;N : next track
;O : original video size ( adding the black borders to the video )
;P : previous track
;R : random
;S : stop
;T : position/time
;V : subtitle track cycle
;W : wallpaper (does only work with video output DirectX)
;Z : cycle zoom
;Shift + A : cycle audio device
;Shift + B : title next
;Shift + G : history back
;Shift + H : history forward
;Shift + N : chapter next
;Shift + O : title prev
;Shift + P : chapter prev
;Shift + M : disc menu
;Shift + S : snapshot
;Alt + A : audio menu (English translation)
;Alt + C : crop / (+shift) uncrop bottom
;Alt + D : crop / (+shift) uncrop left
;Alt + F : crop / (+shift) uncrop right
;Alt + H : help menu (English translation)
;Alt + L : playback menu (English translation)
;Alt + M : media menu (English translation)
;Alt + R : crop / (+shift) uncrop top
;Alt + T : tools menu (English translation)
;Alt + V : video menu (English translation)
;Alt + Left Arrow : jump 10 sec. back
;Alt + Right Arrow : jump 10 sec. forward
;Control + Left Arrow : jump 1 minute back
;Control + Right Arrow : jump 1 minute forward
;Control + Alt + Left Arrow : jump 5 minutes back
;Control + Alt + Right Arrow : jump 5 minutes forward
;Shift + Left Arrow : jump 5 seconds back
;Shift + Right Arrow : jump 5 seconds forward

== See also ==
*[[Qt Interface]]
*[[How to set global hotkeys]]
*[[Hotkeys table]]
*[[Linux keyboard shortcuts]]

Documentation:Advanced Use of VLC

2011-02-18T12:15:12Z

Popol0909: /* Video options */ --no-video instead of --novideo since 1.1.7

{{RightMenu|documentation play howto toc}}

== Use the command line ==

'''TODO: completely outdated'''

All standard operations of VLC should be available from the GUI. However, some complex operations can only be done from the command line and there are situations in which you don't need or want a GUI. Here is the complete description of VLC's command line and how to use it.

You need to be quite comfortable with command line usage to use this.

Note: Windows users have to use the ''--option-name="value"'' syntax instead of the ''--option-name value'' syntax.

=== Getting help ===

VLC uses a modular structure. The core mainly manages communication between modules. All the multimedia processing is done by modules. There are input modules, demultiplexers, decoders, video output modules, ...

This chapter will only describe the "general" options, i.e. the core options. Each module adds new options. For example, the HTTP input module will add options for caching, proxy, authentication, ...

By using '''vlc --help''', you will get the basic core options. '''vlc --longhelp''' will give all the basic options (core + modules). Adding '''--advanced''' will give the "advanced options" (for advanced users). So '''vlc --longhelp --advanced''' will give you all options. You can also append '''--help-verbose''' if you want more detailed help.

Also, you might want to get debug informations. To do this, use '''-v''' or '''-vv''' (this will show lower severity messages). If your console supports it, you can add '''--color to get messages in color.'''

=== Opening streams ===

The following commands start VLC and start reading the given element(s):

==== Opening a file ====

Start VLC with:

% '''vlc my_file'''

VLC should be able to recognize the file type. If it does not, you can force demultiplexer and decoder (see below).

A list of all video and audio codecs supported by VLC is available on the [http://www.videolan.org/vlc/features.html VLC features list].

==== Opening a DVD or VCD, or an audio CD ====

Start VLC with:

For a DVD with menus:

% '''vlc dvd://[device][@raw_device][@[title][:[chapter][:angle]]]'''

In most cases, '''vlc dvd://''' or '''vlc dvd://[device]''' will do. [device] is for example '''/dev/dvd''' on GNU/Linux or '''D:''' on Windows (complete path to your DVD drive).

or

(DVD without menus):

% '''vlc dvdsimple://[device][@raw_device][@[title][:[chapter][:angle]]]'''

or

(VCD):

% '''vlc vcd://[device][@{E|P|E|T|S}[number]]'''

or

(Audio CD):

% '''vlc cdda://[device][@[track]]'''

==== Receiving a network stream ====

To receive an unicast RTP/UDP stream (sent by VLC's stream output), start VLC with:

% '''vlc rtp://@:5004'''

If 5004 is the port to which packets are sent. 1234 is another commonly used port number. you use the default port (1234), '''vlc rtp://''' will do. For more information, look at the Streaming Howto.

To receive an multicast UDP/RTP stream (sent by VLC's stream output), start VLC with:

% '''vlc rtp://@multicast_address:port'''

To receive a SSM (source specific multicast) stream, you can use:

% '''vlc rtp://server_address@multicast_address:port'''

This only works on OSs that support SSM (Windows XP and Linux).

To receive a HTTP stream, start VLC with:

% '''vlc http://www.example.org/your_file.mpg'''

To receive a RTSP stream, start VLC with:</para>

% '''vlc rtsp://www.example.org/your_stream'''

=== Modules selection ===

VLC always tries to select the most appropriate interface, input and output modules, among the ones available on the system, according to the stream it is given to read. However, you may wish to force the use of a specific module with the following options.

*'''--intf <module>''' allows you to select the interface module.
*'''--extraintf <module>''' allows you to select extra interface modules that will be launched in addition to the main one. This is mainly useful for special ''control'' interfaces, like HTTP, RC (Remote Control), ... (see below)
*'''--aout <module>''' allows you to select the audio output module.
*'''--vout <module>''' allows you to select the video output module.
*'''--memcpy <module>''' allows you to choose a memory copy module. You should probably never touch that.

You can get a listing of the available modules by using '''vlc -l'''

=== Stream Output ===

The Stream output system allows vlc to become a streaming server.

For more details on the stream output system, please have a look at the [[Documentation:Streaming HowTo|Streaming HowTo]].

 

=== Other Options ===

==== Audio options ====

*'''--noaudio''' disables audio output. Note that if you are streaming (ex: to a file) this has no effect (streaming copies the audio verbatim). Use --sout-xxx instead (ex: --no-sout-audio)
*'''--mono''' forces VLC to treat the stream in mono audio.
*'''--volume <integer>''' sets the level of audio output (between 0 and 1024). Also only applies to local playback (like --noaudio).
*'''--aout-rate <integer>''' sets the audio output frequency (Hz). By default, VLC will try to autodetect this.
*'''--desync <integer>''' compensates desynchronization of audio (ms). (If audio and video streams are not synchronized, use this setting to delay the audio stream)
*'''--audio-filter <string>''' adds audio filters to the processing chain. Available filters are visual (visualizer with spectrum analyzer and oscilloscope), headphone (virtual headphone patialization) and normalizer (volume normalizer)

==== Video options ====

*'''--no-video''' disables video output.
*'''--grayscale''' turns video output into grayscale mode.
*'''--fullscreen''' ( or '''-f''') sets fullscreen video.
*'''--nooverlay''' disables hardware acceleration for the video output.
*'''--width, --height <integer>''' sets the video window dimensions. By default, the video window size will be adjusted to match the video dimensions.
*'''--start-time <integer>''' starts the video here; the integer is the number of seconds from the beginning (e.g. 1:30 is written as 90)
*'''--stop-time <integer>''' stops the video here; the integer is the number of seconds from the beginning (e.g. 1:30 is written as 90)
*'''--zoom <float>''' adds a zoom factor.
*'''--aspect-ratio <mode>''' forces source aspect ratio. Modes are 4x3, 16x9, ...
*'''--spumargin <integer>''' forces SPU subtitles postion.
*'''--video-filter <string>''' adds video filters to the processing chain. You can add several filters, separated by commas
*'''--sub-filter <string>''' adds video subpictures filter to the processing chain.

==== Desktop/Screen grab options ====

You can see the various options for "grabbing the desktop" (VLC's built-in screen grabber capture device) by using the GUI. See http://forum.videolan.org/viewtopic.php?f=4&t=46971

==== Playlist options ====

*'''--random''' plays files randomly forever.
*'''--loop''' loops playlist on end.
*'''--repeat''' repeats current item until another item is forced
*'''--play-and-stop''' stops the playlist after each played item.

==== Network options ====

*'''--server-port <integer>''' sets server port.
*'''--iface <string>''' specifies the network interface to use.
*'''--iface-addr <string>''' specifies your network interface IP address.
*'''--mtu <integer>''' specifies the MTU of the network interface.
*'''--ipv6''' forces IPv6.
*'''--ipv4''' forces IPv4.

==== CPU options ====

You should probably not touch these options unless you know what you are doing.

*'''--nommx''' disables the use of MMX CPU extensions.
*'''--no3dn''' disables the use of 3D Now! CPU extensions.
*'''--nommxext''' disables the use of MMX Ext CPU extensions.
*'''--nosse''' disables the use of SSE CPU extensions.
*'''--noaltivec''' disables the use of Altivec CPU extensions.

==== Miscellaneous options ====

*'''--quiet''' deactivates all console messages.
*'''--color''' displays color messages.
*'''--search-path <string>''' specifies interface default search path.
*'''--plugin-path <string>''' specifies plugin search path.
*'''--no-plugins-cache''' disables the plugin cache (plugins cache speeds up startup)
*'''--dvd <string>''' specifies the default DVD device.
*'''--vcd <string>''' specifies the default VCD device.
*'''--program <integer>''' specifies program (SID) (for streams with several programs, like satellite ones).
*'''--audio-type <integer>''' specifies the default audio type to use with dvds.
*'''--audio-channel <integer>''' specifies the default audio channel to use with dvds.
*'''--spu-channel <integer>''' specifies the default subtitle channel to use with dvds.
*'''--version''' gives you information about the current VLC version.
*'''--module <module> ''' displays help about specified module. (Shortcut: '''-p''')

=== Item-specific options ===

There are many options that are related to items (like '''--novideo''', '''--codec''', '''--fullscreen''').

For all of these, you have the possibility to make them item-specific, using ":" instead of "--" and putting the option just after the concerned item.

Examples:

% '''vlc file1.mpg :fullscreen file2.mpg'''

will play file1.mpg in fullscreen mode and file2.mpg in the default mode (which is generally no fullscreen), whereas

% '''vlc --fullscreen file1.mpg file2.mpg'''

will play both files in fullscreen mode

% '''vlc --fullscreen file1.mpg :sub-file=file1.srt :no-fullscreen file2.mpg :filter=distort'''

will play file1.mpg in windowed (no-fullscreen) mode with the subtitles file file1.srt and will play file2.mpg with video filter distort enabled in fullscreen mode (item-specific options override global options).

== Advanced use of filters ==

=== Filters ===

These are the old style VLC filters. They only apply to on screen display and thus cannot be streamed.

==== Deinterlacing video filter ====

Module name: '''deinterlace'''

*'''--deinterlace-mode {discard,blend,mean,bob,linear}''' choose a deinterlacing mode.

==== Invert video filter ====

Module name: '''invert'''

==== Image properties filter ====

Module name: '''adjust'''

*'''--contrast <float>''' Image contrast in the 0-2 range.
*'''--brightness <float>''' Image brightness in the 0-2 range.
*'''--hue <integer>''' Image hue in the 0-360 range.
*'''--saturation <float>''' Image saturation in the 0-3 range.
*'''-gamma <float>''' Image gamma in the 0-10 range.

==== Wall video filter ====

Module name: '''wall'''

This filter splits the output in several windows.

*'''--wall-cols <integer>''' Number of columns.
*'''--wall-rows <integer>''' Number of rows.
*'''--wall-active <string>''' Select the windows you want to display. To select windows 2 and 4 you would write '''--wall-active 2,4'''. When this option isn't specified, all windows are displayed.

==== Video transformation filter ====

Module name: '''transform'''

*'''--transform-type {90,180,270,hflip,vflip}''' Select rotation angle or symmetry.

==== Distort video filter ====

Module name: '''distort'''

==== Clone video filter ====

This filter clones the output window.

Module name: '''clone'''

*'''--clone-count <integer>''' Number of clones.
*'''--clone-vout-list <string>''' Comma separated string of video output modules.

==== Crop video filter ====

Module name: '''crop'''

*'''--crop-geometry <string>''' Set the geometry of the zone to crop. This is set as <width> x <height> + <left offset> + <top offset>.
*'''--autocrop''' Enable automatic black border cropping.

==== Motion blur filter ====

Module name: '''motionblur'''

*'''blur-factor <integer>''' Blur factor in the 1-127 range.

==== Video pictures blending ====

Module name: '''blend'''

==== Video scaling filter ====

Module name: '''scale'''

 

=== Subpictures Filters ===

These are the new VLC filters. They can be streamed.

==== Time display sub filter ====

Module name: '''time'''

*'''--time-format <string>''' Time format string. You can use the following special characters %Y = year, %m = month, %d = day, %H = hour, %M = minute, %S = second.
*'''--time-x <integer>''' X offset from the left in pixels.
*'''--time-y <integer>''' Y offset from the top in pixels.

==== Marquee display sub filter ====

Module name: '''marq'''

*'''--marq-marquee <string>''' Marquee text to display.
*'''--marq-x <integer>''' X offset from the left in pixels.
*'''--marq-y <integer>''' Y offset from the top in pixels.
*'''--marq-timeout <timeout>''' Defines the time the marquee must remain displayed in milliseconds. Default value is 0 (remain forever).

==== Logo video filter ====

Module name: '''logo'''

This filter can be used both as an old style filter or a subpictures filter.

*'''--logo-file <string>''' Full path of the PNG file to use.
*'''--logo-x <integer>''' X offset from the left in pixels.
*'''--logo-y <integer>''' Y offset from the top in pixels.
*'''--logo-transparency <integer>''' You can set the logo transparency value here (from 0 for full transparency to 255 for full opacity).

Note: You can move the logo by left-clicking on it.

 

== The 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.

To start VLC with the HTTP interface, use:

% '''vlc -I http [--http-src /directory/] [--http-host host:port]'''

If you want to have both the "normal" interface and the HTTP interface, use '''vlc --extraintf http'''.

The HTTP interface will start listening at host:port (<all interfaces>:8080 if omitted), and will reproduce the structure of /directory at http://host:port/ ( vlc_source_path/share/http if omitted ).

Use a browser to go to http://your_host_machine:port. You should be taken to the main page.

VLC is shipped with a set of files that should be enough for generic needs. It is also possible to customize pages. See [[Documentation:Play HowTo/Building Pages for the HTTP Interface]].

Available pages for 1.0.3 :

*http://host:port - Main Interface
*http://host:port/vlm.html - VLM Interface
*http://host:port/mosaic.html - Mosaic Wizard
*http://host:port/flash.html - Flash based remote playback

== Other control interfaces ==

VLC includes a number of so-called interfaces that are not really interfaces, but means of controlling VLC. Nevertheless, they are enabled by setting them as interface or extra interface, either in the Preferences, in General/Interface, or using '''-I''' or '''--extraintf''' on the command line.

=== Hotkeys ===

This module allows you to control VLC and playback via hotkeys. It is always enabled by default. You can use hotkeys in the video output window, you can't in the audio dummy interface.

Hotkeys can be hacked by:

% '''vlc --key-<function> <code>'''

Code is composed by modifiers keys (Alt, Shift, Ctrl, Meta,Command) separated by a dash (-) and terminated by a key (a...z, +, =, -, ',', +, <, >, `, /, ;, ', \, [, ], *, Left, Right, Up, Down, Space, Enter, F1...F12, Home, End, Menu, Esc, Page Up, Page Down, Tab, Backspace, Mouse Wheel Up and Mouse Wheel Down). Main controls are available from hotkeys, such as : fullscreen, play-pause, faster, slower, next, prev, stop, quit, vol-up, etc. (use the '''--longhelp''' option for full list of functions). For example, for binding fullscreen to Ctrl-f, run:

% '''vlc --key-fullscreen 'Ctrl-f' '''

The list of the default hotkeys is available [[HotKeys|here]].

=== RC and RTCI ===

These two interfaces allow you to control VLC from a command shell (possibly using a remote connexion or a Unix socket).

Start VLC with '''-I rc''' or '''--extraintf rc'''. When you get the '''Remote control interface initialized, `h' for help''' message, press h and Enter to get help about available commands.

To be able to remote connect to your VLC using a TCP socket (telnet-like connexion), use '''--rc-host your_host:port'''. Then, by connecting (using telnet or netcat) to the host on the given port, you will get the command shell.

To use a UNIX socket (local socket, this does not work for Windows), use '''--rc-unix /path/to/socket'''. Commands can then be passed using this UNIX socket.

The RTCI interface gives you more advanced options, such as marquee control for the marquee subpicture filter (See filter section).

 

=== Ncurses ===

This is a text interface, using ncurses library.

Start VLC with '''-I ncurses''' or '''--extraintf ncurses'''. You will then get something like that:

http://www.videolan.org/doc/play-howto/en/images/play-howto/intf-ncurses-playlist.jpg

The ncurses interface

Press h to get the list of all available commands, with a short description.

There is also a filebrowser available for the ncurses interface in order to add playlist items. Press 'B' to use it.

http://www.videolan.org/doc/play-howto/en/images/play-howto/intf-ncurses-filebrowser.jpg

The ncurses filebrowser

You can set the filebrowser starting point by launching vlc with the '''--browse-dir''' option:

% '''vlc -I ncurses --browse-dir /filebrowser/starting/point/'''

 

=== Gestures ===

Gestures provide a simple mouse gestures control. TODO

 

== The Mozilla plugin ==

VLC can also be embedded in a web browser! The following browsers are supported [http://www.mozilla.org/ Mozilla], [http://www.mozilla.org/products/firefox/ Firefox] and [http://www.apple.com/macosx/features/safari Safari].

=== Install the plugin ===

==== GNU/Linux Debian ====

Install the ''mozilla-plugin-vlc'' package:

# '''apt-get update'''
# '''apt-get install mozilla-plugin-vlc'''

==== Windows ====

Quit Firefox or Mozilla.

Select the Mozilla Plugin option when installing VLC Media Player. The installer will then automatically detect your browser and install the plugin.

Restart Firefox or Mozilla.

==== MacOS X ====

''The Mozilla/Safari plugin for MacOS X is only available from vlc version 0.8.5.1 and onwards.''

Quit Safari browser.

Download the Mozilla/safari plugin package from [http://www.videolan.org/vlc/download-macosx.html MacOS X download page].

Run the installer from the dmg image.

 

==== Compile the sources yourself ====

Please look at the [http://developers.videolan.org developers page] for information on how to do this.

 

=== Use the mozilla 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.

See the [[Documentation:WebPlugin|documentation]] for building page for this plugin.

{{Documentation}}

= Snapshot Tool =

Did you know you can use special codes to automatically generate filenames in the [[SnapshotTool|Snaphot Tool]]?

= Specifying Streaming Options =

The dialog will show various option to set the output to stream.

First there is an input text called '''Source''', where you'll find your media path and the its type.

[[File:VlcStream.png]]

If you'll click on Destination you'll see the destination of stream that could be: ''File'', ''HTTP'', ''MS-WSMP'', ''RTSP'', ''RTP/MPG'', ''RTP, Audio/Video'', ''UDP'' and ''Icecast''.

[[File:Stream-destination.png]]

You can abilitate '''Transcoding''' to transcode your video to one in the list or in a one you can specify by clicking on the proper icon.

Last you have the option of stream you'll share.

[[File:Stream-option.png]]

By clicking stream it will return to VLC main user interface and the playbar will scroll as the video will play.

User:Popol0909

2010-10-16T17:53:58Z

Popol0909:

Administrators list/Liste des administrateurs (WikiSysop, Administrators, Bureaucrats, ...): 
[[Developers_Corner]]

Pages utiles:
[[VLC command-line help]]

Windows

2010-09-25T20:53:48Z

Popol0909: /* 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.

== 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 Up/Down 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" />
 
<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" />
 
<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: 
http://portableapps.com/apps/music_video/vlc_portable

[[Category:Operating systems]]

Git

2010-08-22T00:36:21Z

Popol0909: Added introduction for noob like me :)

[http://git-scm.com/ Git] is a free and open source [[wikipedia:Revision_control|version control system]]. It is used by programmers to keep track of the different versions of the files composing a software.

= Basic Git usage =

If you are using '''Windows''', please read the [[Git_Windows]] page.

== Getting VLC or x264 source code via Git ==

$ git clone git://git.videolan.org/vlc.git
Voilà! The full VLC history should be on your hard disk in vlc/.

$ git clone git://git.videolan.org/x264.git
Voilà! The full x264 history should be on your hard disk in x264/.

If you want only the last 3 VLC revisions:
$ git clone git://git.videolan.org/vlc.git --depth 3

Clones without the full revision set (--depth) can't be used for backporting (or make sure to that you're including at least commits up to the common fork point).

You can also clone using http with our repo.or.cz mirror.
$ git clone http://repo.or.cz/r/vlc.git

$ git log
to see the full log of the trunk.
$ gitk
to see the log graphically.

You can also browse the sources via [http://git.videolan.org/ gitweb].

== Configure your global git config ==
May need to use
$ git repo-config {various options}
1.4.4.2 Requires the repo-config command rather than just config

=== Personal Information ===
Tell git your name. (use mostly by git-commit)
$ git config --global user.name "Your Name"
$ git config --global user.email "me@example.com"

=== Using git with color (Tip) ===
If you want to use git with colored output use:
$ git config --global color.ui true

If you are using an old git version (prior to 1.5.5) and previous command didn't work, use:
$ git config --global color.diff auto
$ git config --global color.status auto
$ git config --global color.branch auto

=== Setting up "git up" (Tip) ===
If you want to be able to just keep in sync using "git up" use:
$ git config --global alias.up "pull --rebase"
And if you like your tree to be messy and don't want git to complain (like in svn) use:
$ git config --global alias.up '!sh -c "git commit -a -m "Before rebase" && git pull --rebase && git reset head^"'

=== Setting up "git wu" (Git What's Up) (Tip) ===
If you want to see what you are about to "git push":
$ git config --global alias.wu "log --stat origin..@{0}"
Now use:
$ git wu

=== Setting up "git wup" (Git What's Up - with patch) (Tip) ===
If you want to see what you are about to "git push", along with the diff:
$ git config --global alias.wup "log -p origin..@{0}"
Now use:
$ git wup

== General GIT Workflow ==
1. Make your file edits in your local repository.

2. "git commit" the changes in your local repository

3. "git pull --rebase" or "git up" (if you did ''git config --global alias.up "pull --rebase"'') to bring the rest of your local repository up to date

4. "git log origin..master" to check what you are going to commit

4. "git push" to move your changes up to the master

"git stash" if you want to "hide" your changes. Do this if you think there may be other commits against the same things you are working on and want to refresh your local checkout (using a git pull --rebase) from the master. Use "git stash apply" to get your stash back.

"git checkout -f master" if you think your tree is pretty hopeless, need a kill-and-fill to bring the master into your local repository.

== List the local branch ==
You can now list your local branch by doing
$ git branch
which should ouput
$ git branch
* master

== List your local non committed changes ==
$ git status | less

== Commit ==
Now you can start to work on your tree. As soon as you feel you have reached a step in developement where you can commit your work '''locally''', use
$ git commit -a
or
$ git commit <specific files>

If you wish to give credit to someone else's work (e.g. you are applying a third party patch):
$ git commit <specific files> --author "Name Surname <user@domain.com>"

== List your commits ==
$ git log

== Keeping your local working branch in sync ==
$ git pull --rebase

To shorten up that command type
$ git config --global alias.up "pull --rebase"

Now you can just type:
$ git up

== Use a graphical interface ==
$ gitk # Tree Browser
$ qgit # Tree Browser
$ git-gui # Commit/push/... editor

== Submitting patches to the vlc-devel or x264-devel ==

First make sure you have '''read''' our [[Sending Patches]] page. And that you've '''read''' the [[Sending Patches#Check_List| Check List]].

If you have been developing on vlc locally and (still) don't have write access, you can submit all your commits in one shot using:
$ rm -Rf patches
$ git format-patch -o patches origin
$ git send-email --to vlc-devel@videolan.org patches
If you have multiple patch consider using:
$ git send-email --compose --no-chain-reply-to --to vlc-devel@videolan.org patches
This will produce the patches for each local commit in the directory "patches" and send them.
Use --no-chain-reply-to make sure it doesn't reply.

For x264, do the same with x264-devel@videolan.org


Don't do:
* [PATCH 0/m]
** [PATCH 1/m]
*** [PATCH 2/m]
**** ...
But do:
* [PATCH 0/m]
** [PATCH 1/m]
** [PATCH 2/m]
** ..

= Advanced usage =
== Creating a secondary local branch ==
If you want to work on a specific project that could require a branch of the trunk, create a local branch of the current branch by doing:
$ git branch mywork
and to actually use it do:
$ git checkout mywork
Which could be summarized by:
$ git checkout -b mywork

Then do some commit on it... And you can go back to your original master branch by doing:
$ git checkout master

== Fetching a remote branch ==
To see the remote branch use:
$ git branch -r
If the remote branch is named 0.8.6-bugfix
$ git branch 0.8.6-bugfix origin/0.8.6-bugfix
Branch 0.8.6-bugfix set up to track remote branch refs/remotes/origin/0.8.6-bugfix.
$ git branch
0.8.6-bugfix
* master
To checkout that branch use:
$ git checkout 0.8.6-bugfix
To stay up-to-date a simple
$ git pull --rebase
Should be enough.

If warnings appear that files still need updating:
$ include/libvlc_internal.h: needs update
include/mediacontrol_internal.h: needs update
include/vlc/libvlc.h: needs update
include/vlc_update.h: needs update
modules/access/mms/mms.c: needs update
...

Then do a checkout -f to revert non committed local changes
$ git checkout -f

To stay up-to-date another
$ git pull --rebase
Should give no more warnings.

To push to the remote branch, use:
$git push origin 0.8.6-bugfix:0.8.6-bugfix

== Creating a remote branch ==
If the new remote branch is named 0.9.0-bugfix, and is based on the local master branch.
First make sure everything go as planned with the --dry-run option:
$ git push --dry-run origin master:refs/heads/0.9.0-stable
To git@git.videolan.org:vlc.git
* [new branch] master -> 0.9.0-stable

Then push it:
$ git push origin master:refs/heads/0.9.0-stable
To git@git.videolan.org:vlc.git
* [new branch] master -> 0.9.0-stable
$ git branch -r
origin/0.9.0-stable
origin/master

To checkout that branch now see ''Fetching a remote branch''

== Backporting commits ==
It is possible to "backport" commit between the master branch and a -bugfix branch. However since VDD'09, the bugfix branches have been splitted to their own git repositories. This leaves us with 2 cases.

=== Normal simple case ===

Go to your -bugfix branch:
$ git checkout 1.0-bugfix

Backport the commit:
$ git cherry-pick -x -s <sha-id of commit>

If git fails to do the backport by itself, you'll be presnted with the usual options in case of a failed merge or patching. Use "git status", your favorite editor or "git mergetool" to resolve the situation. Then use "git add" and "git commit -c <sha-id of backported commit>".
Then push your commit as usual.

=== Case of VLC bugfix branches ===
Due to the number of commits in vlc.git and the amount of divergence between the master and 1.0-bugfix branches, they have been separated into two different git repositories. But that doesn't block you from backporting.

Get the -bugfix git:
$ git clone git://git.videolan.org/vlc/vlc-1.0.git vlc-bugfix
Add vlc.git as an additional remote:
$ git remote add vlc-master git://git.videolan.org/vlc.git
Update the information from vlc-master
$ git fetch vlc-master
Backport as normal
$ git cherry-pick -x -s <sha-id of commit>

== Publishing your own fork ==
Goto [http://repo.or.cz/w/vlc.git http://repo.or.cz/w/vlc.git] and click [http://repo.or.cz/m/regproj.cgi?name=vlc/ fork]. You will be able to publish your work there.

Please don't forget to send a mail to the vlc-devel as soon as you create your fork.

== Revert your non-committed local changes ==
$ git checkout -f

==Edit or undo not yet pushed commits ==
This will undo the last commit
$ git reset HEAD^
which is the same as
$ git reset master^
(if your checked-out copy of your tree is master)
And also the same as
$ git reset a44a594 # note that there is no need to use the full sha id

If you have a stack of patch that you have not yet committed you can delete one patch from the list using git rebase --interactive
$ git rebase --interactive origin
pick eacf185 test
pick 56322eb VLMA owner is vlma prod.

# Rebase 826757e..56322eb onto 826757e
#
# Commands:
# pick = use commit
# edit = use commit, but stop for amending
# squash = use commit, but meld into previous commit

== Diff-ing ==
* You can diff between two branches using
$ git diff branch1 branch2
* You can diff between the previous 10th commit and current using
$ git diff HEAD~10 HEAD
* You can diff between the previous 10th commit and current of the branch "mywork" using
$ git diff mywork~10 mywork
* Imagine that git log is like
$ git log
commit e0394f269305edd09843257e7c1d1a66aaf48ab3
Author: jb <jb>
Date: Fri Apr 13 07:14:48 2007 +0000
qt4 - Mousewheel (2)
commit e80b339081aa6755f67c9bd8e2aacf93a9a79d95
[..]
commit ff7004b70fd239e4120deb160e2991bd5237b8df
[..]
commit a44a594898f981a145cfcace5f16f8973f9eb46f
[..]
commit 690df705c963cf6bf6f5746d54bc97a85ff91919
[..]
commit 679f8b1c3e0baa469efa970588b95a625c595d64
[..]

$ git diff a44a594898f981a145cfcace5f16f8973f9eb46f~2 e80b339081aa6755f67c9bd8e2aacf93a9a79d95
Will be equivalent to:
$ git diff ff7004b70fd239e4120deb160e2991bd5237b8df e80b339081aa6755f67c9bd8e2aacf93a9a79d95
And to:
$ git diff HEAD~4 HEAD^

* Remember that to produce a patch you should rather use git-format-patch than git-diff most of the time.

== Patch-ing ==
* You can apply patches using
$ git apply <patch>

== Tracking regression ==
git has a great tool called [http://www.kernel.org/pub/software/scm/git/docs/git-bisect.html git-bisect] to help you to track a faulty commit. Imagine you are tracking a bug that is known to appear after 0.8.6 (assuming 0.8.6 is tagged):
$ git bisect start
$ git bisect bad # tell git current version has the bug you are tracking
$ git bisect good 0.8.6 # tell git 0.8.6 didn't have the bug
And then git will checkout a certain revision, and ask you to test it. And you simply say whether this version has the bug.
If it has the bug:
$ git bisect bad
if the bug is not present:
$ git bisect good
And so on by bisection... At the end git will indicate the faulty commit. Most of the time this tool is really efficient to track regression.

If you can provide a script that test the presence of the bug
$ git bisect run <script_name>
will be able to track down the regression by itself. See [http://www.kernel.org/pub/software/scm/git/docs/git-bisect.html git-bisect Documentation].

= Using Git to push to VideoLAN git =
== Initial requirements ==
* You must have credentials to push commits into the repository. For other contributors, please read upper [[Git#Submitting_patches_to_the_vlc-devel_or_x264-devel|Submitting patches to the vlc-devel or x264-devel]] paragraph.
* Make sure you've set your name and email in your commits
$ git config --global user.name "Your Name"
$ git config --global user.email "me@example.com"

== Convert your tree to use your ssh push commit access ==
$ vi vlc/.git/config
And replace
git://git.videolan.org/vlc.git
With
git@git.videolan.org:vlc.git

== Staying up to date ==
$ git pull --rebase

If you don't want to have to type --rebase everytime you pull do:
$ git config branch.master.rebase true

This one creates a merge object which is not how SVN worked, so let's use the first version...
$ git pull

== Pushing your work ==
$ git log origin..master # Check what you are going to push
$ git push



= Documentation about git =
* [http://git.or.cz/ Official Git Website]
* [http://www.kernel.org/pub/software/scm/git/docs/tutorial.html Git Tutorial]
* [http://git.or.cz/course/svn.html Switching from SVN to git using cogito]
* [http://wiki.sourcemage.org/Git_Guide Very good Git guide]

[[Category:Building]]

VideoLAN Wiki talk:Rules

2010-08-22T00:11:20Z

Popol0909: /* WikiMedia is not MediaWiki */ new section

Hurrah, at last some proper rules! It's pretty obvious stuff, but it's better to have rules we can point to and follow. Also added reditect for [[rules]] for ease of use.

The only one I don't quite get is ''Don't say anything you can't say on TV'' as that can be different in different countries. Perhaps it can have a bit of clarification: is it a ban on libel/slander (it'd be a good idea to warn against that), a ban on swearing (I don't think that'd be necesary, as if it's for causing offense it's covered by other rules, and if it's random it's covered by nonsense), or something else? --[[User:H2g2bob|H2g2bob]] 20:46, 27 June 2006 (CEST)

== WikiMedia is not MediaWiki ==

The sentence:
:''Check the general WikiMedia Syntax that you can use on this wiki''
should read
:''Check the general '''MediaWiki''' Syntax that you can use on this wiki''.
--[[User:Popol0909|Popol0909]] 00:11, 22 August 2010 (UTC)

VideoLAN Wiki:Syntax

2010-08-22T00:08:01Z

Popol0909: /* Templates */ Added link to all templates

Please follow these guidelines when editing this wiki.
There will be more guidelines later.

== Templates ==

See the [[List of templates|Documented List of Templates]]. 
See all templates: http://wiki.videolan.org/index.php?title=Special%3AAllPages&from=&to=&namespace=10.

Documentation:Play HowTo/Basic Use

2010-08-22T00:04:00Z

Popol0909: /* Hotkeys */ Added See also section

{{RightMenu|documentation play howto toc 0.9}}

'''Note: this documentation is for versions 0.9 and newer and is under construction. For simple help with 0.9 see [[Documentation:VLC for dummies| VLC for dummies: an introduction to VLC]]. For older versions please see and [[Documentation:Play_HowTo/Basic_Use|Basic Use]].'''

==About VLC media player==
VLC media player is a highly portable multimedia player for various audio and video formats such as MPEG-1, MPEG-2, MPEG-4, DivX, mp3 and ogg. It also plays DVDs, VCDs, and various streaming networks. In addition to playing audio and video files, VLC media player provides additional formats which can be played and customized.

VLC media player was initially known as VideoLAN Client. However, in recent years, the software has also become an extremely powerful server to stream live and on-demand video in several formats to the intranet network and the Internet.

It started as a student project at the French École Centrale, Paris, but is now a worldwide project with developers from more than 20 countries.

VLC is built in a modular way. This means that you can choose from a range of different modules to decide how to control VLC and how to display the video output.

Note: The screenshots are taken from the MS Windows XP version. On other operating systems they might appear slightly different.

==Understanding the VLC interface==

VLC has several interfaces:
*A cross-platform interface, for Windows and GNU/Linux, called wxWidgets,
*A native Mac OS X interface, and
*A skinnable interface for Windows and GNU/Linux.
Screenshots below are drawn from the various interfaces, but VLC's functions work essentially the same on all operating systems.

===Windows and GNU/Linux (Qt)===

The main interface of VLC media player looks as shown in the following figure. This is the default interface on Windows and GNU/Linux (the screenshot is done on Windows, but it would look quite the same on GNU/Linux).

[[Image:VLC_MainInterface.JPG]]

===Starting VLC Media Player===
To start VLC Media Player
<ol>
<li>Select '''Programs''' from the '''Start''' menu.</li>
<li>Select '''VideoLAN''' and select the '''VLC media player'''.</li>
</ol>
When you start VLC media player, the application appears on the screen and a small icon [[Image:VLCIcon.jpg]] appears in the taskbar.
Click on the icon in the taskbar to show or hide the icon in the taskbar. Hiding the icon does not amount to quitting the application. It does run in the background even when you hide the interface.

===Stopping VLC Media Player===
To quit the application, right click on the [[Image:VLCIcon.jpg]] icon in the tray and select '''Quit'''. 
Or 
Click the '''Close''' button in the main interface of the application.

===Taskbar Icon===
When VLC media player is running, its icon [[Image:VLCIcon.jpg]] appears in the taskbar.
Click on the icon in the taskbar to show or hide the icon in the taskbar. Hiding the icon does not amount to quitting the application. It does run in the background even when you hide the icon.
Basic operations such as opening, playing or stopping a media file, or changing a track can be done from the menu obtained by right clicking the taskbar icon.
The main interface contains a couple of sections:

====Main Interface====
'''Menu bar''' 
The menu bar at the top contains all the options. 
'''Track slider''' 
The track slider is below the menu bar. It shows the progress of playing the media file. You can drag the track slider left to rewind or right to forward the track being played. When a video file is played, the video appears between the menu bar and track slider. 
Note: When a media file is streamed, the track slider does not move because VLC cannot know the total duration. 

'''Control Buttons''' 
The buttons below the slider help in controlling the play. 
<table border="1" width="60%">
<tr>
<td width="10%" bgcolor="#F5F5F5">Button</td>
<td width="50%" bgcolor="#F5F5F5">Description</td>
</tr>

<tr>
<td width="10%">[[Image:toggleplaypause.JPG]]</td>
<td width="50%">Toggles between play and pause</td>
</tr>

<tr>
<td width="10%">[[Image:prevtrack.JPG]]</td>
<td width="50%">Moves to the previous track</td>
</tr>

<tr>
<td width="10%">[[Image:stopplay.JPG]]</td>
<td width="50%">Stops the play</td>
</tr>

<tr>
<td width="10%">[[Image:nexttrack.JPG]]</td>
<td width="50%">Moves to the next track</td>
</tr>

<tr>
<td width="10%">[[Image:fullscreen mode.JPG]]</td>
<td width="50%">Displays the application in a full-screen mode</td>
</tr>

<tr>
<td width="10%">[[Image:displayplaylist.JPG]]</td>
<td width="50%">Displays the play list</td>
</tr>

<tr>
<td width="10%">[[Image:audvidsettings.JPG]]</td>
<td width="50%">Displays a menu of options to have audio and video effects, and synchronising the audio and video media. </td>
</tr>

<tr>
<td width="10%">[[Image:mutevoice.JPG]]</td>
<td width="50%">Toggles between mute and voice. Click on it to mute or un-mute. </td>
</tr>

<tr>
<td width="10%">[[Image:volumeslider.JPG]]</td>
<td width="50%">Volume slider. Displays the volume level. You can adjust the volume by placing the cursor on this icon and moving it left or right. The number indicates the percentage of amplification. Maximum is 200%. </td>
</tr>

</table>

====Additional Information====
At the bottom of the interface we can find information regarding name of the media file being played, the relative speed at which it is being played, and the elapsed and total duration of the file are displayed. There is an option to increase or decrease the speed of the track.

Right click on the [[Image:speed.JPG]] icon to change the playing speed of the track.

<table width="60%" border="1">
<tr>
<td width="10%" bgcolor="#F5F5F5">Menu</td>
<td width="10%" bgcolor="#F5F5F5">Option</td>
<td width="40%" bgcolor="#F5F5F5">Description</td>
</tr>

<tr>
<td width="10%">Media</td>
<td width="10%">Open File</td>
<td width="40%">Select this option to open a media file and play it.</td>
</tr>

<tr>
<td width="10%"> </td>
<td width="10%">Advanced Open File</td>
<td width="40%">Select this option to open files through a folder, disc, network or a capture device.</td>
</tr>

<tr>
<td width="10%"> </td>
<td width="10%">Open Folder</td>
<td width="40%">Select this option to open a folder with multiple media files and play them in order.</td>
</tr>

<tr>
<td width="10%"> </td>
<td width="10%">Open Disc</td>
<td width="40%">Select this option to open discs with different video format.</td>
</tr>

<tr>
<td width="10%"> </td>
<td width="10%">Open Network</td>
<td width="40%">Select this option to receive media files from Internet and play them.</td>
</tr>

<tr>
<td width="10%"> </td>
<td width="10%">Open Capture Device</td>
<td width="40%">Select this option to receive media files from capture devices such as camcorder, webcam and so on.</td>
</tr>

<tr>
<td width="10%"> </td>
<td width="10%">Convert/Save</td>
<td width="40%">Select this option to convert media files to different media file formats.</td>
</tr>

<tr>
<td width="10%"> </td>
<td width="10%">Streaming</td>
<td width="40%">Select this option to send media files through network and play them live.</td>
</tr>

<tr>
<td width="10%"> </td>
<td width="10%">Quit</td>
<td width="40%">Select this option to quit the application.</td>
</tr>

<tr>
<td width="10%">Audio</td>
<td width="10%">Audio Track</td>
<td width="40%">Select this option to disable or enable an audio track.</td>
</tr>

<tr>
<td width="10%"> </td>
<td width="10%">Audio Device</td>
<td width="40%">Select this option to convert the stereo audio files to mono and vice-versa.</td>
</tr>

<tr>
<td width="10%"> </td>
<td width="10%">Audio Channel</td>
<td width="40%">Select this option to select a audio channel.</td>
</tr>

<tr>
<td width="10%"> </td>
<td width="10%">Visualization</td>
<td width="40%">Select this option to display splashes of colour and geometric shapes while listening to an audio file.</td>
</tr>

<tr>
<td width="10%">Video</td>
<td width="10%">Video Track</td>
<td width="40%">Select this option to disable or enable a video track.</td>
</tr>

<tr>
<td width="10%"> </td>
<td width="10%">Subtitles</td>
<td width="40%">Select this option to load subtitle files for video files requiring subtitles.</td>
</tr>

<tr>
<td width="10%"> </td>
<td width="10%">Full Screen</td>
<td width="40%">Select this option to view the media file in the entire screen.</td>
</tr>

<tr>
<td width="10%"> </td>
<td width="10%">Zoom</td>
<td width="40%">Select this option to zoom in or zoom out a video track.</td>
</tr>

<tr>
<td width="10%"> </td>
<td width="10%">Deinterlace</td>
<td width="40%">Select this option to convert interlaced video signals into non-interlaced form.</td>
</tr>

<tr>
<td width="10%"> </td>
<td width="10%">Aspect Ratio</td>
<td width="40%">Select this option to adjust the width to height ratio of the video.</td>
</tr>

<tr>
<td width="10%"> </td>
<td width="10%">Crop</td>
<td width="40%">Select this option to crop the edges of a video track.</td>
</tr>

<tr>
<td width="10%"> </td>
<td width="10%">Always on Top</td>
<td width="40%">Select this option to display the application always on top when other applications or files are open.</td>
</tr>

<tr>
<td width="10%"> </td>
<td width="10%">Direct X wall paper</td>
<td width="40%">Select this option to make the video which is being displayed to become the wall paper.</td>
</tr>

<tr>
<td width="10%"> </td>
<td width="10%">Snapshot</td>
<td width="40%">Select this option to capture snapshots of video being displayed.</td>
</tr>

<tr>
<td width="10%">Playback</td>
<td width="10%">Go to specific time</td>
<td width="40%">Select this option to move the track slider to a specific frame of the video or audio file. The media file starts playing from that instance.</td>
</tr>

<tr>
<td width="10%"> </td>
<td width="10%">Bookmarks</td>
<td width="40%">Select this option to bookmark the media file.</td>
</tr>

<tr>
<td width="10%"> </td>
<td width="10%">Title</td>
<td width="40%">Select this option to randomly access a particular movie in a DVD.</td>
</tr>

<tr>
<td width="10%"> </td>
<td width="10%">Chapter</td>
<td width="40%">Select this option to randomly access a particular chapter in a movie.</td>
</tr>

<tr>
<td width="10%"> </td>
<td width="10%">Program</td>
<td width="40%">To be added</td>
</tr>

<tr>
<td width="10%"> </td>
<td width="10%">Navigation</td>
<td width="40%">Select this option to navigate to different titles and their corresponding chapters.</td>
</tr>

<tr>
<td width="10%">Playlist</td>
<td width="10%">Additional Sources</td>
<td width="40%">Select this option to access the additional sources such as podcasts, SAP announcements, radio and TV shoutcasts, French TV and Freebox TV.</td>
</tr>

<tr>
<td width="10%"> </td>
<td width="10%">Show Playlist</td>
<td width="40%">Select this option to view and play the media files listed in the playlist.</td>
</tr>

<tr>
<td width="10%"> </td>
<td width="10%">Load Playlist File</td>
<td width="40%">Select this option to load the playlist files.</td>
</tr>

<tr>
<td width="10%"> </td>
<td width="10%">Save Playlist to File</td>
<td width="40%">Select this option to save the current playing media in the preferred format.</td>
</tr>

<tr>
<td width="10%"> </td>
<td width="10%">Save Playlist to File</td>
<td width="40%">Select this option to save the current playing media in the preferred format.</td>
</tr>

<tr>
<td width="10%">Tools</td>
<td width="10%">Playlist</td>
<td width="40%">Select this option to view and play the media files listed in the playlist.</td>
</tr>

<tr>
<td width="10%"> </td>
<td width="10%">Extended Settings</td>
<td width="40%">Select this option to adjust the audio and video effects.</td>
</tr>

<tr>
<td width="10%"> </td>
<td width="10%">Add Interface</td>
<td width="40%">Select this option to view VLC media player using different interfaces.</td>
</tr>

<tr>
<td width="10%"> </td>
<td width="10%">Minimal view</td>
<td width="40%">Select this option to have a minimal view of the application.</td>
</tr>

<tr>
<td width="10%"> </td>
<td width="10%">Fullscreen Interface</td>
<td width="40%">Select this option to have a full screen view of the application.</td>
</tr>

<tr>
<td width="10%"> </td>
<td width="10%">Advanced controls</td>
<td width="40%">Select this option to access snapshot and loop controls.</td>
</tr>

<tr>
<td width="10%"> </td>
<td width="10%">Messages</td>
<td width="40%">To be added</td>
</tr>

<tr>
<td width="10%"> </td>
<td width="10%">Media Information</td>
<td width="40%">Select this option to view information regarding the media file being played.</td>
</tr>

<tr>
<td width="10%"> </td>
<td width="10%">Codec Information</td>
<td width="40%">Select this option to view codec information of the media file being played.</td>
</tr>

<tr>
<td width="10%"> </td>
<td width="10%">Bookmarks</td>
<td width="40%">Select this option to bookmark the media file.</td>
</tr>

<tr>
<td width="10%"> </td>
<td width="10%">VLM Configuration</td>
<td width="40%">To be added</td>
</tr>

<tr>
<td width="10%"> </td>
<td width="10%">Preferences</td>
<td width="40%">Select this option to give preferred settings to audio, video, subtitles, codecs and hotkeys.</td>
</tr>
</table>

===Opening a File===
The '''Media''' menu can be used to open a file. VLC offers a range of options to open media files. See the table below to see the available options. When you open a file, the file is played according to the default play options.

<table width="60%" border="1px">
<tr>
<td width="10%" bgcolor="#F5F5F5">Option</td>
<td width="10%" bgcolor="#F5F5F5">Shortcut Key</td>
<td width="40%" bgcolor="#F5F5F5">Description</td>
</tr>

<tr>
<td width="10%">Open File</td>
<td width="10%">Ctrl+O</td>
<td width="40%">Use this option to play a single media file from a specified location on the hard disk.</td>
</tr>

<tr>
<td width="10%">Advanced Open File</td>
<td width="10%"> </td>
<td width="40%">In addition to opening a file from a hard disk, you can open files from a disc, from any computer on the network or directly from a capturing device.
You can also open a subtitles file associated with the selected media file. 
You can also set a few playing options. Refer to [[#Advanced_File_Open|Advanced File Open]].</td>
</tr>

<tr>
<td width="10%">Open Folder</td>
<td width="10%">Ctrl+F</td>
<td width="40%">Use this option to play all the files in a certain folder.</td>
</tr>

<tr>
<td width="10%">Open Disc</td>
<td width="10%">Ctrl+D</td>
<td width="40%">Use this option to play files from a disc. Based on the type of disc you select, you can have a few more playing options. Refer to [[#Opening_a_Disc|Opening a file from a disc]].</td>
</tr>

<tr>
<td width="10%">Open Network</td>
<td width="10%">Ctrl+N</td>
<td width="40%">Use this option to open a file present on any system on the network to which you are currently connected.
You can also set a few playing options. Refer to [[#Opening_a_Network|Opening a file on the network]]</td>
</tr>

<tr>
<td width="10%">Open Capture Device</td>
<td width="10%">Ctrl+C</td>
<td width="40%">Use this option to open a file directly from a capturing device which is currently connected to your system.
You can also set a few playing options. Refer to [[#Opening_a_Capture_Device|Opening a file from the capturing device]].</td>
</tr>

<tr>
<td width="10%">Convert / Save</td>
<td width="10%">Ctrl+R</td>
<td width="40%">Use this option to convert a media file from one format to another. 
Refer to [[#Converting_and_Saving_a_Media_File_Format|Converting a media file into another format]].</td>
</tr>

<tr>
<td width="10%">Streaming</td>
<td width="10%">Ctrl+S</td>
<td width="40%">Use this option to stream a recorded media file. 
Refer to [[#Streaming_Media_Files|Streaming a media file]].</td>
</tr>

</table>
[[Image:Media menu.JPG]]

You can open audio or video files. A file can be opened in two ways.
<ol>
<li>From the '''Media''' menu select the '''Open File''' option or the '''Advanced Open File''' option. </li>
<li>Select the '''File''' tab in the Open dialog box. </li>
<li>Enter file name in the '''File names''' box or browse and select a file.</li>
<li>Select a format from the '''Filter''' list. The supported formats are .a52, .aac, .ac3, .dts, .p3, .ogg, .oma, .spx, .wav, .wma and .wm.</li>
<li>Check the '''Use a subtitle file''' option to select a subtitles file to be viewed with the media file. 
From the '''Alignment''' list, select an option to align selected subtitle. The available options are Left, Right and Center. 
From the '''Size''' list, select a font size for the selected subtitle. The available options are Small, Smaller, Normal, Large and Larger. </li>
<li>Click '''Open'''. VLC starts playing the selected file with the default options.</li>
</ol>

===Advanced File Open===
To open a file 
<ol>
<li>Select the '''Advanced Open File''' option from the '''Media''' menu. </li>
<li>The Open file dialog box is displayed. There are four tabs such as '''File''', '''Disc''', '''Network''' and '''Capture Device'''.</li>
</ol>

Refer to the following sections for more details:

[[##Advanced_File_Open|Opening a media file with advanced options]] 
[[#Opening_a_Folder|Opening a folder]] 
[[#Opening_a_Disc|Opening a media disc]] 
[[#Opening_a_Network|Opening a media network]] 
[[#Opening_a_Capture_Device|Opening a capture device]]

===Additional Playing Options===
When you select the '''File''' tab after selecting the '''Advanced Open File''' menu, apart from selecting a file you have the following choices:

'''Caching:''' When you specify caching value for a media file, the stream is still rendered by VLC media player at the specified data rate, but the client system buffers a much larger portion of the content before rendering it. This allows the client to handle variable network conditions without a perceptible impact on the playback quality of either on-demand or broadcast content. Specify a caching value so that the file is played smoother. The default value is 300 milliseconds.

'''Customizing:''' File names from different locations can be added directly into the '''Customize''' box without having to browse the folders.

'''Synchronous play:''' Play another file in synch with the selected file.

'''Start time:''' Not play the file from the beginning. If start time is specified as 120 seconds, the file is played after skipping the content of the first two minutes. (Specify time in seconds; not minutes)

===Opening a Folder===
You can select a folder to play all media files one after the other in that folder.
<ol>
<li>Select the '''Open Folder''' option. The Browse for Folders dialog box is displayed.</li>
<li>Browse and select the folder.</li>
<li>Click on '''OK'''.</li>
</ol>
All the files present in the selected folder are played in the alphabetical order, one after another, without expecting any action from you.

===Opening a Disc===
You can open media files from a disc. In VLC, you can play Audio CDs, SVCD/VCDs, and DVDs.
You can open a file from a disc in two ways.
<ol>
<li>Select the '''Open Disc''' option from the '''Media''' menu. 
Or 
Select the '''Advanced Open File''' option from the '''Media''' menu. </li>
The Open dialog box is displayed.
<li>Select the '''Disc''' tab.</li>
<li>Check the type of disc connected to the system. The options are '''Audio CD''', '''DVD''', and '''SVCD/VCD'''.</li>
<li>In the '''Disc Device''' box, by default, the path for the disc is displayed. You may select a different path using the '''Browse''' button. 
Click on the Eject [[Image:Eject.JPG]] button. The disk drive opens automatically and you can check if the drive is empty or if the correct disc is in the drive.</li>
<li>Based on the selected disc type, specify the following options:</li>
<ul><li>DVD</li>
<ul>
<li>Some original DVDs may have complex, proprietary menu options and VLC may not handle all the options well. If you check the '''No DVD menus''' option, VLC reads the raw video files directly into the film regardless of the options present while creating the original DVD. Check this option if you want to listen to or view the basic version without availing the menus present in the DVD.</li>
<li>When a DVD is played, the entire disc need not be played. To specify the part to be played, specify the '''Title''' and '''Chapter number''' in the '''Starting Position''' box. </li>
<li>Under the Audio and Subtitles group, select the '''Subtitles track''' and '''Audio track'''.</li>
</ul>
<li>Audio CD</li>
In the '''Track''' box of the '''Starting Position''' group, select the track number at which the play should start.
<li>SVCD/VCD</li>
In the '''Starting Position''' group, specify the '''Entry''' number at which the play should start.
Under the '''Audio and Subtitles''' group, select the '''Subtitles track''' and '''Audio track'''.
</ul>
<li>Check '''Show more options''' to see more play options. Refer to [[#Additional_Playing_Options|Additional playing options]].</li>
</ol>
====Playing more than one media file====
VLC has an option to play two media files synchronously.
<ol>
<li>From the '''Media''' menu, select the '''Advanced Open File''' option. </li>
The Open dialog box is displayed.
<li>Select a media file.</li>
<li>Check the '''Show more options''' option. The screen expands to show more options.</li>
<li>Check the '''Play another media synchronously''' option. The '''Extra media''' box and a '''Browse''' button are displayed.</li>
<li>In the '''Extra media''' box, enter the name of another media file with complete path or use the '''Browse''' button to select the media file. </li>
<li>You can change the '''Caching''' value for the media file being played.</li>
<li>Select the time at which the media file should start from the '''Start Time''' list.</li>
<li>You can see the selection you made in the '''Customize''' box.</li>
<li>Click on the '''Play''' button. </li>
</ol>
You can use the '''Show more options''' to watch a video while listening to an audio file or listen to two audio files played synchronously (one audio track can have the instrumental part and the other can have the corresponding voice).

===Opening a Network===
You can open a network and stream media from the selected network to the specified hosts. When you open a network you specify the network to be used for streaming media content.

<ol>
<li>From the '''Media''' menu select '''Open Network''' or '''Advanced Open File''' option and then select the '''Network''' tab. </li>
The Open dialog box is displayed.
<li>Select a protocol from the '''Protocol''' list. </li>
The supported protocols are HTTP, HTTPS, FTP, MMS, RTSP, RTP, UDP and RTMP.
MMS, RTP, RTMP, RTSP and UDP protocols are suitable for streaming media. The RTP, RTMP and RTSP protocols are for real transmission.
<li>Select a protocol suitable to your content. </li>
<li>In the '''Address''' box, enter the address of the system from which the media is going to be streamed. </li>
<li>In the '''Port''' box, enter the port number from which streaming is done. </li>
The default number is 1234.
<li>When UDP is selected, the '''Allow Timeshifting''' option is enabled.</li>

Timeshifting refers to the recording of programmes in a storage medium which is to be viewed or listened to at a time more convenient. Typically, this refers to TV programming but can also refer to radio shows through podcasts.

When the network stream is played, the stream can be paused even if it is a live stream

<li>Enter a URL in the '''Address''' box. </li>

Note: The '''Port''' list is enabled only when RTP or UDP is selected.

<li>Click on the [[Image:submenu.JPG]] before the '''Play''' button and select '''Stream''' from the popup menu.</li>

<li>In the Stream Output dialog box, specify the media file to be streamed and the address to which the streaming should be done. 
In the Stream Output dialog, you can specify further options. Refer to [[#Specifying_Streaming_Options|Specifying the Streaming Options]].</li>

<li>Click on the '''Stream''' button.</li>

Note: When the streaming is being done, the slider moves to show the progress.
====Specifying Streaming Options====
VLC provides several options for streaming media files. You can stream media files in two ways.
<ol>
<li>Select '''Streaming''' from the '''Media''' menu. </li> 
Or 
Select '''Advanced Open File''' from the '''Media''' menu. The Open dialog box is displayed. </li>
<li>Click on the [[Image:submenu.JPG]] icon next to the '''Play''' button and select '''Stream''' from the popup menu. </li>
The Stream Output dialog box is displayed.
</ol>
Specify Outputs

<ol>
<li>Check the '''Play locally''' option to play the file while it is being streamed.</li>
<li>Check the '''File''' option to specify a path to save the converted file or click on the '''Browse''' button. The Save File dialog box is displayed. Select a container format from the '''Save As Type''' list.</li>

A container is a file that can contain audio and video. You can also browse a folder to save the converted file. The audio and video is encoded using codecs and then stored in a container. A file’s extension can be used to identify the container format. VLC provides the following container formats:

<table width="80%" border="1">
<tr>
<td width="5%" bgcolor="#F5F5F5">Format</td>
<td width="75%" bgcolor="#F5F5F5">Description</td>
</tr>

<tr>
<td width="5%">.ps</td>
<td width="75%">Refers to MPEG program stream. Stores M-PEG 2 video muxed with other streams.</td>
</tr>

<tr>
<td width="5%">.ts</td>
<td width="75%">Refers to MPEG transport stream. Used for streaming video through a network or by a satellite.</td>
</tr>

<tr>
<td width="5%">.mpg</td>
<td width="75%">Refers to a family of standards used for coding audio and visual information.</td>
</tr>

<tr>
<td width="5%">.ogg</td>
<td width="75%">Refers to professional grade media product. Ogg Vorbis encodes audio and Ogg Theora encodes video.</td>
</tr>

<tr>
<td width="5%">.asf</td>
<td width="75%">Stores Windows Media Audio and Windows Media Video. ASF is designed to be used over audio and video information and is specially designed to run over networks.</td>
</tr>

<tr>
<td width="5%">.mp4</td>
<td width="75%">M-PEG 4 audio and video. Provides compression for web, voice and broadcast television applications.</td>
</tr>

<tr>
<td width="5%">.mov</td>
<td width="75%">Refers to the QuickTime media format. Used to store audio and video.</td>
</tr>
</table>

<li>Select a file or enter the file name in the '''File''' name box. </li>
<li>Click on '''Save''' to save the media file in the selected container format.</li>
<li>Check the '''Dump Raw Output''' box to save the input stream as it is read by VLC, without any processing. If this option is selected, all other options are disabled. </li>
<li>Select HTTP to stream media files using the HTTP streaming method. Specify the '''Address''' and '''Port'''.</li>
<li>Select the '''MMSH''' access method to stream media files to the Microsoft Windows Media Player. The '''Address''' and '''Port''' options are enabled. Specify the '''Address''' and '''Port'''. 
MMS is a proprietary digital media streaming protocol developed by Microsoft. MMSH is MMS over HTTP.</li>

<li>Select '''RTP''' to stream the media using the RTP method. The Prefer UDP over RTP, Address, Port, Audio Port and Video Port options are enabled. 
RTP refers to the Real-Time Transfer Protocol. Like UDP, RTP can use both unicast and multicast addresses. RTP or UDP is extensively used for streaming live audio and video.</li>
<li>Specify the '''Address''', '''Port''', '''Audio Port''' and '''Video Port'''. </li>
<li>Select the '''Prefer UDP over RTP''' option. </li>
VLC automatically tries to stream the media using the UDP protocol. If the streaming fails, VLC uses the IP address specified for the RTP protocol. This option can be used when no intervention is required from the consumer. The '''Audio Port''' and '''Video Port''' options get disabled if the Prefer UDP over RTP option is selected.

<li>Select '''IceCast''' to distribute live audio and video over the Internet in real time. 
<ul>
<li>Enter the '''Address''' and '''Port''' details. </li>
<li>Enter the login name and password in the '''Login:pass:''' box.</li>
<li>Enter the name of the '''Mount Point''' where the current listener should be redirected to.</li>
</ul>
An IceCast mount point refers to a connector between an IceCast source stream and IceCast listeners.</li>
<li>Select a profile from the '''Profile''' list. The available profiles are Custom, Ogg/Vorbis, MPEG-2, MP3, MPEG-4 audio AAC, MPEG-4/DivX, H264, IPod (MP4, aac), Xbox, Windows (wmv/asf), and PSP. </li>
<li>Choose the encoder format from the '''Profiles''' or customise it. </li>
<li>Customise the other options by selecting the Encapsulation, Video codec, Audio codec and Subtitles tabs. </li>
Note: The options under Encapsulation, Video codec, Audio codec and Subtitles tabs are enabled only if you select the '''Custom''' option.

Encapsulation 

Refers to the format in which a stream is encapsulated. The available formats are MPEG-TS, MPEG-PS, MPEG 1, Ogg/Ogm, ASF/WMV, MP4, MOV, WAV, RAW, FLV and MKV.
From the '''Encapsulation''' tab, select an encapsulation method that fits the codecs and access method of your stream.

Video Codec

The '''Video''' option is selected by default. The options related to codec, and bitrate are enabled only if the Video option is checked.
<ul>
<li>Select the required codec from the '''Codec''' list. The available video codecs are MPEG-1, MPEG-2, MPEG-4, DIVX 1, DIVX 2, DIVX 3, H-263, H-264, WMV1, WMV2, MPEG, and Theora. </li>
<li>Specify an average bitrate in the '''Bitrate''' (kb/s) box.</li>
<li>Select a scale from the Scale list. The values are 1, 0.25, 0.5, 0.75, 1.25, 1.5, 1.75, and 2. </li>
</ul>

Audio Codec

The '''Audio''' option is selected by default. The options related to codec, bitrate and channels are enabled only if the Audio option is checked.
<ul>
<li>Select an audio codec from the '''Codec''' list. The available audio codecs are Vorbis, MPEG Audio, MP3, MPEG4 Audio (AAC), A52/AC-3, Flac, Speex, WAV and WMA. </li>
<li>Specify an average bit rate in the '''Bitrate''' (kb/s) box.</li>
<li>Select a channel from the '''Channels''' list. In audio, a channel refers to a stream of audio that is to be played by one speaker. For example, stereo audio, consists of two channels. </li>
</ul>

Subtitles

Specify subtitles to be streamed along with your media file. To specify subtitles
<ul>
<li>Check the '''Subtitles''' checkbox and select a subtitle from the '''Subtitle''' list.</li>
This is the subtitle format that is to be included with the media that is streamed.
<li>Check the '''Overlay subtitles on the video''' option to render subtitles directly on the video, while transcoding it.</li>
</ul>

Miscellaneous

Time-To-Live (TTL)- This sets the numbers of routers your stream can go through, for UDP unicast and unicast access methods. With UDP multicast, the default TTL is set to 1, meaning that your stream won't get across any router. You may want to increase it if you want to route your multicast stream.

SAP Announce - SAP is a way to publicly announce streams that are being sent using multicast UDP or RTP. Enter the name of the stream in the text box. This is available only for the RTP streaming method.

<blockquote>
Group Name – This allows you to specify a group for the session, which will be announced. Enter a name. This option is enabled only if the '''SAP Announce''' box is checked.</blockquote>

Stream all elementary streams – Select this option to you to stream all soundtracks and subtitles. This option separates the different elementary streams from a stream, and saves each of them in a different file or sends it to a separate destination.

Keep stream output open - Select this option to save incoming streams. This option is also used to make VLC act as a streaming server.

The options selected are displayed as a concatenated string in the '''Generated Stream Output String''' box.
<li>Click on the Stream button. The selected file is streamed to the selected locations.</li>
'''Note:''' The '''Streaming''' option present under the '''Media''' menu is the same as the '''Stream''' option in the [[Image:submenu.JPG]] list.

====Common Options====
VLC provides some common options which are easily accessible.
Select '''Advanced Open File''' from the '''Media''' menu.

The Open file dialog box is displayed. There are four tabs such as '''File''', '''Disc''', '''Network''' and '''Capture Device'''. The options mentioned in the table are part of a dropdown list which is displayed when the [[Image:submenu.JPG]] button is clicked.

<table width="60%" border="1">
<tr>
<td width="10%" bgcolor="#F5F5F5">Option</td>
<td width="10%" bgcolor="#F5F5F5">Shortcut Key</td>
<td width="40%" bgcolor="#F5F5F5">Description</td>
</tr>

<tr>
<td width="10%">Enqueue</td>
<td width="10%">Alt + E</td>
<td width="40%">Adds media files to the playlist but doesn't play it until you click '''Play'''.</td>
</tr>

<tr>
<td width="10%">Play</td>
<td width="10%">Alt + P</td>
<td width="40%">Adds media files to the playlist and plays the media.</td>
</tr>

<tr>
<td width="10%">Stream</td>
<td width="10%">Alt + S</td>
<td width="40%">Adds media files to the playlist and streams it on the network.</td>
</tr>

<tr>
<td width="10%">Convert</td>
<td width="10%">Alt + C</td>
<td width="40%">Adds media files to the playlist. 
Converts a media file into the selected format.
</td>
</tr>
</table>

'''Note:''' Leave '''Play locally''' unchecked because it decreases the conversion time. If you simultaneously play a file and convert it, it takes much more time.

===Opening a Capture Device===
A capture device captures an image from a video file or sound from an audio file. Capture devices include webcams, external DVD players, TV cards and acquisition cards. VLC supports capture devices if the devices have the DirectShow compatible drivers.

To capture media

<ol>
<li>Select '''Open Capture Device''' from the '''Media''' menu. The Open dialog box is displayed with the '''Capture Device''' tab selected. </li>
VLC media player supports three modes of capture DirectShow, DVB DirectShow and Desktop.

'''DirectShow:''' DirectShow, a Windows media streaming architecture, supports capture from digital and analog devices. DirectShow automatically detects and uses video and audio acceleration hardware when available, but also supports systems without acceleration hardware.

To capture content using the DirectShow plug-in, select '''DirectShow''' from the '''Capture Mode''' list. The options in the rest of the dialog box change based on the option selected in the Capture Mode list.

If you want to capture video, select a device from the list next to the '''Configure''' button under the '''Card Selection''' group. VLC provides default values. To adjust more options, select the required options from the device settings.
 

<ol>
<li>Click on the '''Configure''' button for Video. The Properties dialog box is displayed with two tabs, '''Device Settings''' and '''Advanced'''. </li>
<li>If the device name does not appear in the list, click on the '''Refresh''' button. The device name appears in a list next to the '''Configure''' button.</li>

'''Device Settings''' 
[[Image:Device settings.JPG]]

If the '''Auto''' box is checked for any parameter, the software automatically fixes the value for the parameter based on the video file. By default, the Auto option is enabled only for the White Balance parameter.
<ul>
<li>'''Brightness:''' Move the slider till you get the desired brightness for the video capture. The default value is 5000. </li>

<li>'''Contrast:''' Refers to the difference in visual properties that makes an object distinguishable from other objects and the background. Move the slider till you get the desired contrast. The default value is 5000. </li>

<li>'''Saturation:''' Refers to the difference of a color against its own brightness. Move the slider to get the desired effect. The default value is 5000. </li>

<li>'''Sharpness:''' Refers to the clarity of a video. Move the slider till you get the desired sharpness for the video capture. The default value is 6000. </li>

<li>'''White Balance:''' Refers to colour balance. This option helps to make white actually white and makes skin tones look more natural. Uncheck the '''Auto''' option and Move the slider to get the desired effect.</li>

<li>'''Backlight Comp:''' Refers to the ability of a camera to compensate in cases where a subject with a large amount of background light would otherwise be obscured by excessive light. The default value is 0. Move the slider to get the desired effect.</li>
</ul>

'''Advanced Settings'''

[[Image:advanced settings.JPG]]

'''Automatic Gain Control''' – Is a circuit found on some electronic devices that automatically controls the gain of a signal. In AGC, weaker signals receive more gain and stronger signals receive less gain or none at all.
<ul>
<li>'''Exposure''' - Refers to the amount of light allowed to fall on a selected media file while capturing images. There are occasions when you may have to manually adjust the exposure on your camera. Exposure is measured in seconds. 

For example, you have to take a shot of a person from a certain angle, and there is bright light behind the person. In such case, aim your camera on the person and adjust the exposure value by moving the slider. The specified value remains unchanged even after closing the VLC application.</li>

<li>'''Gain''' - This option allows increasing or decreasing the brightness of the video being captured. 
When '''Automatic Gain Control''' is selected, the values you specified are taken as the default values for Exposure and Gain. 

Uncheck '''Automatic Gain Control''' to change the values of '''Exposure''' and '''Gain''' by moving the sliders.</li>
</ul>

'''Image Mirror'''
<ul>
<li>'''Mirror Horizontal''' – If you select this option, the video clip is flipped horizontally. You can see a mirror view of the captured picture.</li>
<li>'''Mirror Vertical''' - If you select this option, the video clip is flipped upside down. </li>
</ul>

'''Anti-Flicker''' – Refers to a process of filtering digital images to reduce image flicker. The available options are Off, 50 Hz (European) and 60 Hz (North America).

'''Image Enhancement''' – You can enhance the video being captured in terms of light and color using the following options:
<ul>
<li>'''Low Light Boost''' – If you check this option, the exposure time of the camera increases in poor light conditions.</li>
<li>'''Color Boost''' – If you check this option, the colors of the video being captured are boosted.</li>
</ul>

If you want to capture audio, select a device from the list next to the '''Configure''' button under the '''Card Selection''' group.

Click on the '''Configure''' button for Audio. The Properties dialog box is displayed. Specify the AudioInputMixer properties.

[[Image:Audioinputprop.JPG]]

In the Master Input Mix group, check the '''Enable''' box. Control the tone of the audio using the Treble and Bass sliders.
<ul>
<li>'''Loudness''' – Refers to volume of the audio. Adjust the volume by moving the slider.</li>
<li>'''Mono''' – Refers to an amplifier connection. Adjust the volume by moving the slider.</li>
</ul>
In the Pin Line Input Mix group, check the '''Enable''' box.
Select a line from the '''Pin Line''' list. The values in the Pin Line list are populated based on the selected audio input device.

<li>Click on the '''Advanced options''' button to specify the following properties:</li>
<ul>
<li>'''Caching value in ms''' – Refers to the caching value for DirectShow streams. Enter or select a value.</li>
<li>'''Video device name''' – Refers to the name of the video device that is used by DirectShow plugin. If you do not specify a device, the default device is used.</li>
<li>'''Audio device name''' – Refers to the name of the audio device that is used by DirectShow plugin. If you do not specify a device, the default device is used.</li>
<li>'''Video size''' – Refers to the size of the video that is displayed by the DirectShow plugin. The size of video is measured in pixels. If you do not specify the size, the default size is used.</li>
<li>'''Video input chroma format''' - Chroma refers to the way colors are encoded. Enter a specific chroma format. The default value is 1420. </li>
<li>'''Video input frame rate''' – Enter a specific frame rate. The default value is 0. </li>
<li>'''Device properties''' – Check this option to view the properties dialog of the selected device before starting the stream.</li>
<li>'''Tuner properties''' – Using this option you can set channels. A tuner converts signals into picture and sounds. Select this option to view the tuner properties (channel selection) dialog box. </li>
<ul>
<li>'''Tuner TV channel''' – Refers to a tuner for setting TV channels. The default is 0. The default channel is used to capture the media.</li>
<li>'''Tuner country code''' – This option helps to establish the current channel-to-frequency mapping. The default is 0. </li>
<li>'''Tuner input type''' – Select the tuner input type. Available values are cable and antenna. </li>
<li>'''Video input pin''' – Select a video input source. Available values are Composite, S-video, and Tuner. These settings are hardware-specific. -1 means that settings will not be changed.</li>
<li>'''Audio input pin''' – This option is used to capture audio using a specific audio input pin. These settings are hardware-specific. Select a number from the Audio input pin list. </li>
<li>'''AM Tuner mode''' – This option is used to select a AM (amplitude modulation). The following are the tuner modes:</li>
<table border="1">
<tr>
<td bgcolor="#F5F5F5">Value</td>
<td bgcolor="#F5F5F5">Mode</td>
</tr>
<tr>
<td>0</td>
<td>Default</td>
</tr>
<tr>
<td>1</td>
<td>TV</td>
</tr>
<tr>
<td>2</td>
<td>AM Radio</td>
</tr>
<tr>
<td>3</td>
<td>FM Radio</td>
</tr>
<tr>
<td>4</td>
<td>DSS</td>
</tr>
</table>
Select a number from the '''AM Tuner mode''' list.
<li>Number of audio channels – Select an audio input format with the given number of audio channels. If the channels are unavailable, select 0.</li>
<li>Audio sample rate – This option is used to set the sample rate. If the rates are unavailable, select 0.</li>
<li>Audio bits per sample – Select audio input format with the given bits or sample. If the audio bits are unavailable, select 0.</li>
</ul>
</ul>

<li>Select the '''Convert''' option to select the encoding formats and click on the '''Save''' button. Refer to [[#Converting_and_Saving_a_Media_File_Format|Converting and Saving a media file format]].</li>
<li>Click on the '''Play''' button. The capturing of the media starts.</li>
</ol>

'''DVB DirectShow''' - Refers to a suite of internationally accepted open standards for digital television. VLC media player supports three types of DVBs and they are:

<ul>
<li>'''DVB-S''' - Is an abbreviation for Digital Video Broadcasting - Satellite. It is the Digital Video Broadcasting forward error coding and modulation standard for satellite television. This is used via satellites. </li>

<li>'''DVB-C''' – Is an abbreviation for Digital Video Broadcasting – Cable. It is the DVB European consortium standard for the broadcast transmission of digital television over cable. This system transmits MPEG-2 or MPEG-4 audio and video streams using a QAM modulation.</li>

<li>'''DVB-T''' - Is an abbreviation for Digital Video Broadcasting – Terrestrial. It is the DVB European-based consortium standard for the broadcast transmission of digital terrestrial television. This system transmits compressed audio, video and other data in the MPEG format using the COFDM modulation.</li>
</ul>

'''Note:''' Ensure that you have the DVB card installed on your PC.

'''DVB-S''' – You can stream a live TV from a PC using the DVB-S option. To stream
<ol>
<li>Select '''Open Capture Device''' from the '''Media''' menu. The Open dialog box is displayed.</li>
<li>Select the '''Open Capture Device''' tab. </li>
<li>Select '''DVB DirectShow''' from the '''Capture Mode''' list. </li>
<li>Select '''DVB-S''' from '''DVB Type''' under the '''Card Selection''' group. In the '''Options''' group, specify the following </li>
<li>Select '''Transponder/multiplex frequency''' to set the transponder frequency. A transponder is a device that receives, amplifies and retransmits a signal on a different frequency.</li>
<li>Select '''Transponder symbol rate''' to set the transponder symbol rate. </li>
<li>Click on the '''Advanced options''' button to specify the following parameters:</li>
<ul>
<li>'''Caching value in ms''' – Refers to caching value for the DirectShow stream. Enter a value in milliseconds.</li>
<li>'''Transponder / multiplex frequency''' - A transponder is a device that receives, amplifies and retransmits a signal on a different frequency. Select a frequency.</li>
<li>'''Inversion Mode''' - Description to be added</li>
<li>'''Satellite polarization''' – Polarization is a method of giving transmission signals a specific direction. The signals transmitted by a satellite can be polarized in four ways and they are: Horizontal, Vertical, Circular Left and Circular Right. Select an option.</li>
<li>'''Network identifier''' – Refers to a unique ID used to identify a network. Select a number from the '''Network identifier''' list.</li>
<li>'''Satellite Azhimuth''' – Azhimuth is an angular measurement made in the horizontal plane. Enter a value.</li>
<li>Satellite Elevation– This option defines the angle between the Earth and the position of a satellite. Enter a value.</li>
<li>'''Satellite Longitude''' – Refers to the satellite longitude in 10ths of degree. Enter a value.</li>
<li>'''Antenna lnb_lof1''' – Refers to low band local Osc Freq in kHz. Enter a value in kHz.</li>
<li>'''Antenna lnb_lof2''' - Refers to high band local Osc Freq in kHz. Enter a value in kHz.</li>
<li>'''Antenna lnb_slof''' – Refers to low noise block switch freq in kHz. Enter a value in kHz.</li>
<li>'''Transponder FEC''' – Refers to the forward error correction mode. Enter a value in kHz.</li>
<li>'''Transponder symbol rate in kHz''' Description to be added</li>
<li>'''Modulation Type''' – Refers to the QAM constellation points. The available values are 16, 32, 64, 126, and 256.</li>
<li>'''Terrestrial high priority stream code rate (FEC)''' – Refers to the high priority FEC Rate. The available values are Undefined, 1/2, 2/3, 3/4, 5/6 and 7/8.</li>
<li>'''Terrestrial low priority stream code rate (FEC)''' – Refers to the low priority FEC Rate. The available values are Undefined, 1/2, 2/3, 3/4, 5/6, and 7/8.</li>
<li>'''Terrestrial bandwidth''' - Description to be added</li>
<li>'''Terrestrial guard interval''' – Refers to a parameter that is used in encoding and modulation. Select an interval from the list. </li>
<li>'''Terrestrial transmission mode''' - Description to be added</li>
<li>'''Terrestrial hierarchy mode''' - Description to be added</li>
</ul>
</ol>

'''DVB-C''' - You can stream digital TV using digital signal cables. The following is a procedure to stream content using the DVB-C standard.
<ol>
<li>Select '''Open Capture Device''' from the '''Media''' menu. The Open dialog box is displayed.</li>
<li>Select the '''Open Capture Device''' tab. </li>
<li>Select '''DVB DirectShow''' from the '''Capture Mode''' list. </li>
<li>Select '''DVB-C''' from '''DVB Type''' under the '''Card Selection''' group. </li>
<li>Select '''Transponder/multiplex frequency''' to set the transponder frequency. </li>
<li>Select '''Transponder symbol rate''' to set the transponder symbol rate.</li>
<li>Select an extra media if you want some background music using '''Show more options'''. Refer to [[#Playing_more_than_one_media_filePlaying more than one media file.</li>
<li>Select '''Convert''' to select the encoding formats and click on the '''Save''' button. Refer to Converting and Saving a Media File Format.</li>
<li>Click on the '''Play''' button to play the media.</li>
<li>Click on the '''Cancel''' button to exit the screen. </li>
</ol>

'''DVB-T''' - Follow the procedure below to stream DVB-T channels:
<ol>
<li>Select '''Open Capture Device''' from the '''Media''' menu. The Open dialog box is displayed.</li>
<li>Select the '''Open Capture Device''' tab. </li>
<li>Select '''DVB DirectShow''' from the '''Capture Mode''' list. </li>
<li>Select '''DVB-T''' from '''DVB Type''' under the '''Card Selection''' group. </li>
<li>Select '''Transponder/Multiplex frequency''' to set the transponder frequency. </li>
<li>Select '''Bandwidth''' to set the terrestrial bandwidth. </li>
<li>Select an extra media if you want some background music using '''Show more options'''. Refer to Playing more than one media file.</li>
<li>Click on the '''Play''' button to play the media.</li>
<li>Click on the '''Cancel''' button to exit the screen.</li>
</ol>

'''Note:''' The Advanced Options for the DVB-C and DVB-T are the same as the Advanced Options for the DVB-S.

'''Desktop''' - You can capture all your mouse movements and application actions and save the video in the selected format. This option is used to record the on-screen activity on your Windows desktop. For example, you can create videos to demonstrate the features or usage of a software.

<ol>
<li>To capture the desktop, select '''Open Capture Device''' from the '''Media''' menu. The Open dialog box is displayed.</li>
<li>Select the '''Open Capture Device''' tab. </li>
<li>Select '''Desktop''' from the '''Capture Mode''' list. </li>
<li>Enter a frame rate in the '''Desired frame rate''' for the capture box.</li>
<li>Select '''Convert''' to select the encoding formats and click on the '''Save''' button. Refer to Converting and Saving a media file format.</li>
<li>Select an extra media if you want some background music using '''Show more options'''. Refer to Playing more than one media file.</li>
<li>Click on the '''Play''' button to play the media.</li>
<li>Click on the '''Cancel''' button to exit the screen.</li>
</ol>

===Streaming Media Files===
Streaming is a method of delivering audio or video content across the network without downloading a file before it is played. You can view or listen to the content as it arrives. The advantage is that you need not download large files to watch a movie or listen to music.
VideoLAN is designed to stream MPEG videos on high bandwidth networks.

VLC can be used as a server to stream MPEG-1, MPEG-2 and MPEG-4 files, DVDs and live videos on the network in unicast or multicast.

Unicast refers to a process where media files are sent to a single system through the network. Multicast refers to a process where media files are sent to multiple systems through the network.

VLC is also used as a client to receive, decode and display MPEG streams. MPEG-1, MPEG-2 and MPEG-4 streams received from the network or video from a camcorder can be sent to one machine or a group of machines.

[[Image:streamingdiag.JPG]]

To stream a file
<ol>
<li>Select '''Streaming''' from the '''Media''' menu. The Open dialog box is displayed. The '''Open File''' tab is selected by default. </li>
<li>Select the media file from the options available such as a file, a network, a disc or a capture device.</li>
<li>Click on '''Stream'''. The Stream Output dialog box is displayed. Refer to [[#Specifying_Streaming_Options|Specifying Streaming Options]].</li>
<li>Click on '''Stream''' in the Stream Output dialog box. </li>
</ol>

Note: When the streaming is being done, the slider moves to show the progress.

===Converting and Saving a Media File Format===
VLC media player is the best option for multimedia conversion. It can convert different media formats to the format of your preference. To convert a media file
<ol>
<li>Select '''Open File''' from the '''Media''' menu. The Open dialog box is displayed.</li>
<li>Select a media file and click on the '''Open''' button. The media file is played.</li>
<li>Select '''Convert/Save''' from the '''Media''' menu. The Open dialog box is displayed.</li>
<li>Select the media file and click on '''Convert'''. The Stream Output dialog box is displayed. Refer to [[#Specifying_Streaming_Options|Specifying Streaming Options]]</li>
</ol>
==Audio==
Using the VLC media player, you can play audio files of different formats. You can enable tracks, convert audio tracks, view tracks in various visualizations, and set visualizations. Audio tracks of the ''.asf, .avi, .divx, .dv, .mxf, .ogg, .gm, .ps, .ts, .vob,'' and ''.wmv'' formats are supported.

'''Note:''' The options under the '''Audio''' menu are enabled only if an audio file is played.
===Playing an Audio Track===
You can play, enable and disable an audio track. To play a track
<ol>
<li>Select '''Open File''' from the '''Media''' menu. </li>
<li>Select an audio file and click on the [[Image:toggleplaypause.JPG]] '''Play''' button. The selected track is played.</li>
<li>To disable a track, select the '''Disable''' option in the '''Audio Track''' from the '''Audio''' menu. The selected track stops.</li>
<li>To play the same track again, select the '''Track 1''' option in the '''Audio Track''' from the '''Audio''' menu. The selected track is played.</li>
</ol>

===Audio Device===
This option helps you to listen to audio files in two modes: stereo and mono.
<ol>
<li>To listen to an audio track in either the Stereo or Mono mode, select '''Open File or Open Disc''' from the '''Media''' menu. The Open dialog box is displayed.</li>
<li>Select an audio file and click on the [[Image:toggleplaypause.JPG]] '''Play''' button. The selected track is played.</li>
<li>Select '''Mono''' in '''Audio Device''' from the '''Audio''' menu if you want to listen to the audio track in the Mono mode.</li>
Mono refers to monoaural sound that uses a single channel for sound reproduction.
<li>Select '''Stereo''' in '''Audio Device''' from the '''Audio''' menu if you want to listen to the audio track in the Stereo mode.</li>
Stereo refers to sound that uses two channels for sound reproduction.
</ol>

===Audio Channels===
In audio, a channel refers to a stream of audio that is to be played by one speaker. For example, stereo audio, consists of two channels. This option is useful for codecs that don’t have support for more than 2 channels.

Select a channel type in '''Audio Channels''' from the '''Audio''' menu. VLC media player provides four audio channels and they are:
<ol type="a">
<li>'''Stereo''' – Refers to the reproduction of the sound in two channels using more than one speaker. If you use this option, you would feel as though the sound is played from all the directions. You can observe this in a regular home theatre with 5.1 or 6.1 speakers. </li>
<li>'''Left''' – You can observe this in a regular audio player with 2.1 speakers. If you select the Left option, the music is played only in the left speaker. The speaker on your right is automatically switched OFF.</li>
<li>'''Right''' - If you select the '''Right''' option, the music is played only in the speaker on your right side. The speaker on your left is automatically switched OFF.</li>
<li>'''Reverse Stereo''' – There are several applications that are used to reverse the stereo whereas VLC has an in-built feature to reverse the stereo. This option is useful if you want the audio to play in tandem with the video. You can use the '''Reverse Stereo''' option if you want to deliberately change the audio output.</li>
</ol>
Imagine that you are watching a video. In the video, a person walks on the left side but the sound is produced on the right speaker. You can correct this by selecting the '''Reverse Stereo''' option in VLC. Select the '''Reverse Stereo''' option and play the same scene in the video and observe the difference.

You can observe this with 2.1, 5.1 and 6.1 speakers.

===Visualise Audio===
Visualizations display splashes of colour and geometric shapes when audio is played.

The different visual effects available are Spectrometer, Scope, VU Meter, Spectrum and Goom.
<ol>
<li>Select an option under the '''Visualizations''' option from the '''Audio''' menu to view the effects. The selected visualization is played.</li>
<li>To disable visualizations, select '''Disable''' under '''Visualizations''' from the '''Audio''' menu. The visualization is disabled.</li>
</ol>
==Video==

You can play video files, video clips and others using the VLC media player. You can resize, change the aspect ratio, crop videos, load subtitles, deinterlace, save snapshots, and convert videos as DirectX wallpapers.

Video tracks of the ''.asf, .avi, .divx, .dv, .mxf, .ogg, .gm, .ps, .ts, .vob,'' and ''.wmv'' formats are supported.

===Playing a Video Track===
<ol>
<li>Select '''File => Quick Open File...''' or key CTRL-O. </li>
<li>Select a video track and double-click it. </li> </ol>

The selected track is played.

===Loading Subtitle Tracks===
A subtitle is a textual version of a movie’s dialogue. Subtitles are helpful if you are viewing a movie in a language that is not understandable to you. You can load subtitles for video tracks. Subtitles of the formats ''.cdg, .idx, .srt, .sub, .utf, .ass,'' and ''.ssa'' are supported.

VLC can read subtitles for the media such as DVD, SVCD, OGM files, and Matroska (MKV) files.

To enable the subtitle for a track
<ol>
<li>Select '''Load''' under '''Subtitle''' from the '''Video''' menu. The Open Subtitles File dialog box is displayed.</li>
<li>Locate the file which contains the subtitle and click on '''Open'''. The subtitle is displayed.</li>
</ol>

===Zoom===
You can enlarge videos in different sizes. This option is useful if you want to change the size of a video track which is being played. The supported sizes are ''1:4 Quarter, 1:2 Half, 1:1 Original'' and ''2:1 Double''.

To view a video in a particular dimension, select a dimension from '''Zoom''' in the '''Video''' menu.
The track is resized based on the selected dimension.

===Deinterlace===
Deinterlace refers to a process where interlaced video signals are converted into non-interlaced signals. VLC provides the ''Discard, Blend, Mean, Bob, Linear'', and ''X'' deinterlacement methods.
<ol>
<li>Select '''Deinterlace''' from the '''Video''' menu. The '''Deinterlace''' menu has a sub menu which contains a list of methods. </li>
<li>Select a method and observe the change in the video being played.</li>
</ol>

===Aspect Ratio===
Aspect ratio refers to the width of a picture in relation to its height. For example, the ratio 4:3 means four units wide to three units high. VLC provides a list of aspect ratio values and they are ''Default, 1:1, 4:3, 16:9, 16:10, 2.21:1,'' and ''5:4''.

To select an aspect ratio, select '''Aspect Ratio''' from the '''Video''' menu. The video is adjusted based on the selected ratio.

===Crop===
This option is helpful if you want to capture a small portion of a video as an image. This also helps crop the black bars of the top and bottom of a video.

The cropping values that are supported are ''Default, 16:10, 16:9, 1.85:1, 2.21:1, 2.35:1, 2.39:1, 5:3, 4:3, 5:4,'' and ''1:1''.

To crop a video that is played, select a value from '''Crop''' in the '''Video''' menu.
The video is cropped based on the selected value.

===Full Screen===
This option is useful if you want to watch the video in the full screen mode.
<ol>
<li>Select '''Full Screen''' from the '''Video''' menu. The video occupies the entire screen.</li>
<li>To return to the original mode, press Esc on the keyboard or right-click the mouse and select the '''Leave Full Screen''' option. The video returns to its original mode.</li>
</ol>

'''Note:''' When you switch to full screen, the controls may appear for a short period of time. To restore the controls after they disappear, move the mouse or press any key on the keyboard.

===Always on Top===
This option is useful if you want the VLC media player to remain on the top of the screen always when other applications or files are open.
<ol>
<li>To make the VLC media player appear on top of the screen, select '''Always on Top''' from the '''Video''' menu.</li>
<li>If you do not want VLC to appear on the top of the screen, select the '''Always on Top''' option from the '''Video''' menu and manually minimise the VLC application.</li>
</ol>

===DirectX Wallpaper===
This option is useful if you want to display the video which is being played as your desktop wallpaper.

To view the current video file as wallpaper
<ol>
<li>Select '''Advanced File Open''' from the '''Media''' menu. The Open dialog box is displayed.</li>
<li>Select a file and click [[Image:toggleplaypause.JPG]] '''Play'''.</li>
<li>Select '''DirectX Wallpaper''' from the '''Video''' menu.</li>
</ol>

The wallpaper mode displays the video as the desktop background. Note that this feature works only if you deactivate overlay under Windows XP.

===Snapshot===
This option is useful if you want to capture a portion of the video as an image.

<ol>
<li>Select '''Advanced File Open''' from the '''Media''' menu. The Open dialog box is displayed.</li>
<li>Select a file and click [[Image:toggleplaypause.JPG]] '''Play'''.</li>
<li>To capture an image from the video, select Snapshot from the '''Video''' menu. </li>
</ol>

The image is captured as a .png file and is saved in the ''C:\My Pictures'' folder by default.

==Playback==
VLC media player helps you to create media files. After creating media files, the quality has to be tested. You can test the quality and several other parameters using playback. In playback, you can specify parameters such as time, bookmarks, and titles.

===Specify the time===
This option is used to go to a specific frame in a media file and listen or view once again.
<ol>
<li>To specify time select '''Go to Specific Time''' from the '''Playback''' menu. The Go to Time dialog box is displayed.</li>
<li>Enter the time in hh:mm:ss. </li>
<li>Click on the '''Go''' button. The control moves the tracker to a specific frame and the media file continues from that specified frame.</li>
<li>Click '''Cancel''' to exit the dialog box.</li>
</ol>
'''Note:''' Ensure that time limit is within the range of length of the media file.

[[Image:Gototime.JPG]]

===Bookmarks===
You can mark and locate particular places in an audio or video file using the Bookmarks feature of VLC. If you want to view a particular scene in a movie or listen to certain tune in a song repeatedly, you can create bookmarks.

To bookmark a scene in a movie

<ol>
<li>From the '''Tools''' menu select the '''Bookmarks''' option. The Edit Bookmarks dialog box is displayed. </li>
<li>Click '''Create''' to create a bookmark for the current track. The created bookmark is displayed in the Edit Bookmarks dialog box. </li>
<li>To view a scene that is bookmarked, select a bookmark from '''Bookmarks''' in the '''Playback''' menu. </li>
</ol>
'''Note:''' The '''Bookmarks''' option in the '''Playback''' menu will not be enabled if bookmarks are not created.
'''Note:''' Loading bookmarks is currently broken as of 0.9.9 see http://trac.videolan.org/vlc/ticket/2100

===Title===
In a DVD format, each movie is referred to by its title or name. A title is displayed whenever a movie is played by any media player. You can view all titles in a folder in a sequential manner.
<ol>
<li>To open a folder, select '''Open Folder''' from the '''Media''' menu. Locate the folder in which the video files are present and click on '''OK'''. </li>
<li>To select a title, select a '''Title''' under '''Title''' in the '''Playback''' menu. The selected title is played.</li>
</ol>

===Chapter===
A video is divided into chapters. Different chapters can be accessed at random in a video which is being played. Using this option, you can directly view your favourite chapter without having to see the complete video.

To play a chapter

<ol>
<li>Select '''Open Folder''' from the '''Media''' menu. </li>
<li>Locate the folder in which the video files are present. </li>
<li>Select a video file and click on '''OK'''. </li>
The file is played in the VLC media player.
<li>Select '''Chapter''' in the '''Playback''' menu to view the list of chapters. Select a chapter of your choice.</li>
The selected chapter is played.
</ol>

===Navigation===
In VLC, you can navigate to different titles and their corresponding chapters. You can also customise a DVD by selecting options such as subtitle, angle and so on.
<ol>
<li>To customise a title, select the required option from '''DVD Menu''' in the '''Navigation''' menu.</li>
<li>To view a title, select a '''Title''' under '''Navigation''' in the '''Playback''' menu. The selected title is played. </li>
<li>To view a chapter in a title, select '''Title'''. When you select a title, the chapters in a title are listed. Select a chapter.</li>
</ol>

Refer to [[#Title|Title]] and [[#Chapter|Chapter]] sections for more details.

===Program===
This option is enabled only if streams of format DVB and TS are played.
Choose the program to select by giving its Service ID. Only use this option if you want to read a multi-program stream (like DVB streams for example).
Description needs to be improved

==Playlist==
A playlist is a customised list of media files you might want to watch or listen to. Using a playlist, you can specify the media files you want to listen each time you start the VLC media player. You can add tracks from CDs, radio stations, and movies to a playlist.

===Additional Sources===
In addition to audio and video files, you can play other formats. The additional formats supported by VLC media player are described in the following sections:

<ul>
<li>'''Podcasts''' - Podcast (Personal On Demand broadCASTING) is a series of audio or video digital media files which is distributed over the Internet and downloaded to media players. If consumers subscribe to Podcasts, whenever new content is added the content gets automatically added to the playlist.

You can customise Podcasts. To add a Podcast URL
<ol>
<li>Select '''Podcast''' from '''Additional Sources''' in the '''Playlist''' menu.</li>
<li>Select '''Show Playlist''' from the '''Playlist''' menu. The Playlist dialog box is displayed. Podcast is added in the left pane. </li>
<li>Click on '''Podcast''' to select it in the left pane. The Podcast streams are added under Title in the right pane.</li>
<li>Select a Podcast stream and right-click. Select '''Play''' from the popup menu.</li>
</ol>

<li>'''SAP Announcements''' – Helps to advertise your stream over the network. </li>
To play a SAP announcement
<ol>
<li>Select '''SAP Announcement''' from '''Additional Sources''' in the '''Playlist''' menu.</li>
<li>Select '''Show Playlist''' from the '''Playlist''' menu. The Playlist dialog box is displayed. SAP is added in the left pane. </li>
<li>Click on '''SAP''' to select it in the left pane. The SAP announcements are added under Title in the right pane.</li>
<li>Select an SAP announcement and right-click. Select '''Play''' from the popup menu.</li>
</ol>

<li>Shoutcast Radio Listings – Shoutcast is a server for streaming the media developed by Nullsoft. Digital audio content can be broadcast from and to media players, and this helps individuals to create Internet radio networks. Using VLC media player, you can listen to your favourite radio stations and you can also create bookmarks to listen to these radio stations in future.</li>

To customise a Shoutcast radio listing
<ol>
<li>Select '''Shoutcast radio listing''' under '''Additional Sources''' in the '''Playlist''' menu.</li>
<li>Select '''Show Playlist''' from the '''Playlist''' menu. The Playlist dialog box is displayed. Shoutcast Radio is added to the playlist. Shoutcast Radio is added only if you select '''Shoutcast radio listing''' from '''Additional Sources'''. </li>
<li>Select the Shoutcast Radio in the left hand panel. A list of radio stations appears in the right hand panel. If nothing appears in the right hand panel try double-clicking the '''Shoutcast Radio''' option and wait. It may take a few minutes the first time. After a while, the right hand panel displays a list of titles.</li>

[[Image:Vlc-playlistshoutcastradio-en.png]]

<li>Scroll down and select a radio station. </li>
<li>Right-click on a radio station and
<ol type="a">
<li>Select '''Play''' if you want to listen to the radio station. </li>
<li>Select '''Delete''' if you want to delete the radio station.</li>
<li>Select the '''Stream''' option. The Stream output dialog box is displayed. Refer to the Specifying [[#Specifying_Streaming_Options|Specifying Streaming options]] section for more details. Modify the required parameters and click on the '''Stream''' button to stream the media file. </li>
<li>Click to select a title in the Playlist dialog box and right-click. Select '''Save''' from the popup menu. The Stream Output dialog box is displayed. Select the required options and click on the '''Save''' button in the Stream Output dialog box. Refer to the [[#Specifying_Streaming_Options|Specifying Streaming options]] section for more details.</li>
<li>Select the Information option. The Media Information dialog box is displayed with details of the media being played. </li>
<li>Select '''Sort''' to alphabetically sort the radio stations.</li>
<li>Click to select a title in the Playlist dialog box and right-click. Select '''Open Folder''' from the popup menu. A folder is opened to show all sub nodes within a title. </li>
<li>Select '''Add Node''' to add a node.</li>
<li>Click to select a title in the Playlist dialog box and right-click. Select '''Information''' from the popup menu to view the details of the selected title. Refer to the Media Information section for more details on options.</li>
</ol>
</ol>

<li>'''Shoutcast TV stream''' – You can watch streaming TV using the VLC media player. Shoutcast TV stream refers to a stream transmitted by Nullsoft.
The procedure of customising the TV stream and the options are similar to that of the Shoutcast Radio.</li>
<li>'''Freebox TV listing''' – Refers to television service over ADSL accessible by Freebox Free Zone unbundled.</li>
</ul>

'''Note:''' You should be connected to the Internet to access these streams.

===Add Media Files to Playlist===
You can add several media files to a playlist. The media files could be selected from the media library, additional sources, and some other source.

To add files to a playlist
<ol>
<li>Select '''Show Playlist''' from the '''Playlist''' menu. The Open playlist file dialog box is displayed. </li>
<li>Locate the media file and click on '''OK'''.</li>
<li>Click on the [[Image:add.JPG]] '''Add''' icon. A short list appears with two options: Add file and Add directory.
<ol type="a">
<li>Select '''Add file''' to add a file to the playlist. </li>
<li>Select '''Add directory''' to add a directory containing media files to the playlist.</li>
</ol>
<li>Click on the [[Image:random.JPG]] '''Random''' icon. This icon toggles between '''Random''' and '''Random Off'''. Click on [[Image:random.JPG]] to play files at random. Click on [[Image:random.JPG]] and the files are played in an order.</li>
<li>Click on the [[Image:repeat.JPG]] '''Repeat''' icon. This icon toggles between '''Repeat One''' and '''Repeat All'''. If you want to listen to a track several times, click on [[Image:repeat.JPG]] icon. If you want to listen to all tracks, click on [[Image:repeat.JPG]] again.</li>
<li>To search for a media file, enter the name in the '''Search''' box. To search for media files with certain names or formats, enter a word or phrase in the '''Search''' box. All files with the specified name are listed.</li>
<li>Click on the [[Image:skip.JPG]] icon. This icon is used to skip to the current item when you have a very long list.</li>
<li>Click on the [[Image:clear.JPG]] icon to clear a track from the playlist. </li>
</ol>

===Load Playlist===
This option is used to add a playlist created in some other media player. You can load playlists of the ''.xspf, .asx, .b4s'' and ''.m3u'' formats. To load a playlist
<ol>
<li>Select the Load Playlist option from the Playlist menu. The Open playlist file dialog box is displayed.</li>
<li>Locate a playlist file and click on '''Open'''.</li>
The selected playlist is added in the current playlist dialog box.
</ol>

===Save Playlist===
You can save playlists using the VLC media player in format of your choice. To save a playlist
<ol>
<li>Create a playlist. Refer to [[#Add_Media_Files_to_Playlist|Add Media Files to Playlist]] for creating a playlist.</li>
<li>Select '''Save Playlist to File''' from the '''Playlist''' menu. The Choose a filename to save playlist dialog box is displayed. </li>
<li>Select the created playlist. </li>
<li>Select a format in which the playlist must be saved from the '''Files of type''' list. The Files of type list contains the ''.xspf'' and ''.m3u'' formats. </li>
<li>Click on '''Save''' to save the playlist in the selected format.</li>
</ol>

===Play a file===

To play a file, open the Media menu, and select the Open File menu item. An Open File dialog box will appear. Select the file you want to open, and click Open. VLC will start playing the selected file.
An alternative is to drag 'and' drop your file onto the VLC main interface or playlist window from the file explorer (Finder on MacOS X).
[[Image:Vlc-mediaopenfile-vistaclassic-en.png]]

VLC 0.9.8a version Windows XP mode

http://www.videolan.org/doc/play-howto/en/images/play-howto/intf-osx-file-menu.jpg The File menu - MacOS X interface'''- needs verifying for 0.9'''

[[Image:Vlc-mediaopenfileselected-vistaclassic-en.png]] The Open file dialog - wxWidgets interface

(need 0.9 screenshot for MacOS) The Open file dialog - MacOS X interface

===Play a CD/DVD/VCD===

To Play a CD, VCD or a DVD, open the ''File'' menu, and select the ''Open Disc...'' menu item. In the Open Disk Dialog Box, select the type of media (DVD, VCD or Audio CD). When reading a DVD, you can enable DVD menus by selecting the ''DVD (menus)'' disc type in the wxWidgets Interface. In the MacOS X interface, this can be done by selecting the "Use DVD menus" dialog box.

You can select the drive from which the media should be read by giving the appropriate drive letter or device name in the "Device Name" text input. This should be auto-detected on MacOS X.

If you want to start the DVD or VCD playback from a given title and chapter instead of from the beginning, you can set it using the ''Title'' and ''Chapter'' selectors.

You can start playback by selecting the ''Ok'' button.

http://www.videolan.org/doc/play-howto/en/images/play-howto/intf-wx-open-disk.jpg The Open disk dialog - wxWidgets interface'''- needs verifying for 0.9'''

http://www.videolan.org/doc/play-howto/en/images/play-howto/intf-osx-open-disk.jpg The Open disk dialog - MacOS X interface'''- needs verifying for 0.9'''

===Play a network stream (WebRadio, WebTV, etc.)===

To open a network stream, open the "Media" menu and select the "Open Network" menu item.

*To open a UDP unicast stream, select ''UDP/RTP'', and set the appropriate UDP port in the selector (it is 1234 for streams sent by a VLC or VLS server).
*To open a UDP multicast stream, select ''UDP/RTP multicast''. Give the address of the multicast group in the "Address" text input, and select the appropriate UDP port.
*To open a stream sent over http (Webradios, WebTVs, Shoutcast, Icecast...), ftp, or mms (Microsoft Media Server), select "HTTP/FTP/MMS", and give the corresponding complete URL, (http://www.tvcultura.com.br/radiofm/radiofm.asx) in the corresponding text input. This also the way to open a RTSP stream with the MacOS X interface.
*To open a RTSP stream (sent by Darwin Streaming Server, VLC, etc), in the wxWidgets interface, select "RTSP" and give the URL in the text input.

You can start playback by selecting the ''Ok'' button.

If you get some stuttering during playback, you can try to increase the size of the read buffer. This can be done in the ''Open Network Stream'' dialog box, by selecting the ''Caching'' box. You can then choose the amount time (in milliseconds) VLC should store data in its buffer before starting playback.

http://www.videolan.org/doc/play-howto/en/images/play-howto/intf-wx-open-net.jpg The Open network dialog - wxWidgets interface'''- needs verifying for 0.9'''

http://www.videolan.org/doc/play-howto/en/images/play-howto/intf-osx-open-net.jpg The Open network dialog - MacOS X interface'''- needs verifying for 0.9'''

==== Example finding a Shoutcast radio stream ====

This example was verified as working on 15 October 2008, using VLC 0.9.4 under Windows Vista.
''This needs reproducing by other people on other versions and other operating systems.''

1. Ensure your firewall is set to allow the VideoLan program to make outgoing connections.

2. Click ''Tools'' then ''Preferences'', click Interface and then click All under "Show settings". Then click the "-" next to "Playlist" in order to show the "Services discovery" submenu. If the shoutcast radio listings box is empty, click it so that a check-mark appears. The text field underneath should now show the word "shout". Click the Save button to save and close the Preferences window:

[[Image:Vlc-preferencesservicesdiscoveryshoutcrop-en.png]]

3. Restart VLC media player to make it take notice of the changed preferences.

4. On the VLC interface click ''Playlist'', then click ''Show Playlist''. Select the "Shoutcast Radio" in the left hand panel. If nothing appears in the righthand panel, try double-clicking "Shoutcast Radio" and waiting, it may take a few minutes the first time. After a while the righthand panel displays a long list of titles.

[[Image:Vlc-playlistshoutcastradio-en.png]]

5. Scroll down the radio stations in the right-hand panel and select one. Click the mouse right button and click the "Play" item.

[[Image:Vlc-playlistshoutcastradioplay-en.png]]

6. It may take some time for the connection to the radio station to establish (and it may fail if the station's outgoing streams are all occupied). When it does connect, VLC should start playing the audio stream from the station:

[[Image:Vlc-playlistshoutcastradioplayingsmall-en.png]]

==== Example playing a known Shoutcast radio stream ====

Go to http://www.shoutcast.com/ and search for a radio station of your choice. On Windows, right-click your mouse over Shoutcast's "Tunein" button and click "Save Link As..." to save the playlist on your computer. Remember where you saved the playlist, rename it to something that makes sense.

At any time later, you can use VLC to open the saved playlist and listen to that radio station.

For example, to find a BBC World Service radio stream, use a browser to go to:
http://www.shoutcast.com/directory/search_results.jsp?searchCrit=simple&s=bbc

One of the stations listed may be playing the World Service, if so move your mouse over the "TUNEIN!" webicon and click the right mouse button and click "Save Link As...", as described above.

===Play from an acquisition card===

This currently only possible on Linux and Windows. Open the File menu, and select "Open Capture Device..."

On Windows, supported cards include webcams, TV cards, acquisition cards... provided they come with directshow compatible drivers (Almost all acquisition cards do). You can choose the device to use for video and audio capture using the "Video device name" and "Audio device name" selectors. If your device doesn't appear in the list, try to select the "Refresh list" button. You can access the settings of your acquisition device by selecting the ''configure'' button. Options here depend on the driver of the device. You can select the "Device Proprieties" box if you want the configuration dialog box of every device to be displayed after having pressed the ''Ok'' button. Select the ''Tuner properties'' box to be prompted for tuner settings (PAL/NTSC standard, frequency...) for TV cards. The ''Advanced options...'' button allows to select some further settings useful in some rare cases, such as the chroma of the input (the way colors are encoded) and the size of the input buffer.

http://www.videolan.org/doc/play-howto/en/images/play-howto/intf-wx-open-capture.jpg The Open Capture device dialog and a device configuration windows- wxWidgets interface'''- needs verifying for 0.9'''

On Linux, supported cards include webcams, TV cards, acquisition cards, provided they are supported by the Video4Linux architecture. Haupaugge PVR 250/350 cards are also supported, using the [http://ivtv.sourceforge.net/ IVTV drivers].

*For Video4Linux devices, you can set the name of the video and audio devices using the "Video device name" and "Audio device name" text inputs. The "Advanced options..." button allows to select some further settings useful in some rare cases, such as the chroma of the input (the way colors are encoded) and the size of the input buffer.

http://www.videolan.org/doc/play-howto/en/images/play-howto/intf-wx-open-v4l.jpg The Open Video4Linux dialog- wxWidgets interface'''- needs verifying for 0.9'''

*To use a Hauppauge PVR card, select the PVR tab in the "Open" dialog box. Use the "Device" text input to set the device of the card you want to use. You can set the Norm of the tuner (PAL, SECAM or NTSC) by using the "Norm" Drop Down. The Frequency selector allows you to set the frequency of the tuner (in kHz), the bitrate selector to set the bitrate of the resulting encoded stream (in bit/s). The "Advanced Options button allows to set some more settings, such as the size of the encoded video (in pixels), its framerate (in frame per second), the interval between 2 key frames, etc.

After having set all the required parameters, you can start the capture by selecting the "Ok" button.

http://www.videolan.org/doc/play-howto/en/images/play-howto/intf-wx-open-pvr.jpg The Open PVR dialog- wxWidgets interface'''- needs verifying for 0.9'''

==Playlist==

VLC can store a list of files to play one after the other, using its playlist system. To access the playlist, click on the ''Playlist'' button in the main interface.

Each time you use the Open dialog box, the stream you select is appended at the end of the playlist and started.

The playlist window shows all the available streams. Double-click one to play it.

http://www.videolan.org/doc/play-howto/en/images/play-howto/intf-wx-playlist.jpg The Playlist - wxWidgets interface'''- needs updating for 0.9'''

http://www.videolan.org/doc/play-howto/en/images/play-howto/intf-osx-playlist.jpg The Playlist - MacOS X interface'''- needs verifying for 0.9'''

===Adding items, saving and loading playlists===

In the wxWidgets interface, the ''Manage'' menu allows you to append an item at the end of the playlist (it's playback doesn't start immediately), to save the playlist as an M3U or PLS file, or to import a playlist file.

In the MacOS X interface, saving a playlist can be done using the ''Save Playlist...'' function in the ''File'' menu. To import a playlist file, open it the same way as any other media file, using the ''Quick Open File...'' menu item.

===Sorting===

In the wxWidgets interface, ''Sort'' allows you to sort the playlist according to several criteria, or to shuffle it. You can also sort by clicking the header of the column.

In the MacOS X interface, sorting can be done by clicking the header of the column matching the criteria you want to use for sorting.

===Playlist modes===

The playlist supports several playback modes.

In the wxWidgets interface, the toolbar contains three playlist mode buttons. They allow to enable random mode, to repeat the whole playlist or to repeat one item.

In the MacOS X interface, random mode can be enabled by selecting the ''Random'' box. A drop down menu allows you to enable playlist and item repeat modes.

===Misc===

====Search====

You also have a search tool. Enter a search string and hit search. The next item to match the string will be highlighted. Keep hitting Search to cycle between all matching items.

====Moving items====

In the wxWidgets interface, the ''Up'' and ''Down'' buttons at the bottom of the playlist window allow you to move an item. Select an item and use these buttons to move it.

In the MacOS X interface, you can easily move an item with the mouse, using drag-and-drop.

====Contextual menu====

By right-clicking or control-clicking an item, a contextual menu will appear, giving access to a number of functions (for example, play the item, disable it, delete it, or get info on it).

If you ask for info, an ''item info'' dialog box will appear. This dialog box also allows you to change the name, the author and the location of the item to play.

http://www.videolan.org/doc/play-howto/en/images/play-howto/intf-wx-iteminfo.jpg Item Info Dialog - wx Interface'''- needs verifying for 0.9'''

http://www.videolan.org/doc/play-howto/en/images/play-howto/intf-osx-iteminfo.jpg Item Info Dialog - MacOS X interface'''- needs verifying for 0.9'''

==Subtitles==

VLC supports many kinds of subtitles.

===Media with included subtitles===

Many types of media can have embedded subtitles. VLC can read subtitles for the following media:
*DVD
*SVCD
*OGM files
*Matroska (MKV) files

Subtitles are disabled by default. To enable them, go to the ''Video'' menu, and to ''Subtitles track''. All available subtitles tracks will be listed. Select one to get the subtitles. Depending on the media, a description (language, for example) might be available for the track.

http://www.videolan.org/doc/play-howto/en/images/play-howto/intf-wx-select-sub.jpg Select a subtitles track under Windows or Linux'''- needs verifying for 0.9'''

http://www.videolan.org/doc/play-howto/en/images/play-howto/intf-osx-select-sub.jpg Select a subtitles track under MacOS X'''- needs verifying for 0.9'''

DVD and SVCD subtitles are merely images, so you won't be able to change anything for them. OGM and Matroska subtitles are rendered text, so you will be able to change several options.

Text rendering options can be changed in the Preferences. In the ''Modules'' section, ''text renderer'' subsection, open the ''freetype'' page. You can then set the font and its size. For the font, you have to select a font file. Under Windows, they can be found in ''C:\Windows\Fonts''. Under MacOS X, they are in ''/System/Library/Fonts''. Size can be set either relatively or as a number of pixels.

You need to restart your stream for the font modifications to take effect.

===Subtitles files===

While modern file formats like Matroska or OGM can handle subtitles directly, older formats like AVI can't. Therefore, a number of subtitles files formats have been created. You need two files: the
video file and the subtitles files that only contains the text of the subtitles and timestamps.

VLC can handle these types of subtitles files:
*MicroDVD
*SubRIP
*SubViewer
*SSA
*Sami
*Vobsub (this one is quite special: it is not made from text but from images, which means that you can't change the fonts)

To open a subtitles file, use the Advanced Open dialog box (Menu File, Open file). Select your file by clicking on the ''Browse'' button. Then, check the ''Subtitle options'' checkbox and click on the Settings button.

http://www.videolan.org/doc/play-howto/en/images/play-howto/intf-wx-sub-file.jpg Select a subtitles file under Windows or Linux'''- needs verifying for 0.9'''

You can then select the subtitles file by clicking the ''Browse'' button. You can also set a few options like character encoding, alignment and size. The delay option allows you to delay the subtitles against the video if they are not in sync. If they are not at the same speed, you might also want to adjust the subtitles framerate.

Note: For Vobsub subtitles, you need to select the '''.idx''' file, not the '''.sub''' file.
Encoding, alignment and size won't have any effect for Vobsub subtitles.

Font can be changed as explained in the previous section.

==Video and audio filters==

VLC includes a system of ''filters'' that allow you to modify the audio and video.

===Deinterlacement and Post Processing===

VLC is able to deinterlace a video stream using different deinterlacement methods. Deinterlacement can be enabled in the ''Video'' menu, ''Deinterlacement'' menu item. The ''Blend'' methods gives the best results in most cases. The ''discard''method is a less resource consuming alternative.

On some particular streams (MPEG 4, DIVX, XVID, Sorenson, etc.), some additional image filtering can be applied to the video before display, improving its quality in some cases. This can be enabled in the ''Video'' menu, ''Post processing'' menu item. Different levels of post processing can be chosen here. A higher level means more filtering.

===Video filters===

VLC features several filters able to change the video (distortion, brightness adjustment, motion blurring, etc.).

With the wxWidgets interface, filters can be easily enabled using the Extended GUI. In the Video tab, simply select the filters to enable. Image settings can be easily adjusted.

http://www.videolan.org/doc/play-howto/en/images/play-howto/intf-wx-vfilters.jpg Video filters selection in the wxWidgets interface'''- needs verifying for 0.9'''

You can enable these filters through the ''Extended Controls panel'' on Mac OS X. Click on the triangle next to ''Video filters'' to select your filters or expand the ''Adjust Image'' section to change the contrast, hue, etc.

http://www.videolan.org/doc/play-howto/en/images/play-howto/intf-osx-vfilters.jpg Video filters selection in the Mac OS X interface'''- needs verifying for 0.9'''

For better control, you need to go to the preferences. To select the filters to be enabled, go to ''Video'', then to ''Filters''. In the "video filter module" box, enter the names of the filters to enable, separated by semicommas. Filters will be applied in the selected order. Valid names are "clone", "wall", "transform", "adjust", "crop", "deinterlace", "distort", "motionblur" and "logo".

If you want to tune the behavior of these filters, go to ''Video, Filters, [your filter]''. For each filter, you will find a short description and the options.

===Audio filters===

====Equalizer====

VLC features a 10-band graphical equalizer. You can display it by activating the advanced GUI on wxWidgets or by clicking the ''Equalizer'' button on the MacOS X interface.

http://www.videolan.org/doc/play-howto/en/images/play-howto/intf-wx-equalizer.jpg The equalizer in the wxWidgets interface'''- needs verifying for 0.9'''

http://www.videolan.org/doc/play-howto/en/images/play-howto/intf-osx-equalizer.jpg The equalizer in the MacOS X interface'''- needs verifying for 0.9'''

Presets are available in the Audio menu in wxWidgets, or in the Equalizer window in the MacOS X interface.

====Other audio filters====

At the moment, VLC features two other audio filters: a volume normalizer and a filter providing sound spatialization with a headphone. They can be enabled in the Audio tab of the extended GUI for the wxWidgets interface and in the Audio section of the Extended Controls panel of the Mac OS X interface.

For better control, you need to go to the preferences. To select the filters to be enabled, go to ''Audio'', then to ''Filters''. In the "audio filters" box, enter the names of the filters to enable, separated by commas. Valid names are "equalizer", "normvol" and "headphone".

If you want to tune the behavior of these filters, go to ''Audio, Filters, [your filter]''. The equalizer and headphone filters can be tuned.

==Snapshots (aka, screenshots)==
There are two ways to take snapshots (i.e., screenshots or frame grabs) with VLC:
#Go to Video -> Snapshot, or
#Press the snapshot hotkey
#*Windows / Linux / Unix: Ctrl-Alt-s
#*Mac OS X: Command-Alt-s

When a snapshot is taken, it will briefly preview as a thumbnail with its filename and then fade away.

To change the hotkey, go to Preferences -> Interface -> Hotkeys settings. Check Advanced options, and set Take video snapshot.

===Snapshot location, format and name===
The snapshot location depends upon your operating system:
*Windows: My Documents\My Pictures\
*Linux / Unix: $(HOME)/.vlc/
*Mac OS X: Desktop/

The default format for snapshots is PNG, but this may be changed to JPEG. Also, the default name for snapshots is ''vlcsnap-'' followed by a timestamp that is ''not'' the time of the frame in the video you're viewing.

The location, format and name of snapshots may be changed in the Preferences. Also, you may substitute other text for ''vlcsnap-'' in the ''Video snapshot file prefix'' and you may choose to have snapshots numbered sequentially (i.e., 000001, 000002, 000003, and so on) instead of with a timestamp. As of version 0.9.0, you may even use [[Documentation:Play HowTo/Format String|variables]] in the text used for the filename. For example, ''$T'' (must be upper case) will insert the video's time code into the file name. If you were to change the prefix to ''Friends-$T-'' while watching a DVD of ''Friends'', then the snapshot filenames would look something like this: Friends-00_05_21-00004.png . This indicates a snapshot taken at 5 minutes and 21 seconds into the video; and it was the number 00004 snapshot of the day.

For a full list of variables, please see [[Documentation:Play HowTo/Format String]].

==Hotkeys==
:''See also: [[QtHotkeys]], [[HotKeys]], [[How to set global hotkeys]].''
Most of VLC functions are accessible using hotkeys.

The list of the available hotkeys and their functions can be retrieved and altered in the preferences panel of the player. In the wxWidgets interface, preferences are available in the "Settings" menu, "Preferences" menu item. In the MacOS X interface, open the "VLC" menu, and select "Preferences". Select the "Hot keys" panel in the dialog.

As of version 0.9, a list of hotkeys is presented in a drop-down window. To change one, double-click its name to select it. Then, press the new key that will trigger the specified action. Modifier keys (such as Control/Command and Alt) may also be used.

In earlier versions, several boxes give the list of modifiers for the hotkey. To trigger an action using a hotkey, you need to press simultaneously the keys corresponding to the different selected modifiers as well as the key set in the dropdown.

To change the binding of a hotkey, select or deselect boxes corresponding to the different modifiers, and change the key by using the drop-down menu. Select the ''Save'' button to apply the changes.

http://www.videolan.org/doc/play-howto/en/images/play-howto/intf-wx-hotkeys.jpg The Hotkeys Panel - wxWidgets interface'''- needs verifying for 0.9'''

http://www.videolan.org/doc/play-howto/en/images/play-howto/intf-osx-hotkeys.jpg The Hotkeys Panel - MacOS X interface'''- needs verifying for 0.9'''

==Basic troubleshooting==

===File does not play, only sound or only video===

Maybe the file you are trying to read is not fully supported. VLC does not use the codec packs (the software that decodes video signals) you might have installed. It comes with its own codecs. If there is no open-source decoder for the format you are trying to read, it won't be supported. (There is an exception, under Windows, for codecs that use the DirectShow framework.)

To find out, open the Messages Window (View menu) and restart your stream. Look for error messages (red messages)

http://www.videolan.org/doc/play-howto/en/images/play-howto/intf-wx-messages.jpg The wxWidgets messages window'''- needs verifying for 0.9'''

In this example, the file contains a IV41 video stream, a codec that is not supported by VLC.

You may of course have other messages. If you post to a VideoLAN mailing list or in the forum, please include such a log. It is very valuable in troubleshooting.

===Weird VLC behavior and crashes===

A very common thing is a corrupted VLC preferences file. Don't hesitate to delete it if problems appear suddenly. You will find in the FAQ details on [http://www.videolan.org/doc/faq/en/index.html#id2470084 how to delete your preferences file].

===Computer crashes / Video is corrupted===

Another common problem is buggy video drivers. Try upgrading them from the website of your video card's manufacturer.

Also, you can try disabling Overlay (Preferences/General/Video, untick "Overlay video output")

{{Documentation}}

Documentation:VLC for dummies

2010-08-21T23:59:54Z

Popol0909: /* See also */ Added links

Windows

2010-08-21T23:53:49Z

Popol0909: Added info about VLC portable version

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 Up/Down 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 "File 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" />
 
<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" />
 
<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: 
http://portableapps.com/apps/music_video/vlc_portable

[[Category:Operating systems]]

Windows

2010-08-21T23:46:15Z

Popol0909: /* Keyboard shortcuts in the Windows (directx) video output */ Added link

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 Up/Down 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 "File 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" />
 
<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" />
 
<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]]

QtHotkeys

2010-08-21T23:43:21Z

Popol0909: /* See also */ Added link

QtHotkeys

2010-08-21T23:42:54Z

Popol0909: /* See also */ Added link

VLC HowTo/Global hotkeys

2010-08-21T23:39:25Z

Popol0909: Added category

VLC Global Hotkeys are shortcuts you can use even if VLC does not have the focus. Here is how to configure Global Hotkeys:

*Tools, Preferences, HotKeys.
*Under the '''Global''' column, double-click the value corresponding to the function you want a global key assigned to.
*Press the key or key combination you want
*Click Apply
*Click Save

You will have to quit and restart VLC for the new assignments to be effective.

== See also ==
*[[QtHotkeys]]
*[[HotKeys]]

[[Category:Interfaces]]

Hotkeys table

2010-08-21T23:39:03Z

Popol0909: Style

{|
! Command !! Code !! Hotkey
|-
| Fullscreen || key-toggle-fullscreen || f
|-
| Leave fullscreen || key-leave-fullscreen || Esc
|-
| Play/Pause || key-play-pause || Space
|-
| Pause only || key-pause || Unset
|-
| Play only || key-play || Unset
|-
| Faster || key-faster || +
|-
| Slower || key-slower || -
|-
| Normal rate || key-rate-normal || =
|-
| Faster (fine) || key-rate-faster-fine || ]
|-
| Slower (fine) || key-rate-slower-fine || [
|-
| Next || key-next || n
|-
| Previous || key-prev || p
|-
| Stop || key-stop || s
|-
| Position || key-position || t
|-
| Very short backwards jump || key-jump-extrashort || Shift-Left
|-
| Very short forward jump || key-jump+extrashort || Shift-Right
|-
| Short backwards jump || key-jump-short || Alt-Left
|-
| Short forward jump || key-jump+short || Alt-Right
|-
| Medium backwards jump || key-jump-medium || Ctrl-Left
|-
| Medium forward jump || key-jump+medium || Ctrl-Right
|-
| Long backwards jump || key-jump-long || Alt-Ctrl-Left
|-
| Long forward jump || key-jump+long || Alt-Ctrl-Right
|-
| Next frame || key-frame-next || e
|-
| Activate || key-nav-activate || Enter
|-
| Navigate up || key-nav-up || Up
|-
| Navigate down || key-nav-down || Down
|-
| Navigate left || key-nav-left || Left
|-
| Navigate right || key-nav-right || Right
|-
| Go to the DVD menu || key-disc-menu || Shift-m
|-
| Select previous DVD title || key-title-prev || Shift-o
|-
| Select next DVD title || key-title-next || Shift-b
|-
| Select prev DVD chapter || key-chapter-prev || Shift-p
|-
| Select next DVD chapter || key-chapter-next || Shift-n
|-
| Quit || key-quit || Ctrl-q
|-
| Volume up || key-vol-up || Ctrl-Up
|-
| Volume down || key-vol-down || Ctrl-Down
|-
| Mute || key-vol-mute || m
|-
| Subtitle delay up || key-subdelay-up || h
|-
| Subtitle delay down || key-subdelay-down || g
|-
| Audio delay up || key-audiodelay-up || k
|-
| Audio delay down || key-audiodelay-down || j
|-
| Cycle audio track || key-audio-track || b
|-
| Cycle through audio devices || key-audiodevice-cycle || Shift-a
|-
| Cycle subtitle track || key-subtitle-track || v
|-
| Cycle source aspect ratio || key-aspect-ratio || a
|-
| Cycle video crop || key-crop || c
|-
| Toggle autoscaling || key-toggle-autoscale || o
|-
| Increase scale factor || key-incr-scalefactor || Alt-o
|-
| Decrease scale factor || key-decr-scalefactor || Alt-Shift-o
|-
| Cycle deinterlace modes || key-deinterlace || d
|-
| Show interface || key-intf-show || i
|-
| Hide interface || key-intf-hide || Shift-i
|-
| Take video snapshot || key-snapshot || Shift-s
|-
| Go back in browsing history || key-history-back || Shift-g
|-
| Go forward in browsing history || key-history-forward || Shift-h
|-
| Record || key-record || Shift-r
|-
| Dump || key-dump || Shift-d
|-
| Zoom || key-zoom || z
|-
| Un-Zoom || key-unzoom || Shift-z
|-
| Toggle wallpaper mode || key-wallpaper || w
|-
| Display OSD menu on top || key-menu-on || Alt-Shift-m
|-
| Do not display OSD menu || key-menu-off || Alt-Ctrl-m
|-
| Highlight widget on the right || key-menu-right || Alt-Shift-Right
|-
| Highlight widget on the left || key-menu-left || Alt-Shift-Left
|-
| Highlight widget on top || key-menu-up || Alt-Shift-Up
|-
| Highlight widget below || key-menu-down || Alt-Shift-Down
|-
| Select current widget || key-menu-select || Alt-Shift-Enter
|-
| Crop one pixel from the top || key-crop-top || Alt-r
|-
| Uncrop one pixel from the top || key-uncrop-top || Alt-Shift-r
|-
| Crop one pixel from the left || key-crop-left || Alt-d
|-
| Uncrop one pixel from the left || key-uncrop-left || Alt-Shift-d
|-
| Crop one pixel from the bottom || key-crop-bottom || Alt-c
|-
| Uncrop one pixel from the bottom || key-uncrop-bottom || Alt-Shift-c
|-
| Crop one pixel from the right || key-crop-right || Alt-f
|-
| Uncrop one pixel from the right || key-uncrop-right || Alt-Shift-f
|-
| Random || key-random || r
|-
| Normal/Repeat/Loop || key-loop || l
|-
| 1:4 Quarter || key-zoom-quarter || Ctrl-1
|-
| 1:2 Half || key-zoom-half || Ctrl-2
|-
| 1:1 Original || key-zoom-original || Ctrl-3
|-
| 2:1 Double || key-zoom-double || Ctrl-4
|-
| Very short jump length (integer) || extrashort-jump-size || 3
|-
| Set playlist bookmark 1 || key-set-bookmark1 || Ctrl-F1
|-
| Set playlist bookmark 2 || key-set-bookmark2 || Ctrl-F2
|-
| Set playlist bookmark 3 || key-set-bookmark3 || Ctrl-F3
|-
| Set playlist bookmark 4 || key-set-bookmark4 || Ctrl-F4
|-
| Set playlist bookmark 5 || key-set-bookmark5 || Ctrl-F5
|-
| Set playlist bookmark 6 || key-set-bookmark6 || Ctrl-F6
|-
| Set playlist bookmark 7 || key-set-bookmark7 || Ctrl-F7
|-
| Set playlist bookmark 8 || key-set-bookmark8 || Ctrl-F8
|-
| Set playlist bookmark 9 || key-set-bookmark9 || Ctrl-F9
|-
| Set playlist bookmark 10 || key-set-bookmark10 || Ctrl-F10
|-
| Play playlist bookmark 1 || key-play-bookmark1 || F1
|-
| Play playlist bookmark 2 || key-play-bookmark2 || F2
|-
| Play playlist bookmark 3 || key-play-bookmark3 || F3
|-
| Play playlist bookmark 4 || key-play-bookmark4 || F4
|-
| Play playlist bookmark 5 || key-play-bookmark5 || F5
|-
| Play playlist bookmark 6 || key-play-bookmark6 || F6
|-
| Play playlist bookmark 7 || key-play-bookmark7 || F7
|-
| Play playlist bookmark 8 || key-play-bookmark8 || F8
|-
| Play playlist bookmark 9 || key-play-bookmark9 || F9
|-
| Play playlist bookmark 10 || key-play-bookmark10 || F10
|}

== See also ==
*[[How to set global hotkeys]]
*[[QtHotkeys]]

[[Category:Interfaces]]

Hotkeys table

2010-08-21T23:38:30Z

Popol0909: Added links

{|
! Command !! Code !! Hotkey
|-
| Fullscreen || key-toggle-fullscreen || f
|-
| Leave fullscreen || key-leave-fullscreen || Esc
|-
| Play/Pause || key-play-pause || Space
|-
| Pause only || key-pause || Unset
|-
| Play only || key-play || Unset
|-
| Faster || key-faster || +
|-
| Slower || key-slower || -
|-
| Normal rate || key-rate-normal || =
|-
| Faster (fine) || key-rate-faster-fine || ]
|-
| Slower (fine) || key-rate-slower-fine || [
|-
| Next || key-next || n
|-
| Previous || key-prev || p
|-
| Stop || key-stop || s
|-
| Position || key-position || t
|-
| Very short backwards jump || key-jump-extrashort || Shift-Left
|-
| Very short forward jump || key-jump+extrashort || Shift-Right
|-
| Short backwards jump || key-jump-short || Alt-Left
|-
| Short forward jump || key-jump+short || Alt-Right
|-
| Medium backwards jump || key-jump-medium || Ctrl-Left
|-
| Medium forward jump || key-jump+medium || Ctrl-Right
|-
| Long backwards jump || key-jump-long || Alt-Ctrl-Left
|-
| Long forward jump || key-jump+long || Alt-Ctrl-Right
|-
| Next frame || key-frame-next || e
|-
| Activate || key-nav-activate || Enter
|-
| Navigate up || key-nav-up || Up
|-
| Navigate down || key-nav-down || Down
|-
| Navigate left || key-nav-left || Left
|-
| Navigate right || key-nav-right || Right
|-
| Go to the DVD menu || key-disc-menu || Shift-m
|-
| Select previous DVD title || key-title-prev || Shift-o
|-
| Select next DVD title || key-title-next || Shift-b
|-
| Select prev DVD chapter || key-chapter-prev || Shift-p
|-
| Select next DVD chapter || key-chapter-next || Shift-n
|-
| Quit || key-quit || Ctrl-q
|-
| Volume up || key-vol-up || Ctrl-Up
|-
| Volume down || key-vol-down || Ctrl-Down
|-
| Mute || key-vol-mute || m
|-
| Subtitle delay up || key-subdelay-up || h
|-
| Subtitle delay down || key-subdelay-down || g
|-
| Audio delay up || key-audiodelay-up || k
|-
| Audio delay down || key-audiodelay-down || j
|-
| Cycle audio track || key-audio-track || b
|-
| Cycle through audio devices || key-audiodevice-cycle || Shift-a
|-
| Cycle subtitle track || key-subtitle-track || v
|-
| Cycle source aspect ratio || key-aspect-ratio || a
|-
| Cycle video crop || key-crop || c
|-
| Toggle autoscaling || key-toggle-autoscale || o
|-
| Increase scale factor || key-incr-scalefactor || Alt-o
|-
| Decrease scale factor || key-decr-scalefactor || Alt-Shift-o
|-
| Cycle deinterlace modes || key-deinterlace || d
|-
| Show interface || key-intf-show || i
|-
| Hide interface || key-intf-hide || Shift-i
|-
| Take video snapshot || key-snapshot || Shift-s
|-
| Go back in browsing history || key-history-back || Shift-g
|-
| Go forward in browsing history || key-history-forward || Shift-h
|-
| Record || key-record || Shift-r
|-
| Dump || key-dump || Shift-d
|-
| Zoom || key-zoom || z
|-
| Un-Zoom || key-unzoom || Shift-z
|-
| Toggle wallpaper mode || key-wallpaper || w
|-
| Display OSD menu on top || key-menu-on || Alt-Shift-m
|-
| Do not display OSD menu || key-menu-off || Alt-Ctrl-m
|-
| Highlight widget on the right || key-menu-right || Alt-Shift-Right
|-
| Highlight widget on the left || key-menu-left || Alt-Shift-Left
|-
| Highlight widget on top || key-menu-up || Alt-Shift-Up
|-
| Highlight widget below || key-menu-down || Alt-Shift-Down
|-
| Select current widget || key-menu-select || Alt-Shift-Enter
|-
| Crop one pixel from the top || key-crop-top || Alt-r
|-
| Uncrop one pixel from the top || key-uncrop-top || Alt-Shift-r
|-
| Crop one pixel from the left || key-crop-left || Alt-d
|-
| Uncrop one pixel from the left || key-uncrop-left || Alt-Shift-d
|-
| Crop one pixel from the bottom || key-crop-bottom || Alt-c
|-
| Uncrop one pixel from the bottom || key-uncrop-bottom || Alt-Shift-c
|-
| Crop one pixel from the right || key-crop-right || Alt-f
|-
| Uncrop one pixel from the right || key-uncrop-right || Alt-Shift-f
|-
| Random || key-random || r
|-
| Normal/Repeat/Loop || key-loop || l
|-
| 1:4 Quarter || key-zoom-quarter || Ctrl-1
|-
| 1:2 Half || key-zoom-half || Ctrl-2
|-
| 1:1 Original || key-zoom-original || Ctrl-3
|-
| 2:1 Double || key-zoom-double || Ctrl-4
|-
| Very short jump length (integer) || extrashort-jump-size || 3
|-
| Set playlist bookmark 1 || key-set-bookmark1 || Ctrl-F1
|-
| Set playlist bookmark 2 || key-set-bookmark2 || Ctrl-F2
|-
| Set playlist bookmark 3 || key-set-bookmark3 || Ctrl-F3
|-
| Set playlist bookmark 4 || key-set-bookmark4 || Ctrl-F4
|-
| Set playlist bookmark 5 || key-set-bookmark5 || Ctrl-F5
|-
| Set playlist bookmark 6 || key-set-bookmark6 || Ctrl-F6
|-
| Set playlist bookmark 7 || key-set-bookmark7 || Ctrl-F7
|-
| Set playlist bookmark 8 || key-set-bookmark8 || Ctrl-F8
|-
| Set playlist bookmark 9 || key-set-bookmark9 || Ctrl-F9
|-
| Set playlist bookmark 10 || key-set-bookmark10 || Ctrl-F10
|-
| Play playlist bookmark 1 || key-play-bookmark1 || F1
|-
| Play playlist bookmark 2 || key-play-bookmark2 || F2
|-
| Play playlist bookmark 3 || key-play-bookmark3 || F3
|-
| Play playlist bookmark 4 || key-play-bookmark4 || F4
|-
| Play playlist bookmark 5 || key-play-bookmark5 || F5
|-
| Play playlist bookmark 6 || key-play-bookmark6 || F6
|-
| Play playlist bookmark 7 || key-play-bookmark7 || F7
|-
| Play playlist bookmark 8 || key-play-bookmark8 || F8
|-
| Play playlist bookmark 9 || key-play-bookmark9 || F9
|-
| Play playlist bookmark 10 || key-play-bookmark10 || F10
|}

See also:
*[[How to set global hotkeys]]
*[[QtHotkeys]]

[[Category:Interfaces]]

QtHotkeys

2010-08-21T23:36:54Z

Popol0909: Added links

VLC HowTo/Global hotkeys

2010-08-21T23:35:57Z

Popol0909: Created page with 'VLC Global Hotkeys are shortcuts you can use even if VLC does not have the focus. Here is how to configure Global Hotkeys: *Tools, Preferences, HotKeys. *Under the '''Global'''…'

Hotkeys table

2010-08-21T23:25:03Z

Popol0909: Subtitle no longer needed.

HotKeys

2010-08-21T23:23:46Z

Popol0909: moved HotKeys to Hotkeys table: A Hotkeys (with a small "k" already exists).

#REDIRECT [[Hotkeys table]]

Hotkeys table

2010-08-21T23:23:45Z

Popol0909: moved HotKeys to Hotkeys table: A Hotkeys (with a small "k" already exists).

== Hotkeys table ==

{|
! Command !! Code !! Hotkey
|-
| Fullscreen || key-toggle-fullscreen || f
|-
| Leave fullscreen || key-leave-fullscreen || Esc
|-
| Play/Pause || key-play-pause || Space
|-
| Pause only || key-pause || Unset
|-
| Play only || key-play || Unset
|-
| Faster || key-faster || +
|-
| Slower || key-slower || -
|-
| Normal rate || key-rate-normal || =
|-
| Faster (fine) || key-rate-faster-fine || ]
|-
| Slower (fine) || key-rate-slower-fine || [
|-
| Next || key-next || n
|-
| Previous || key-prev || p
|-
| Stop || key-stop || s
|-
| Position || key-position || t
|-
| Very short backwards jump || key-jump-extrashort || Shift-Left
|-
| Very short forward jump || key-jump+extrashort || Shift-Right
|-
| Short backwards jump || key-jump-short || Alt-Left
|-
| Short forward jump || key-jump+short || Alt-Right
|-
| Medium backwards jump || key-jump-medium || Ctrl-Left
|-
| Medium forward jump || key-jump+medium || Ctrl-Right
|-
| Long backwards jump || key-jump-long || Alt-Ctrl-Left
|-
| Long forward jump || key-jump+long || Alt-Ctrl-Right
|-
| Next frame || key-frame-next || e
|-
| Activate || key-nav-activate || Enter
|-
| Navigate up || key-nav-up || Up
|-
| Navigate down || key-nav-down || Down
|-
| Navigate left || key-nav-left || Left
|-
| Navigate right || key-nav-right || Right
|-
| Go to the DVD menu || key-disc-menu || Shift-m
|-
| Select previous DVD title || key-title-prev || Shift-o
|-
| Select next DVD title || key-title-next || Shift-b
|-
| Select prev DVD chapter || key-chapter-prev || Shift-p
|-
| Select next DVD chapter || key-chapter-next || Shift-n
|-
| Quit || key-quit || Ctrl-q
|-
| Volume up || key-vol-up || Ctrl-Up
|-
| Volume down || key-vol-down || Ctrl-Down
|-
| Mute || key-vol-mute || m
|-
| Subtitle delay up || key-subdelay-up || h
|-
| Subtitle delay down || key-subdelay-down || g
|-
| Audio delay up || key-audiodelay-up || k
|-
| Audio delay down || key-audiodelay-down || j
|-
| Cycle audio track || key-audio-track || b
|-
| Cycle through audio devices || key-audiodevice-cycle || Shift-a
|-
| Cycle subtitle track || key-subtitle-track || v
|-
| Cycle source aspect ratio || key-aspect-ratio || a
|-
| Cycle video crop || key-crop || c
|-
| Toggle autoscaling || key-toggle-autoscale || o
|-
| Increase scale factor || key-incr-scalefactor || Alt-o
|-
| Decrease scale factor || key-decr-scalefactor || Alt-Shift-o
|-
| Cycle deinterlace modes || key-deinterlace || d
|-
| Show interface || key-intf-show || i
|-
| Hide interface || key-intf-hide || Shift-i
|-
| Take video snapshot || key-snapshot || Shift-s
|-
| Go back in browsing history || key-history-back || Shift-g
|-
| Go forward in browsing history || key-history-forward || Shift-h
|-
| Record || key-record || Shift-r
|-
| Dump || key-dump || Shift-d
|-
| Zoom || key-zoom || z
|-
| Un-Zoom || key-unzoom || Shift-z
|-
| Toggle wallpaper mode || key-wallpaper || w
|-
| Display OSD menu on top || key-menu-on || Alt-Shift-m
|-
| Do not display OSD menu || key-menu-off || Alt-Ctrl-m
|-
| Highlight widget on the right || key-menu-right || Alt-Shift-Right
|-
| Highlight widget on the left || key-menu-left || Alt-Shift-Left
|-
| Highlight widget on top || key-menu-up || Alt-Shift-Up
|-
| Highlight widget below || key-menu-down || Alt-Shift-Down
|-
| Select current widget || key-menu-select || Alt-Shift-Enter
|-
| Crop one pixel from the top || key-crop-top || Alt-r
|-
| Uncrop one pixel from the top || key-uncrop-top || Alt-Shift-r
|-
| Crop one pixel from the left || key-crop-left || Alt-d
|-
| Uncrop one pixel from the left || key-uncrop-left || Alt-Shift-d
|-
| Crop one pixel from the bottom || key-crop-bottom || Alt-c
|-
| Uncrop one pixel from the bottom || key-uncrop-bottom || Alt-Shift-c
|-
| Crop one pixel from the right || key-crop-right || Alt-f
|-
| Uncrop one pixel from the right || key-uncrop-right || Alt-Shift-f
|-
| Random || key-random || r
|-
| Normal/Repeat/Loop || key-loop || l
|-
| 1:4 Quarter || key-zoom-quarter || Ctrl-1
|-
| 1:2 Half || key-zoom-half || Ctrl-2
|-
| 1:1 Original || key-zoom-original || Ctrl-3
|-
| 2:1 Double || key-zoom-double || Ctrl-4
|-
| Very short jump length (integer) || extrashort-jump-size || 3
|-
| Set playlist bookmark 1 || key-set-bookmark1 || Ctrl-F1
|-
| Set playlist bookmark 2 || key-set-bookmark2 || Ctrl-F2
|-
| Set playlist bookmark 3 || key-set-bookmark3 || Ctrl-F3
|-
| Set playlist bookmark 4 || key-set-bookmark4 || Ctrl-F4
|-
| Set playlist bookmark 5 || key-set-bookmark5 || Ctrl-F5
|-
| Set playlist bookmark 6 || key-set-bookmark6 || Ctrl-F6
|-
| Set playlist bookmark 7 || key-set-bookmark7 || Ctrl-F7
|-
| Set playlist bookmark 8 || key-set-bookmark8 || Ctrl-F8
|-
| Set playlist bookmark 9 || key-set-bookmark9 || Ctrl-F9
|-
| Set playlist bookmark 10 || key-set-bookmark10 || Ctrl-F10
|-
| Play playlist bookmark 1 || key-play-bookmark1 || F1
|-
| Play playlist bookmark 2 || key-play-bookmark2 || F2
|-
| Play playlist bookmark 3 || key-play-bookmark3 || F3
|-
| Play playlist bookmark 4 || key-play-bookmark4 || F4
|-
| Play playlist bookmark 5 || key-play-bookmark5 || F5
|-
| Play playlist bookmark 6 || key-play-bookmark6 || F6
|-
| Play playlist bookmark 7 || key-play-bookmark7 || F7
|-
| Play playlist bookmark 8 || key-play-bookmark8 || F8
|-
| Play playlist bookmark 9 || key-play-bookmark9 || F9
|-
| Play playlist bookmark 10 || key-play-bookmark10 || F10
|}

[[Category:Interfaces]]

User talk:J-b

2010-08-21T15:36:26Z

Popol0909: /* Spam account */ new section

==TODO==
.tooney zone
''Please give me some TODOs here''

''Give your name and don't delete anything''
* Qt4 - jb
* Qt4 contribs - Xtophe
* Branch nightlies - Xtophe
* World domination

==Talk Here==

Hi jibbynou, I've just resuscitated the [[Frequently Asked Questions]] (formerly [[FAQ]]). I don't know if/where you want to link it from: up to you :-) -- [[User:Yoann|Yoann]] 19:44, 1 March 2007 (CET)

Plop jibbynou, you can now use <nowiki>{{RightMenu|documentation toc}}</nowiki>. See [[Template:RightMenu]] and [[Template:Documentation_toc]]. -- [[User:Yoann|Yoann]] 18:27, 21 May 2007 (CEST)

== Win32 V. 0.8.6i Crash On Snapshot! ==

As of 8//8/08 I have discovered what looks like a bug inside of 0.8.6i when trying to right click and choose snapshot from the playing video. It crashed the application, and bogs down windows. This happened on windows XP Home sp2, Intel p4 2.53GHz 1GB ram. All updates on machine are current, and it also has the latest quicktime, windows media player, and winamp installed.

-Sincerely
AfterBurn
: this was fixed in updated binary.

== Win32 Contribs 20070220 ==

There is some missing reference to gsm_ms_encoder and gsm_ms_decoder. I have tried to compile the libgsm, but there is no such method. Could you provide this library or give a hint, where to find it?
Besides when using your contrib some libraries need to be put in some directory named /home/videolan/j-b..... (sorry, I don't remember the path exactly (not sitting in front of the machine where I used your contrib - I will look it up on Sunday). Why does the vlc bootstrap/configure/compile reference this path which looks like it is your build path?

Thx in advance for answering my questions and keep up the good work!

:Well, this contrib may be broken because of the support and non-support of GSM in ffmpeg. This should be changed. Use another (older contrib), and I should do a new one in a few days.
::Thanks very much. I have now just added pseudo-methods for these two missing methods and it worked for me. --[[User:Hxp|Hxp]] 14:36, 14 March 2007 (CET)

== ALERT!!! PEOPLE CHARGING FOR VLC PLAYER!!!!! ==

If you download VLC player at this link http://www.vlc-mediaplayer.info/uk/ it will try to charge you £2 (via SMS) to install.
: Fixed.

== Thanks for the welcome ==

Thanks for the welcome message, Jean-Baptiste.

I've already made one suggestion [[Documentation Talk:EditingGuidelines|over here]].

As I get to know VLC, I'll try to make more contributions to the documentation wiki. I've also run a MediaWiki-based wiki for a couple of years:

http://www.screenpedia.org

But I wouldn't call myself a ''professional'' wiki admin!

Regards,

--[[User:Jeremy Butler|Jeremy Butler]] 18:12, 9 July 2007 (CEST)

== MacOS wiki ==

No probs J-b. Je vais faire ca que je pouvais, et que je comprends ! [[User:Facius|Facius]] 14:39, 8 October 2007 (CEST)

Deux petits questions:

Est-ce que mon idee de stocker les images hors du wiki reste bien ?

Est-ce q'on sais pourquoi le Template Ed n'est pas present ? [[User:Facius|Facius]] 14:42, 8 October 2007 (CEST)

: Il faut réactiver les images alors. Je vais le faire. [[User:J-b|jb]] 18:34, 9 October 2007 (CEST)
: Ed ? waht's that ?

== Bureaucrat ==

Hi, could I be a bureaucrat? I'm already a sysop, and I'll feel complete if I'm a bureaucrat. (Even though I'll probably never make anyone a sysop) [[User:The thing|The thing]] ([[User talk:The thing|Talk]] • [[Special:Contributions/The thing|Contribs]]) 21:13, 8 August 2008 (CEST)
: Done [[User:J-b|jb]] 19:51, 18 August 2008 (CEST)

== Error in article ==

Hi,
I'm using your guide to compile VLC ([[User:J-b#My_VLC]]) under Ubuntu 8.10 but is outdated: 
"''configure: WARNING: --with-ffmpeg-tree is deprecated. Use PKG_CONFIG_PATH instead.''" 
And, therefore, an error occurs when it tries to compile ''libavcodec'': 
"''checking for AVCODEC... no 
configure: error: Could not find libavcodec or libavutil. Use --disable-avcodec to ignore this error.''" 
It would be better to delete that wiki page or update it. 
Thank you anyway for your effort and work. 
A greeting.

----

'''Add''': 
Missing an important parameter in the config of ffmpeg: --enable-postproc

The name of postproc is different in ffmpeg svn version over the name that looks VLC (¿?): 
''VLC'': 
checking for POSTPROC... yes 
checking libpostproc/postproc.h usability... no 
checking libpostproc/postproc.h presence... no 
checking for libpostproc/postproc.h... no 
checking postproc/postprocess.h usability... no 
checking postproc/postprocess.h presence... no 
checking for postproc/postprocess.h... no 

<s>Solution: 
The real path/name in ffmpeg svn version is libpostproc/postprocess.h. 
The temporal solution is change the name to the file ''postprocess.h'' > ''postproc.h''

These options no longer exist:'' --with-ffmpeg-mp3lame --with-ffmpeg-faac''

For some reason I do not understand, VLC does not recognize x264 as compiled... 
Solution: 
This solves both the problem of x264 as of ffmpeg libraries: 
export PKG_CONFIG_PATH=extras/ffmpeg/libavcodec:extras/ffmpeg/libavdevice:extras/ffmpeg/libavformat:extras/ffmpeg/libavutil:extras/ffmpeg''/libswscale:extras/ffmpeg/libpostproc:extras/x264:/usr/lib/pkgconfig;./configure --prefix=/usr --enable-snapshot --enable-dbus-control --enable-musicbrainz --enable-shared-libvlc --enable-mozilla --enable-lirc --enable-live555 --with-live555-tree=extras/live --enable-x264 --enable-shout --enable-taglib --enable-v4l --enable-cddax --enable-dvb --enable-vcdx --enable-realrtsp --enable-xvmc --enable-svg --enable-dvdread --enable-dv --enable-theora --enable-faad --enable-twolame --enable-real --enable-flac --enable-tremor --enable-dirac --enable-skins2 --enable-qt4 --enable-aa --enable-caca --enable-esd --enable-portaudio --enable-jack --enable-xosd --enable-galaktos --enable-goom --enable-ggi --disable-cddax --disable-vcdx --enable-mkv --enable-dca --disable-qt --disable-kde --enable-a52 --enable-xvideo --disable-fribidi....''

Obviously, some parameters that I put into this config can (and should) change depending on the needs of each.</s>

----
Edits: 
There is a bug in the code of VLC that does not link the code of ffmpeg correctly.

: The solution is on my blog. [[User:J-b|jb]] 12:15, 30 December 2008 (CET)

== Websites' Status ==

Hello, I was just wondering if you were contemplating an upgrade of this wiki to MediaWiki 1.14 as I noticed that you are still on 1.11 which seems rather counterproductive.

I was also wondering if you had considered using [http://www.mediawiki.org/wiki/Extension:PHPBB/Users_Integration Extension:PHPBB] from mediawiki.org to allow unified login between your forum and wiki especially as you were considering OpenID.

Also do tell me if I can be of any help with the site as the code for the various VideoLAN projects is a little over my head so I'd love to help with this (I'm fairly familiar with working on community sites if not media player code).

(also something appears to be wrong with Trac: (though I'm sure this has already been noted)
<pre>:Report execution failed: invalid reference to FROM-clause entry for table "t" LINE 9: LEFT OUTER JOIN ticket_custom diff ON t.id=diff.ticket AND... ^ HINT: There is an entry for table "t", but it cannot be referenced from this part of the query.)</pre>
on the page: [http://trac.videolan.org/vlc/report/11] )

Oh and IRCWeb isn't working as of the time of writing: http://krishna.videolan.org/cgi-bin/irc/irc.cgi (can't reach server) (once again, probably noted)

Once again, tell me if I can be of any use, otherwise, thanks for the great work on VLC and the other VideoLAN projects and I'll try and help with the wiki where I can!

--[[User:Tek|Tek]] 14:42, 16 May 2009 (CEST)

== sudo make install lines? ==

Minor suggestion:

Add sudo make install lines prior to all 4 builds (vlc, live555, x264, and ffmpeg) --[[User:Neo_The_User|Neo_The_User]] 12:26 (US Central) 05/16/2009

== Audio Interface ==
Hello JB,

Problem regarding the audio interface:

I'm using a professional audio interface (Layla 24)on 1.7G AMD system w/2G of ram and am experiencing audio severe audio breakup. Interestingly the Windows media player works fine with the same files as does all of the pro-audio apps. I have tried all of the output options including direct X but default and WIN32 of course are the only ones that give any audio output. Those are rather distorted however. Any Suggestions or if you need more input We can meet on Skype for faster input.

I am experienced in audio and perhaps (I hold an advanced degree in Electro-Acoustics) I can help with some of the audio interface problems.

Ed Wolfrum

== Spam account ==

[[User:Jheena789]] seems to be a spam account. See http://wiki.videolan.org/index.php?title=Common_Problems&diff=16884&oldid=16872. [[User:Popol0909|Popol0909]] 15:36, 21 August 2010 (UTC)

OldFAQ

2010-08-21T15:26:30Z

Popol0909: /* Coarse volume control */

{{stub}}
Answers to some common problems people encounter with VLC. More help is available in the
* [http://www.videolan.org/doc/ Documentation]
* [http://www.videolan.org/doc/faq/en/videolan-faq-en.html FAQ]
* [[Forum]]

== Installing VLC ==

=== On Mac OS 9 ===

{{faqlink|239006}}
* Sorry, VLC will not work on OS 9, and probably never will. However, Mac OS X is supported - [[Unsupported|Find out Why]]

=== Compiling VLC ===

==== How do I compile VLC? ====

* Look at [http://developers.videolan.org/vlc/ how to compile VLC]. There are pre-compiled (binary / executable) versions [http://www.videolan.org/vlc/ here].

==== Mozilla Firefox Plugin ====

* ''Debian:'' All you need is to download the vlc plugin package - mozilla-plugin-vlc ([http://packages.debian.org/stable/graphics/mozilla-plugin-vlc stable release])
* ''All Linux:'' To make the firefox plugin with the vlc player, you will first need the Firefox Development package (from: [http://packages.ubuntu.com/breezy/devel/firefox-dev ubuntu] ...). Then, when you compile, run ./configure with --enable-mozilla, and if needed with --with-mozilla-sdk-path=''/path_to_firefox_sdk''

==== "Missing header file ffmpeg/avcodec.h" and "Missing header file postproc/postprocess.h" Errors ====

* Make sure that you have all the libraries you need.
** '''on ubuntu''': "apt-get install libavcodec-dev libpostproc-dev" will install the needed files (worked on edgy).
* When you run ./configure for [[ffmpeg]], make sure that at least the following flags are set (descriptions of these avaliable from ./configure --help )
./configure --enable-shared --enable-shared-pp --enable-pp --enable-gpl
* The path of ffmpeg is not set. Check if you can locate the file '''libavcodec.pc''' on your computer, and export PKG_CONFIG_PATH to where you found it before running ./configure. For example
export PKG_CONFIG_PATH=/home/you/ffmpeg/

With vlc-086f, FFmpeg SVN-r13060, on Slamd64 12.0.0, some other changes must be made. These are most likely due to changes in libpostproc.

The ./configure flags for ffmpeg become
./configure --enable-postproc --enable-shared --enable-gpl

Then you must set a symbolic link for postproc. This took me a long time to spot.

root @ svr (/usr/src/vlc-0.8.6f)locate postprocess.h
/usr/local/include/libpostproc/postprocess.h
root @ svr (/usr/src/vlc-0.8.6f)cd /usr/local/include/
root @ svr (/usr/local/include)ln -s libpostproc postproc

==== "cc1: error: invalid option `tune=opteron'" Error on 64-bit systems ====

* One user writes: "From what I can see, the -mtune flag is not available for this type of processor in man gcc. I had to change the configure options comment out all the lines where they set mcpu or mtune flags.) I don't know if this is the correct way to proceed but was the only way for me to get results fast."

* This is not true on all versions of gcc. Try to compile on your platform before making the above changes.

root @ p01 (/usr/src/vlc-0.8.6f)gcc --version
gcc (GCC) 4.1.2

root @ p01 (/usr/src/vlc-0.8.6f)uname -a
Linux p01 2.6.24.3 #2 SMP Tue Apr 8 12:01:03 EDT 2008 x86_64 x86_64 x86_64 GNU/Linux

root @ p01 (/usr/src/vlc-0.8.6f)grep tune= config.log
configure:37114: checking whether gcc accepts -mtune=athlon64
configure:37125: gcc -c -Wsign-compare -Wall -pipe -mtune=athlon64 -DSYS_LINUX conftest.c >&5

root @ p01 (/usr/src/vlc-0.8.6f)grep cpu= config.log
build_cpu='x86_64'
host_cpu='x86_64'
target_cpu='x86_64'

==== "/usr/bin/ld: cannot find -lX11" Error on 64-bit systems ====

* In configure, there is an x_libraries variable there that is set to "/usr/X11R6/lib" (around line 16371). Because it is a 64 bit system, this variable needs to be /usr/X11R6/lib64. After changing that, it should continue compiling.

==== "syntax error before "pthread_spinlock_t"" on debian-Etch or CentOS ====

* If you have errors about ''pthread_spin*'' in the file ''vlc_threads_funcs.h'', try this fix :
su
sed -e 's/define\s*_POSIX_SPIN_LOCKS\s*/define _POSIX_SPIN_LOCKS -1 \/\/ wrong: /g' -i /usr/include/bits/posix_opt.h
exit
source : [http://forum.videolan.org/viewtopic.php?f=13&t=43930#p139570 this post] from Rémi Denis-Courmont.

=== Installing Skins ===

* Although all information is given on the [http://www.videolan.org/vlc/skins.php VLC Download skin site], you may miss the note to change preferences to ''skinnable interface''. There is an [http://forum.videolan.org/viewtopic.php?p=85603#p85603 article on the forum] which describes the how-to. In short: there is a drop-down option (interface module) in the settings dialog (Interface → General) which defaults to ''Standard''. Change this and restart.

== Problems Starting VLC ==

=== VLC does not launch on my Mac anymore. What to do? ===

* Please have a look at the [[FAQ_on_MacOSX_only_issues|specific FAQ]], which covers multiple solutions to this issue.

== Error Messages ==

Error messages can be viewed by selecting Messages from the View menu.

=== main private error: no sout mux module matched "ts" ===

* This can be an error if '''libdvbpsi''' was not installed when vlc was compiled. To fix this error, install libdvbpsi; then re-compile vlc. [http://developers.videolan.org/libdvbpsi/ libdvbpsi]

=== main dialogs provider error: no dialogs provider module matched "any" ===

* The solution is found in [http://forum.videolan.org/viewtopic.php?t=14733 the forum]

== Problems playing types of files ==

=== WMV files ===

* Starting with VLC media player 0.8.6, the playback of WMV3-encoded videos is available on all platforms. Please note, that encrypted / DRM-protected video-clips still cannot be played. That is due to the nature of DRM and is not about to change, so please do not ask.

=== Real Media files ===

* Realmedia files (.rm, .rpm, etc) are proprietary (ie, copyrighted) file formats, created by RealNetworks. Because of this, VLC can't support them at present.

=== QuickTime Files (.mov) ===

* Mov file doesn't play, but plays ok in QuickTime
** open the url in QuickTime player
** let it decide which datarate is best for your connection
** let it play for a few seconds, then pause it
** open the stream info, copy the url
** open & save that one in VLC

=== Flash Video Files (.flv) ===

* Flash Video support has recently been added (provided through ffmpeg) - to view .flv files you will need version 0.8.4a. Download and install the latest version [http://www.videolan.org/vlc/ here].
* VLC still has problems with a few .flv files. If you have problems playing a file in VLC you might be able to change it to an avi using [[ffmpeg]]. See [[Fixing .flv to .avi with Ffmpeg]].
* VLC 0.8.6 provided enhanced Flash Video support on all platforms, so it is probably worth to update if you experience problems with prior releases.

=== Other Files ===

{{faqlink|238663}}
* Make sure that VLC supports that file - look at the [http://www.videolan.org/vlc/features.html list of supposted formats]

* Make sure that the file isn't corrupted

== VLC and Other Programs ==

=== AMR ===

* To use [http://en.wikipedia.org/wiki/Adaptive_Multi-Rate AMR], you'll need to compile vlc and ffmpeg with amr support yourself. This is because the amr license is not compatible with the vlc license.

=== ratDVD ===

* VLC does not support [http://en.wikipedia.org/wiki/RatDVD ratDVD] and is not going to be, both for political and technical reasons.

== Problems Playing DVDs ==

===Unable to play any DVDs===

{{faqlink|239006}}
* ''Linux:'' To play DVDs with VLC in linux, you need to install the libdvdcss package
* ''Linux:'' Make sure you have access rigths to your DVD player. In linux, you can use chmod to edit access rights to your DVD block device:
** <nowiki>#</nowiki> chmod 666 /dev/dvd
** The videolan FAQ seems to suggest you need write access to this device - is this true? If you know, please edit this entry.
* ''Linux:'' Make sure VLC knows where your DVD drive is located (/dev/dvd usually). Go to Settings | Preferences | Input/Codecs | General and under "Default devices" make sure your dvd drive path is entered in the "Default DVD" box. When you go to open a DVD, you should see something like "dvd:///dev/dvd" as the [[media resource locator]] in the "Open:" box near the top of the Open dialog.

=== Playing DVDs from other Region Codes ===

{{faqlink|239426}}
* The ability to play DVDs from all regions depends mostly on your DVD drive, and testing it is usually the quickest way to find out if your DVD drive can do it. Most newer DVD drives are RPC2 drives, which don't allow raw access to the drive untill the drive firmware has done a regioncheck. VLC uses libdvdcss and it needs raw access to the DVD drive to crack the encryption key. So with these drives it is impossible to circumvent the region protection. (This goes for all software. You will need to flash your drives firmware, but sometimes there is no alternate firmware available for your drive). On other RPC2 drives that DO allow raw access, it might take VLC a long time to crack the key. So just pop the disc in your drive and try it out, while you get a coffee. RPC1 drives should 'always' work regardless of the regioncode.

== Poor Quality Video and Audio ==

=== The video runs but the picture is distorted ===

{{faqlink|238431}}
* ''Linux:'' There is probably a problem with the output layer. There are several ways of troubleshooting it.
** First, try with another output plugin, for instance:
**: % vlc -V sdl
**: % vlc -V x11
** Second, change your screen depth and/or definition. It quite often helps.
** Lastly, if running Unix, have a look at your XFree86 video driver.

=== Video is choppy ===

{{faqlink|238474}}
* Your system may be too slow to decode all pictures. Sometimes, your CPU (computer) really isn't fast enough, but often the situation can be improved by changing your system configuration to be a bit kinder to VLC.
** Quit other programs running in the background
** Turn on DMA on your DVD device:
*** ''Linux:''
***: <nowiki>#</nowiki> hdparm -d1 /dev/dvd
*** ''Windows:'' go to the System section of the control panel, and go to the Hardware manager (it is sometimes in a separate tab, and sometimes, you have to go to the Advanced tab. Then, right-click on your DVD player, and check the DMA checkbox.
** Upgrade to the latest driver for your video board.
** ''Linux:'' you can additionally upgrade your drivers to the latest XFree86 version. If supported, check that the xvideo plug-in is effectively used with:
**: % vlc -vvvv

=== Audio and video are out of sync ===

{{faqlink|238571}}
* If you are [[transcoding]] a file, use the [[audio-sync]] option.
* You can manually set the audio offset while playing (so you can put the audio back in sync). The default keys to increase/decrease the offset are Ctrl+K and Ctrl+L in Windows, and f and g in Mac.
* ''Linux/Unix:'' Try using another audio output plugin and, under Unix, kill esd or artsd if they are running. If the problem is due to the input file, have a look at the "Audio desynchronization compensation" option.

== Problems with Streaming ==

==="main input error: no suitable access module for `rtsp://...'"===

vlc needs livemedia from '''live555.com''' to read rtsp stream this way.

You can check you have it by :

vlc -l | grep live

It should read

livedotcom live.com (RTSP/RTP/SDP) demuxer
livedotcom RTSP/RTP access and demux

If not, you have to install '''livemedia''' and point your compilation to this lib directory :

./configure '''--enable-livedotcom --with-livedotcom-tree=/usr/local/lib/live/'''

===Streaming playlist continuously between files (sout-keep not working)===

add the gather module to the sout chain, for example
vlc *mpeg --sout-keep --sout '#gather:transcode{plapla}:rtp{plapla}'

===Streaming 1 playlist item continuously and change input without stream break===

you can use this kind of a vlm.conf file with the --sout-keep option
new output1 broadcast enabled loop
setup output1 input "inputfile1.mpeg"
setup output1 input "inputfile2.mpeg"
setup output1 input "/path/to/inputfile3.mpeg"
setup output1 option sout-keep
setup output1 option input-repeat=-1
setup output1 output #gather:transcode{etc...}:std{plapla}

control output1 play 2

you then chan telnet into vlm and just command
control output1 play <playlistnumber>
to change the streamed input.

===Streaming to Windows Media Player===

See [[Windows Media Player]] for details.

== Problems converting between file formats (transcoding) ==

=== Missing Audio and/or Video ===

* Certain containers (aka muxers) can only hold certain types of video and audio - look at [http://www.videolan.org/streaming/features.html Streaming features]

== Streaming/Transcoding Wizard ==

=== Transcode / Save to file ===

* Partial Extract "From" "To" does not work, allone "To" don´t too.
: I've tested it too with the 0.8.6c version, already specifying the time data in seconds, and this parameter has no effect.

== VLC Crashes ==

=== General ===

{{faqlink|238592}}
* If VLC crashes, the following steps will help determine the cause.
** Increase the verbosity level (either in the preferences or with a -vvvv command line option) and look at the debug messages (in the terminal or in the Messages window).
* If you are convinced that it is a bug in VLC, have a look at the [http://www.videolan.org/support/bug-reporting.html bug reporting page].

=== When using DirectShow (eg Webcam) ===

{{forum|12394}}
* There was a bug a while back when you tried to stream using a directshow/webcam it would reboot the computer. The fix was to specify the resolution on the command line or in the "Advanced" section when opening the directshow.

== Other Problems ==

=== I only want one VLC player! ===

* To use the same VLC player for all the media files, go to Settings, Preferences, Advanced. The following options should give behavior similar to WMP: minimize # of threads, allow only one running instance, VLC is started from file association, allow only "on" running instance when started from file (typo in v0.8.5).

=== Licensing, legal issues and logo use ===

* Information on this is avaliable on the main videolan website, [http://videolan.org videolan.org]. Also read the [http://www.videolan.org/doc/faq/en/index.html#id238663 Legal concerns] section of the [http://www.videolan.org/doc/faq/en/index.html FAQ].
* This is a wiki site: it is editable by all, so it is best to check to official website.

=== Fixing Strange Behaviour ===

{{faqlink|238992}}
* The first thing to do is to reset the VLC preferences in the preferences dialog of the application and restart VLC. If VLC doesn't even start anymore, delete VLC's configuration file ([[#Configuration File|where is it?]]). Then restart VLC. If it does not get any better, read the rest of this page or FAQ page, or ask for help at the [[forum]].

=== Subtitles Problem ===

* In the File | Open File dialog, select "Use a subtitles file", and enter both the video's filename and the video's subtitle filename.
* If you are having displaying the subtitles, the problem might be an encoding problem. Choose the right encoding for your language and it should fix your problem. You'll find the ISOs here: [http://alis.isoc.org/codage/iso8859/jeuxiso.en.htm]. Once you find a text encoding method that works well for you enter it in Preferences, Input / Codecs, Other codecs, Subtitles then press Save and restart VLC. Uncheck the "Formatted Subtitles" may help if the subtitles only display as little squares. If you have a specialized language like Hebrew, Arabic, Chinese or Japanese changing the font to a Unicode font will be helpful. For Polish subtitles choose CP 1250 ISO code.

=== VLC hangs when opening Matroska (mkv) files ===

* This might occur when using VLC to view an mkv file in a directory that has a large number of mkv files. (eg. in an Azureus download directory)
VLC will attempt to preload all the mkv files in the directory and will hang, especially if some mkv files are not fully downloaded yet (thus seem to be broken).
* The solution is to set the mkv option: --mkv-preload-local-dir to false
Preferences -> Input / Codecs -> Demuxers -> Matroska -> Preload Directory (uncheck the checkbox)
(See also http://wiki.videolan.org/Matroska)

=== Coarse volume control ===

Volume control, specially with Hotkeys, is too coarse.
*To have a finer volume control, try the following option on the command line:
<code>--volume-step=1</code>
:See also [[VLC command-line help]]

Talk:VLC command-line help

2010-08-21T15:23:42Z

Popol0909: /* We should only keep the first few lines of this page */

mp3 metadata transcoding VLC? How to add metadata to mp3 stream?
Also where this COMMAND LINE in VLC - I dodn't find it?

: I don't think you can change the metadata directly on VLC at the moment, sorry about that :(
: The command line is cmd.exe ([[wikipedia:cmd.exe|wikipedia]]), sometimes called the MS-DOS prompt. Full details are at [[command prompt]], but in short it is a part of Windows that is used to run programs by typing in their full name, followed by some options (if you want). It is useful if you want to have fine control of a program (as you can pass options to tell the program what to do when you start it), or want to run programs that do not open a window (vlc can run without a window by using a [[console interface]]). --[[User:H2g2bob|h2g2bob]] 03:49, 12 December 2006 (CET)

== Appearance of this Wiki page ==

This page is very long and wide, and since the included scroll bar is out of sight at the bottom, it's hard to navigate. Running Firefox and searching for the word "equalizer", there were apparently a few occurrences of it that were utterly invisible. [[User:D021317c|D021317c]] 09:13, 21 January 2007 (CET)

this page renders my os x browser unusable. I also can't see any of the text in the {code} section

== Explanation of ISO639 codes ==

In the following two command options ...
--audio-language=<string>
--sub-language=<string>
... the help indicates that you can use a 2- or 3-letter ISO639 code. This is true, but there is also a special code, "any" (all lowercase), that defaults to using any language. If you omit "any", the system defaults to "Disabled".
--[[User:Johnf|Johnf]] 04:32, 30 August 2009 (UTC)

== We should only keep the first few lines of this page ==

This page is not very useful as the information it contains can easily be generated using "vlc --help". What do you think? [[User:Popol0909|Popol0909]] 15:23, 21 August 2010 (UTC)

Talk:VLC command-line help

2010-08-21T15:22:07Z

Popol0909: /* We should only keep the first few lines of this page */ new section

VLC command-line help

2010-08-21T15:10:42Z

Popol0909: Corrected explanations on the way comand-line help is displayed.

:''See also [[Command line]], [[Console|Console interfaces]]''
Running the command
vlc --help
will create a .TXT file containnig all the command-line options.

If you look for help, on a particular module, you can also use
vlc -p module --advanced

Undocumented option:
-vvv "Verbose verbose verbose". Verbose output

Here's the output of ''vlc -H'' of the stable 1.1.0 in Windows. If you are looking for 0.8.6 help, go [[VLC-0-8-6_command-line_help]]. If you are looking for 0.9.x help, go [[VLC-0-9-x_command-line_help]]. If you are looking for 1.0.x help, go [[VLC-1-0-x_command-line_help]]

Part 1/2
<nowiki>
Usage: vlc [options] [stream] ...
You can specify multiple streams on the commandline. They will be enqueued in the playlist.
The first item specified will be played first.

Options-styles:
--option A global option that is set for the duration of the program.
-option A single letter version of a global --option.
:option An option that only applies to the stream directly before it
and that overrides previous settings.

Stream MRL syntax:
[[access][/demux]://]URL[@[title][:chapter][-[title][:chapter]]] [:option=value ...]

Many of the global --options can also be used as MRL specific :options.
Multiple :option=value pairs can be specified.

URL syntax:
[file://]filename Plain media file
http://ip:port/file HTTP URL
ftp://ip:port/file FTP URL
mms://ip:port/file MMS URL
screen:// Screen capture
[dvd://][device][@raw_device] DVD device
[vcd://][device] VCD device
[cdda://][device] Audio CD device
udp://[[<source address>]@[<bind address>][:<bind port>]]
UDP stream sent by a streaming server
vlc://pause:<seconds> Special item to pause the playlist for a certain time
vlc://quit Special item to quit VLC

No matching module found. Use --list or --list-verbose to list available modules.

VBI and Teletext decoder
--vbi-page=<integer> Teletext page
Open the indicated Teletext page.Default page is index 100
--vbi-opaque, --no-vbi-opaque
Text is always opaque (default enabled)
Setting vbi-opaque to false makes the boxed text transparent.
(default enabled)
--vbi-position={0 (Center), 1 (Left), 2 (Right), 4 (Top), 8 (Bottom), 5 (Top-Left), 6 (Top-Right), 9 (Bottom-Left), 10 (Bottom-Right)}
Teletext alignment
You can enforce the teletext position on the video (0=center, 1=left,
2=right, 4=top, 8=bottom, you can also use combinations of these
values, eg. 6 = top-right).
--vbi-text, --no-vbi-text Teletext text subtitles (default disabled)
Output teletext subtitles as text instead of as RGBA (default
disabled)

YUV video output
--yuv-file=<string> device, fifo or filename
device, fifo or filename to write yuv frames too.
--yuv-chroma=<string> Chroma used
Force use of a specific chroma for output. Default is I420.
--yuv-yuv4mpeg2, --no-yuv-yuv4mpeg2
YUV4MPEG2 header (default disabled) (default
disabled)
The YUV4MPEG2 header is compatible with mplayer yuv video ouput and
requires YV12/I420 fourcc. By default vlc writes the fourcc of the
picture frame into the output destination. (default disabled)

H.264/MPEG4 AVC encoder (x264)
--sout-x264-keyint=<integer>
Maximum GOP size
Sets maximum interval between IDR-frames.Larger values save bits,
thus improving quality for a given bitrate at the cost of seeking
precision.
--sout-x264-min-keyint=<integer>
Minimum GOP size
Sets minimum interval between IDR-frames. In H.264, I-frames do not
necessarily bound a closed GOP because it is allowable for a P-frame
to be predicted from more frames than just the one frame before it
(also see reference frame option). Therefore, I-frames are not
necessarily seekable. IDR-frames restrict subsequent P-frames from
referring to any frame prior to the IDR-frame.
If scenecuts appear
within this interval, they are still encoded as I-frames, but do not
start a new GOP.
--sout-x264-scenecut=<integer [-1 .. 100]>
Extra I-frames aggressivity
Scene-cut detection. Controls how aggressively to insert extra
I-frames. With small values of scenecut, the codec often has to force
an I-frame when it would exceed keyint. Good values of scenecut may
find a better location for the I-frame. Large values use more
I-frames than necessary, thus wasting bits. -1 disables scene-cut
detection, so I-frames are inserted only every other keyint frames,
which probably leads to ugly encoding artifacts. Range 1 to 100.
--sout-x264-bframes=<integer [0 .. 16]>
B-frames between I and P
Number of consecutive B-frames between I and P-frames. Range 1 to 16.
--sout-x264-b-adapt=<integer [0 .. 2]>
Adaptive B-frame decision
Force the specified number of consecutive B-frames to be used, except
possibly before an I-frame.Range 0 to 2.
--sout-x264-b-bias=<integer [-100 .. 100]>
Influence (bias) B-frames usage
Bias the choice to use B-frames. Positive values cause more B-frames,
negative values cause less B-frames.
--sout-x264-bpyramid={none,strict,normal}
Keep some B-frames as references
Allows B-frames to be used as references for predicting other frames.
Keeps the middle of 2+ consecutive B-frames as a reference, and
reorders frame appropriately.
- none: Disabled
- strict: Strictly
hierarchical pyramid
- normal: Non-strict (not Blu-ray compatible)

--sout-x264-cabac, --no-sout-x264-cabac
CABAC (default enabled)
CABAC (Context-Adaptive Binary Arithmetic Coding). Slightly slows
down encoding and decoding, but should save 10 to 15% bitrate.
(default enabled)
--sout-x264-ref=<integer [1 .. 16]>
Number of reference frames
Number of previous frames used as predictors. This is effective in
Anime, but seems to make little difference in live-action source
material. Some decoders are unable to deal with large frameref
values. Range 1 to 16.
--sout-x264-nf, --no-sout-x264-nf
Skip loop filter (default disabled)
Deactivate the deblocking loop filter (decreases quality). (default
disabled)
--sout-x264-deblock=<string>
Loop filter AlphaC0 and Beta parameters
alpha:beta
Loop filter AlphaC0 and Beta parameters. Range -6 to 6 for both alpha
and beta parameters. -6 means light filter, 6 means strong.
--sout-x264-psy-rd=<string>
Strength of psychovisual optimization,
default is "1.0:0.0"
First parameter controls if RD is on (subme>=6) or offsecond
parameter controls if Trellis is used on psychovisual
optimization,default off
--sout-x264-psy, --no-sout-x264-psy
Use Psy-optimizations (default enabled)
Use all visual optimizations that can worsen both PSNR and SSIM
(default enabled)
--sout-x264-level=<string> H.264 level
Specify H.264 level (as defined by Annex A of the standard). Levels
are not enforced; it's up to the user to select a level compatible
with the rest of the encoding options. Range 1 to 5.1 (10 to 51 is
also allowed).
--sout-x264-profile={baseline,main,high}
H.264 profile
Specify H.264 profile which limits are enforced overother settings
--sout-x264-interlaced, --no-sout-x264-interlaced
Interlaced mode (default disabled)
Pure-interlaced mode. (default disabled)
--sout-x264-slices=<integer>
Force number of slices per frame
Force rectangular slices and is overridden by other slicing optinos
--sout-x264-slice-max-size=<integer>
Limit the size of each slice in bytes
Sets a maximum slice size in bytes, Includes NAL overhead in size
--sout-x264-slice-max-mbs=<integer>
Limit the size of each slice in macroblocks
Sets a maximum number of macroblocks per slice
--sout-x264-hrd={none,vbr,cbr}
HRD-timing information
HRD-timing information
--sout-x264-qp=<integer [-1 .. 51]>
Set QP
This selects the quantizer to use. Lower values result in better
fidelity, but higher bitrates. 26 is a good default value. Range 0
(lossless) to 51.
--sout-x264-crf=<integer [0 .. 51]>
Quality-based VBR
1-pass Quality-based VBR. Range 0 to 51.
--sout-x264-qpmin=<integer [0 .. 51]>
Min QP
Minimum quantizer parameter. 15 to 35 seems to be a useful range.
--sout-x264-qpmax=<integer [0 .. 51]>
Max QP
Maximum quantizer parameter.
--sout-x264-qpstep=<integer [0 .. 51]>
Max QP step
Max QP step between frames.
--sout-x264-ratetol=<float [0.000000 .. 100.000000]>
Average bitrate tolerance
Allowed variance in average bitrate (in kbits/s).
--sout-x264-vbv-maxrate=<integer>
Max local bitrate
Sets a maximum local bitrate (in kbits/s).
--sout-x264-vbv-bufsize=<integer>
VBV buffer
Averaging period for the maximum local bitrate (in kbits).
--sout-x264-vbv-init=<float [0.000000 .. 1.000000]>
Initial VBV buffer occupancy
Sets the initial buffer occupancy as a fraction of the buffer size.
Range 0.0 to 1.0.
--sout-x264-ipratio=<float [1.000000 .. 2.000000]>
QP factor between I and P
QP factor between I and P. Range 1.0 to 2.0.
--sout-x264-pbratio=<float [1.000000 .. 2.000000]>
QP factor between P and B
QP factor between P and B. Range 1.0 to 2.0.
--sout-x264-chroma-qp-offset=<integer>
QP difference between chroma and luma
QP difference between chroma and luma.
--sout-x264-pass=<integer [0 .. 3]>
Multipass ratecontrol
Multipass ratecontrol:
- 1: First pass, creates stats file
- 2:
Last pass, does not overwrite stats file
- 3: Nth pass, overwrites
stats file

--sout-x264-qcomp=<float [0.000000 .. 1.000000]>
QP curve compression
QP curve compression. Range 0.0 (CBR) to 1.0 (QCP).
--sout-x264-cplxblur=<float>
Reduce fluctuations in QP
This reduces the fluctuations in QP before curve compression.
Temporally blurs complexity.
--sout-x264-qblur=<float> Reduce fluctuations in QP
This reduces the fluctations in QP after curve compression.
Temporally blurs quants.
--sout-x264-aq-mode=<integer [0 .. 2]>
How AQ distributes bits
Defines bitdistribution mode for AQ, default 1
- 0: Disabled
- 1:
Current x264 default mode
- 2: uses log(var)^2 instead of log(var)
and attempts to adapt strength per frame
--sout-x264-aq-strength=<float>
Strength of AQ
Strength to reduce blocking and blurring in flat
and textured areas,
default 1.0 recommented to be between 0..2
- 0.5: weak AQ
- 1.5:
strong AQ
--sout-x264-partitions={none,fast,normal,slow,all}
Partitions to consider
Partitions to consider in analyse mode:
- none :
- fast : i4x4

- normal: i4x4,p8x8,(i8x8)
- slow : i4x4,p8x8,(i8x8),b8x8
- all
: i4x4,p8x8,(i8x8),b8x8,p4x4
(p4x4 requires p8x8. i8x8 requires
8x8dct).
--sout-x264-direct={none,spatial,temporal,auto}
Direct MV prediction mode
Direct MV prediction mode.
--sout-x264-direct-8x8=<integer [-1 .. 1]>
Direct prediction size
Direct prediction size: - 0: 4x4
- 1: 8x8
- -1: smallest
possible according to level

--sout-x264-weightb, --no-sout-x264-weightb
Weighted prediction for B-frames (default
enabled)
Weighted prediction for B-frames. (default enabled)
--sout-x264-weightp=<integer [0 .. 2]>
Weighted prediction for P-frames
Weighted prediction for P-frames: - 0: Disabled
- 1: Blind offset

- 2: Smart analysis

--sout-x264-me={dia,hex,umh,esa,tesa}
Integer pixel motion estimation method
Selects the motion estimation algorithm: - dia: diamond search,
radius 1 (fast)
- hex: hexagonal search, radius 2
- umh: uneven
multi-hexagon search (better but slower)
- esa: exhaustive search
(extremely slow, primarily for testing)
- tesa: hadamard exhaustive
search (extremely slow, primarily for testing)

--sout-x264-merange=<integer [1 .. 64]>
Maximum motion vector search range
Maximum distance to search for motion estimation, measured from
predicted position(s). Default of 16 is good for most footage, high
motion sequences may benefit from settings between 24 and 32. Range 0
to 64.
--sout-x264-mvrange=<integer>
Maximum motion vector length
Maximum motion vector length in pixels. -1 is automatic, based on
level.
--sout-x264-mvrange-thread=<integer>
Minimum buffer space between threads
Minimum buffer space between threads. -1 is automatic, based on
number of threads.
--sout-x264-subme=<integer>
Subpixel motion estimation and partition
decision quality
This parameter controls quality versus speed tradeoffs involved in
the motion estimation decision process (lower = quicker and higher =
better quality). Range 1 to 9.
--sout-x264-mixed-refs, --no-sout-x264-mixed-refs
Decide references on a per partition basis
(default enabled)
Allows each 8x8 or 16x8 partition to independently select a reference
frame, as opposed to only one ref per macroblock. (default enabled)
--sout-x264-chroma-me, --no-sout-x264-chroma-me
Chroma in motion estimation (default enabled)
Chroma ME for subpel and mode decision in P-frames. (default enabled)
--sout-x264-8x8dct, --no-sout-x264-8x8dct
Adaptive spatial transform size (default
enabled)
SATD-based decision for 8x8 transform in inter-MBs. (default enabled)
--sout-x264-trellis=<integer [0 .. 2]>
Trellis RD quantization
Trellis RD quantization:
- 0: disabled
- 1: enabled only on the
final encode of a MB
- 2: enabled on all mode decisions
This
requires CABAC.
--sout-x264-lookahead=<integer [0 .. 60]>
Framecount to use on frametype lookahead
Framecount to use on frametype lookahead. Currently default is lower
than x264 default because unmuxable outputdoesn't handle larger
values that well yet
--sout-x264-intra-refresh, --no-sout-x264-intra-refresh
Use Periodic Intra Refresh (default disabled)
Use Periodic Intra Refresh instead of IDR frames (default disabled)
--sout-x264-mbtree, --no-sout-x264-mbtree
Use mb-tree ratecontrol (default enabled)
You can disable use of Macroblock-tree on ratecontrol (default
enabled)
--sout-x264-fast-pskip, --no-sout-x264-fast-pskip
Early SKIP detection on P-frames (default
enabled)
Early SKIP detection on P-frames. (default enabled)
--sout-x264-dct-decimate, --no-sout-x264-dct-decimate
Coefficient thresholding on P-frames (default
enabled)
Coefficient thresholding on P-frames.Eliminate dct blocks containing
only a small single coefficient. (default enabled)
--sout-x264-nr=<integer [0 .. 1000]>
Noise reduction
Dct-domain noise reduction. Adaptive pseudo-deadzone. 10 to 1000
seems to be a useful range.
--sout-x264-deadzone-inter=<integer [0 .. 32]>
Inter luma quantization deadzone
Set the size of the intra luma quantization deadzone. Range 0 to 32.
--sout-x264-deadzone-intra=<integer [0 .. 32]>
Intra luma quantization deadzone
Set the size of the intra luma quantization deadzone. Range 0 to 32.
--sout-x264-non-deterministic, --no-sout-x264-non-deterministic
Non-deterministic optimizations when threaded
(default disabled)
Slightly improve quality of SMP, at the cost of repeatability.
(default disabled)
--sout-x264-asm, --no-sout-x264-asm
CPU optimizations (default enabled)
Use assembler CPU optimizations. (default enabled)
--sout-x264-psnr, --no-sout-x264-psnr
PSNR computation (default disabled)
Compute and print PSNR stats. This has no effect on the actual
encoding quality. (default disabled)
--sout-x264-ssim, --no-sout-x264-ssim
SSIM computation (default disabled)
Compute and print SSIM stats. This has no effect on the actual
encoding quality. (default disabled)
--sout-x264-quiet, --no-sout-x264-quiet
Quiet mode (default disabled)
Quiet mode. (default disabled)
--sout-x264-sps-id=<integer>
SPS and PPS id numbers
Set SPS and PPS id numbers to allow concatenating streams with
different settings.
--sout-x264-aud, --no-sout-x264-aud
Access unit delimiters (default disabled)
Generate access unit delimiter NAL units. (default disabled)
--sout-x264-verbose, --no-sout-x264-verbose
Statistics (default disabled)
Print stats for each frame. (default disabled)
--sout-x264-stats=<string> Filename for 2 pass stats file
Filename for 2 pass stats file for multi-pass encoding.
--sout-x264-preset={ultrafast,superfast,veryfast,faster,fast,medium,slow,slower,veryslow,placebo}
Use preset as default settings. Overridden by
user settings.
Use preset as default settings. Overridden by user settings.
--sout-x264-tune={film,animation,grain,stillimage,psnr,ssim,fastdecode,zerolatency}
Tune the settings for a particular type of
source or situation. Overridden by user
settings.
Tune the settings for a particular type of source or situation.
Overridden by user settings.

Win32 waveOut extension output
--waveout-float32, --no-waveout-float32
Use float32 output (default enabled)
The option allows you to enable or disable the high-quality float32
audio output mode (which is not well supported by some soundcards).
(default enabled)
--waveout-audio-device={wavemapper}
Select Audio Device
Select special Audio device, or let windows decide (default), change
needs VLC restart to apply.

Wall video filter
--wall-cols=<integer> Number of columns
Number of horizontal windows in which to split the video.
--wall-rows=<integer> Number of rows
Number of vertical windows in which to split the video.
--wall-active=<string> Active windows
Comma-separated list of active windows, defaults to all
--wall-element-aspect=<string>
Element aspect ratio
Aspect ratio of the individual displays building the wall.

Simple DirectMedia Layer video output
--sdl-chroma=<string> SDL chroma format
Force the SDL renderer to use a specific chroma format instead of
trying to improve performances by using the most efficient one.

Vorbis audio decoder
--sout-vorbis-quality=<integer [0 .. 10]>
Encoding quality
Enforce a quality between 1 (low) and 10 (high), instead of
specifying a particular bitrate. This will produce a VBR stream.
--sout-vorbis-max-bitrate=<integer>
Maximum encoding bitrate
Maximum bitrate in kbps. This is useful for streaming applications.
--sout-vorbis-min-bitrate=<integer>
Minimum encoding bitrate
Minimum bitrate in kbps. This is useful for encoding for a fixed-size
channel.
--sout-vorbis-cbr, --no-sout-vorbis-cbr
CBR encoding (default disabled)
Force a constant bitrate encoding (CBR). (default disabled)

RTSP VoD server
--rtsp-host=<string> RTSP host address
This defines the address, port and path the RTSP VOD server will
listen on.
Syntax is address:port/path. The default is to listen on
all interfaces (address 0.0.0.0), on port 554, with no path.
To
listen only on the local interface, use "localhost" as address.
--rtsp-raw-mux=<string> MUX for RAW RTSP transport
MUX for RAW RTSP transport
--rtsp-throttle-users=<integer>
Maximum number of connections
This limits the maximum number of clients that can connect to the
RTSP VOD. 0 means no limit.
--rtsp-session-timeout=<integer>
Sets the timeout option in the RTSP session
string
Defines what timeout option to add to the RTSP session ID string.
Setting it to a negative number removes the timeout option entirely.
This is needed by some IPTV STBs (such as those made by HansunTech)
which get confused by it. The default is 5.

Video memory output
--vmem-width=<integer> Width
Video memory buffer width.
--vmem-height=<integer> Height
Video memory buffer height.
--vmem-pitch=<integer> Pitch
Video memory buffer pitch in bytes.
--vmem-chroma=<string> Chroma
Output chroma for the memory image as a 4-character string, eg.
"RV32".
--vmem-lock=<string> Lock function
Address of the locking callback function. This function must fill in
valid plane memory address information for use by the video renderer.
--vmem-unlock=<string> Unlock function
Address of the unlocking callback function
--vmem-data=<string> Callback data
Data for the locking and unlocking functions

Visualizer filter
General:
--effect-list=<string> Effects list
A list of visual effect, separated by commas.
Current effects
include: dummy, scope, spectrum, spectrometer and vuMeter.
--effect-width=<integer> Video width
The width of the effects video window, in pixels.
--effect-height=<integer> Video height
The height of the effects video window, in pixels.
Spectrum analyser:
--visual-80-bands, --no-visual-80-bands
More bands : 80 / 20 (default enabled)
More bands for the spectrum analyzer : 80 if enabled else 20.
(default enabled)
--visual-peaks, --no-visual-peaks
Enable peaks (default enabled)
Draw "peaks" in the spectrum analyzer. (default enabled)
Spectrometer:
--spect-show-original, --no-spect-show-original
Enable original graphic spectrum (default
disabled)
Enable the "flat" spectrum analyzer in the spectrometer. (default
disabled)
--spect-show-base, --no-spect-show-base
Enable base (default enabled)
Defines whether to draw the base of the bands. (default enabled)
--spect-radius=<integer> Base pixel radius
Defines radius size in pixels, of base of bands(beginning).
--spect-sections=<integer> Spectral sections
Determines how many sections of spectrum will exist.
--spect-color=<integer> V-plane color
YUV-Color cube shifting across the V-plane ( 0 - 127 ).
--spect-show-bands, --no-spect-show-bands
Enable bands (default enabled)
Draw bands in the spectrometer. (default enabled)
--spect-80-bands, --no-spect-80-bands
More bands : 80 / 20 (default enabled)
More bands for the spectrometer : 80 if enabled else 20. (default
enabled)
--spect-separ=<integer> Band separator
Number of blank pixels between bands.
--spect-amp=<integer> Amplification
This is a coefficient that modifies the height of the bands.
--spect-show-peaks, --no-spect-show-peaks
Enable peaks (default enabled)
Draw "peaks" in the spectrum analyzer. (default enabled)
--spect-peak-width=<integer>
Peak extra width
Additions or subtractions of pixels on the peak width.
--spect-peak-height=<integer>
Peak height
Total pixel height of the peak items.

VCD input
--vcd-caching=<integer> Caching value in ms
Caching value for VCDs. This value should be set in milliseconds.

VC1 video demuxer
--vc1-fps=<float> Frames per Second
Desired frame rate for the VC-1 stream.

Libtwolame audio encoder
--sout-twolame-quality=<float>
Encoding quality
Force a specific encoding quality between 0.0 (high) and 50.0 (low),
instead of specifying a particular bitrate. This will produce a VBR
stream.
--sout-twolame-mode={0 (Stereo), 1 (Dual mono), 2 (Joint stereo)}
Stereo mode
Handling mode for stereo streams
--sout-twolame-vbr, --no-sout-twolame-vbr
VBR mode (default disabled)
Use Variable BitRate. Default is to use Constant BitRate (CBR).
(default disabled)
--sout-twolame-psy=<integer>
Psycho-acoustic model
Integer from -1 (no model) to 4.

MPEG Transport Stream demuxer
--ts-extra-pmt=<string> Extra PMT
Allows a user to specify an extra pmt (pmt_pid=pid:stream_type[,...]).
--ts-es-id-pid, --no-ts-es-id-pid
Set id of ES to PID (default enabled)
Set the internal ID of each elementary stream handled by VLC to the
same value as the PID in the TS stream, instead of 1, 2, 3, etc.
Useful to do '#duplicate{..., select="es=<pid>"}'. (default enabled)
--ts-out=<string> Fast udp streaming
Sends TS to specific ip:port by udp (you must know what you are
doing).
--ts-out-mtu=<integer> MTU for out mode
MTU for out mode.
--ts-csa-ck=<string> CSA ck
Control word for the CSA encryption algorithm
--ts-csa2-ck=<string> CSA ck
Control word for the CSA encryption algorithm
--ts-csa-pkt=<integer> Packet size in bytes to decrypt
Specify the size of the TS packet to decrypt. The decryption routines
subtract the TS-header from the value before decrypting.
--ts-silent, --no-ts-silent
Silent mode (default disabled)
Do not complain on encrypted PES. (default disabled)
--ts-dump-file=<string> Filename of dump
Specify a filename where to dump the TS in.
--ts-dump-append, --no-ts-dump-append
Append (default disabled)
If the file exists and this option is selected, the existing file
will not be overwritten. (default disabled)
--ts-dump-size=<integer> Dump buffer size
Tweak the buffer size for reading and writing an integer number of
packets.Specify the size of the buffer here and not the number of
packets.
--ts-split-es, --no-ts-split-es
Separate sub-streams (default enabled)
Separate teletex/dvbs pages into independent ES. It can be useful to
turn off this option when using stream output. (default enabled)

Video transformation filter
Rotate or flip the video
--transform-type={90,180,270,hflip,vflip}
Transform type
One of '90', '180', '270', 'hflip' and 'vflip'

Theora video decoder
--sout-theora-quality=<integer>
Encoding quality
Enforce a quality between 1 (low) and 10 (high), instead of
specifying a particular bitrate. This will produce a VBR stream.

Video scaling filter
--swscale-mode={0 (Fast bilinear), 1 (Bilinear), 2 (Bicubic (good quality)), 3 (Experimental), 4 (Nearest neighbour (bad quality)), 5 (Area), 6 (Luma bicubic / chroma bilinear), 7 (Gauss), 8 (SincR), 9 (Lanczos), 10 (Bicubic spline)}
Scaling mode
Scaling mode to use.

Philips OGT (SVCD subtitle) decoder
--svcdsub-debug=<integer> Enable debug
This integer when viewed in binary is a debugging mask
calls
1
packet assembly info 2

Text subtitles parser
--sub-fps=<float> Frames per second
Override the normal frames per second settings. This will only work
with MicroDVD and SubRIP (SRT) subtitles.
--sub-delay=<integer> Subtitles delay
Apply a delay to all subtitles (in 1/10s, eg 100 means 10s).
--sub-type={auto,microdvd,subrip,subviewer,ssa1,ssa2-4,ass,vplayer,sami,dvdsubtitle,mpl2,aqt,pjs,mpsub,jacosub,psb,realtext,dks,subviewer1}
Subtitles format
Force the subtiles format. Valid values are : "microdvd", "subrip",
"subviewer", "ssa1", "ssa2-4", "ass", "vplayer", "sami",
"dvdsubtitle", "mpl2", "aqt", "pjs", "mpsub", "jacosub", "psb",
"realtext", "dks", "subviewer1", and "auto" (meaning autodetection,
this should always work).
--sub-description=<string> Subtitles description
Override the default track description.

Text subtitles decoder
--subsdec-align={0 (Center), 1 (Left), 2 (Right)}
Subtitles justification
Set the justification of subtitles
--subsdec-encoding={,UTF-8,UTF-16,UTF-16BE,UTF-16LE,GB18030,ISO-8859-15,Windows-1252,ISO-8859-2,Windows-1250,ISO-8859-3,ISO-8859-10,Windows-1251,KOI8-R,KOI8-U,ISO-8859-6,Windows-1256,ISO-8859-7,Windows-1253,ISO-8859-8,Windows-1255,ISO-8859-9,Windows-1254,ISO-8859-11,Windows-874,ISO-8859-13,Windows-1257,ISO-8859-14,ISO-8859-16,ISO-2022-CN-EXT,EUC-CN,ISO-2022-JP-2,EUC-JP,Shift_JIS,CP949,ISO-2022-KR,Big5,ISO-2022-TW,Big5-HKSCS,VISCII,Windows-1258}
Subtitles text encoding
Set the encoding used in text subtitles
--subsdec-autodetect-utf8, --no-subsdec-autodetect-utf8
UTF-8 subtitles autodetection (default
enabled)
This enables automatic detection of UTF-8 encoding within subtitles
files. (default enabled)
--subsdec-formatted, --no-subsdec-formatted
Formatted Subtitles (default enabled)
Some subtitle formats allow for text formatting. VLC partly
implements this, but you can choose to disable all formatting.
(default enabled)

Transcode stream output
Video:
--sout-transcode-venc=<string>
Video encoder
This is the video encoder module that will be used (and its
associated options).
--sout-transcode-vcodec=<string>
Destination video codec
This is the video codec that will be used.
--sout-transcode-vb=<integer>
Video bitrate
Target bitrate of the transcoded video stream.
--sout-transcode-scale=<float>
Video scaling
Scale factor to apply to the video while transcoding (eg: 0.25)
--sout-transcode-fps=<float>
Video frame-rate
Target output frame rate for the video stream.
--sout-transcode-hurry-up, --no-sout-transcode-hurry-up
Hurry up (default enabled)
The transcoder will drop frames if your CPU can't keep up with the
encoding rate. (default enabled)
--sout-transcode-deinterlace, --no-sout-transcode-deinterlace
Deinterlace video (default disabled)
Deinterlace the video before encoding. (default disabled)
--sout-transcode-deinterlace-module={deinterlace,ffmpeg-deinterlace}
Deinterlace module
Specify the deinterlace module to use.
--sout-transcode-width=<integer>
Video width
Output video width.
--sout-transcode-height=<integer>
Video height
Output video height.
--sout-transcode-maxwidth=<integer>
Maximum video width
Maximum output video width.
--sout-transcode-maxheight=<integer>
Maximum video height
Maximum output video height.
--sout-transcode-vfilter=<string>
Video filter
Video filters will be applied to the video streams (after overlays
are applied). You can enter a colon-separated list of filters.
Audio:
--sout-transcode-aenc=<string>
Audio encoder
This is the audio encoder module that will be used (and its
associated options).
--sout-transcode-acodec=<string>
Destination audio codec
This is the audio codec that will be used.
--sout-transcode-ab=<integer>
Audio bitrate
Target bitrate of the transcoded audio stream.
--sout-transcode-alang=<string>
Audio Language
This is the language of the audio stream.
--sout-transcode-channels=<integer>
Audio channels
Number of audio channels in the transcoded streams.
--sout-transcode-samplerate=<integer>
Audio sample rate
Sample rate of the transcoded audio stream (11250, 22500, 44100 or
48000).
--sout-transcode-audio-sync, --no-sout-transcode-audio-sync
Synchronise on audio track (default disabled)
This option will drop/duplicate video frames to synchronise the video
track on the audio track. (default disabled)
--sout-transcode-afilter=<string>
Audio filter
Audio filters will be applied to the audio streams (after conversion
filters are applied). You can enter a colon-separated list of filters.
Overlays/Subtitles:
--sout-transcode-senc=<string>
Subtitles encoder
This is the subtitles encoder module that will be used (and its
associated options).
--sout-transcode-scodec=<string>
Destination subtitles codec
This is the subtitles codec that will be used.
--sout-transcode-soverlay, --no-sout-transcode-soverlay
Destination subtitles codec (default disabled)
This is the subtitles codec that will be used. (default disabled)
--sout-transcode-sfilter=<string>
Overlays
This allows you to add overlays (also known as "subpictures" on the
transcoded video stream. The subpictures produced by the filters will
be overlayed directly onto the video. You can specify a
colon-separated list of subpicture modules
On Screen Display:
--sout-transcode-osd, --no-sout-transcode-osd
OSD menu (default disabled)
Stream the On Screen Display menu (using the osdmenu subpicture
module). (default disabled)
Miscellaneous:
--sout-transcode-threads=<integer>
Number of threads
Number of threads used for the transcoding.
--sout-transcode-high-priority, --no-sout-transcode-high-priority
High priority (default disabled)
Runs the optional encoder thread at the OUTPUT priority instead of
VIDEO. (default disabled)

Standard stream output
--sout-standard-access=<string>
Output access method
Output method to use for the stream.
--sout-standard-mux=<string>
Output muxer
Muxer to use for the stream.
--sout-standard-dst=<string>
Output destination
Destination (URL) to use for the stream. Overrides path and bind
parameters
--sout-standard-bind=<string>
address to bind to (helper setting for dst)
address:port to bind vlc to listening incoming streams helper setting
for dst,dst=bind+'/'+path. dst-parameter overrides this
--sout-standard-path=<string>
filename for stream (helper setting for dst)
Filename for stream helper setting for dst, dst=bind+'/'+path,
dst-parameter overrides this
--sout-standard-sap, --no-sout-standard-sap
SAP announcing (default disabled)
Announce this session with SAP. (default disabled)
--sout-standard-name=<string>
Session name
This is the name of the session that will be announced in the SDP
(Session Descriptor).
--sout-standard-group=<string>
Session groupname
This allows you to specify a group for the session, that will be
announced if you choose to use SAP.
--sout-standard-description=<string>
Session description
This allows you to give a short description with details about the
stream, that will be announced in the SDP (Session Descriptor).
--sout-standard-url=<string>
Session URL
This allows you to give an URL with more details about the stream
(often the website of the streaming organization), that will be
announced in the SDP (Session Descriptor).
--sout-standard-email=<string>
Session email
This allows you to give a contact mail address for the stream, that
will be announced in the SDP (Session Descriptor).
--sout-standard-phone=<string>
Session phone number
This allows you to give a contact telephone number for the stream,
that will be announced in the SDP (Session Descriptor).

Stream output to memory buffer
--sout-smem-video-prerender-callback=<string>
Video prerender callback
Address of the video prerender callback functionthis function will
set the buffer where render will be done
--sout-smem-audio-prerender-callback=<string>
Audio prerender callback
Address of the audio prerender callback function.this function will
set the buffer where render will be done
--sout-smem-video-postrender-callback=<string>
Video postrender callback
Address of the video postrender callback function.this function will
be called when the render is into the buffer
--sout-smem-audio-postrender-callback=<string>
Audio postrender callback
Address of the audio postrender callback function.this function will
be called when the render is into the buffer
--sout-smem-video-data=<string>
Video Callback data
Data for the video callback function.
--sout-smem-audio-data=<string>
Audio callback data
Data for the video callback function.
--sout-smem-time-sync, --no-sout-smem-time-sync
Time Synchronized output (default enabled)
Time Synchronisation option for output. If true, stream will render
as usual, else it will be rendered as fast as possible. (default
enabled)

RTP stream output
--sout-rtp-dst=<string> Destination
This is the output URL that will be used.
--sout-rtp-sdp=<string> SDP
This allows you to specify how the SDP (Session Descriptor) for this
RTP session will be made available. You must use an url:
http://location to access the SDP via HTTP, rtsp://location for RTSP
access, and sap:// for the SDP to be announced via SAP.
--sout-rtp-mux=<string> Muxer
This allows you to specify the muxer used for the streaming output.
Default is to use no muxer (standard RTP stream).
--sout-rtp-sap, --no-sout-rtp-sap
SAP announcing (default disabled)
Announce this session with SAP. (default disabled)
--sout-rtp-name=<string> Session name
This is the name of the session that will be announced in the SDP
(Session Descriptor).
--sout-rtp-description=<string>
Session description
This allows you to give a short description with details about the
stream, that will be announced in the SDP (Session Descriptor).
--sout-rtp-url=<string> Session URL
This allows you to give an URL with more details about the stream
(often the website of the streaming organization), that will be
announced in the SDP (Session Descriptor).
--sout-rtp-email=<string> Session email
This allows you to give a contact mail address for the stream, that
will be announced in the SDP (Session Descriptor).
--sout-rtp-phone=<string> Session phone number
This allows you to give a contact telephone number for the stream,
that will be announced in the SDP (Session Descriptor).
--sout-rtp-proto={dccp,sctp,tcp,udp,udplite}
Transport protocol
This selects which transport protocol to use for RTP.
--sout-rtp-port=<integer> Port
This allows you to specify the base port for the RTP streaming.
--sout-rtp-port-audio=<integer>
Audio port
This allows you to specify the default audio port for the RTP
streaming.
--sout-rtp-port-video=<integer>
Video port
This allows you to specify the default video port for the RTP
streaming.
--sout-rtp-ttl=<integer> Hop limit (TTL)
This is the hop limit (also known as "Time-To-Live" or TTL) of the
multicast packets sent by the stream output (-1 = use operating
system built-in default).
--sout-rtp-rtcp-mux, --no-sout-rtp-rtcp-mux
RTP/RTCP multiplexing (default disabled)
This sends and receives RTCP packet multiplexed over the same port as
RTP packets. (default disabled)
--sout-rtp-caching=<integer>
Caching value (ms)
Default caching value for outbound RTP streams. This value should be
set in milliseconds.
--sout-rtp-key=<string> SRTP key (hexadecimal)
RTP packets will be integrity-protected and ciphered with this Secure
RTP master shared secret key.
--sout-rtp-salt=<string> SRTP salt (hexadecimal)
Secure RTP requires a (non-secret) master salt value.
--sout-rtp-mp4a-latm, --no-sout-rtp-mp4a-latm
MP4A LATM (default disabled)
This allows you to stream MPEG4 LATM audio streams (see RFC3016).
(default disabled)

Record stream output
--sout-record-dst-prefix=<string>
Destination prefix
Prefix of the destination file automatically generated

Remote Audio Output Protocol stream output
--sout-raop-host=<string> Host
Hostname or IP address of target device
--sout-raop-password=<string>
Password
Password for target device.
--sout-raop-password-file=<string>
Password file
Read password for target device from file.
--sout-raop-volume=<integer [0 .. 255]>
Volume
Output volume for analog output: 0 for silence, 1..255 from almost
silent to very loud.

Mosaic bridge stream output
--sout-mosaic-bridge-id=<string>
ID
Specify an identifier string for this subpicture
--sout-mosaic-bridge-width=<integer>
Video width
Output video width.
--sout-mosaic-bridge-height=<integer>
Video height
Output video height.
--sout-mosaic-bridge-sar=<string>
Sample aspect ratio
Sample aspect ratio of the destination (1:1, 3:4, 2:3).
--sout-mosaic-bridge-chroma=<string>
Image chroma
Force the use of a specific chroma. Use YUVA if you're planning to
use the Alphamask or Bluescreen video filter.
--sout-mosaic-bridge-vfilter=<string>
Video filter
Video filters will be applied to the video stream.
--sout-mosaic-bridge-alpha=<integer [0 .. 255]>
Transparency
Transparency of the mosaic picture.
--sout-mosaic-bridge-x=<integer>
X offset
X coordinate of the upper left corner in the mosaic if non negative.
--sout-mosaic-bridge-y=<integer>
Y offset
Y coordinate of the upper left corner in the mosaic if non negative.

Elementary stream output
Generic:
--sout-es-access=<string> Output access method
This is the default output access method that will be used.
--sout-es-mux=<string> Output muxer
This is the default muxer method that will be used.
--sout-es-dst=<string> Output URL
This is the default output URI.
Audio:
--sout-es-access-audio=<string>
Audio output access method
This is the output access method that will be used for audio.
--sout-es-mux-audio=<string>
Audio output muxer
This is the muxer that will be used for audio.
--sout-es-dst-audio=<string>
Audio output URL
This is the output URI that will be used for audio.
Video:
--sout-es-access-video=<string>
Video output access method
This is the output access method that will be used for video.
--sout-es-mux-video=<string>
Video output muxer
This is the muxer that will be used for video.
--sout-es-dst-video=<string>
Video output URL
This is the output URI that will be used for video.

Display stream output
--sout-display-audio, --no-sout-display-audio
Enable audio (default enabled)
Enable/disable audio rendering. (default enabled)
--sout-display-video, --no-sout-display-video
Enable video (default enabled)
Enable/disable video rendering. (default enabled)
--sout-display-delay=<integer>
Delay
Introduces a delay in the display of the stream.

Bridge stream output
Bridge out:
--sout-bridge-out-id=<integer>
ID
Integer identifier for this elementary stream. This will be used to
"find" this stream later.
--sout-bridge-out-in-name=<string>
Destination bridge-in name
Name of the destination bridge-in. If you do not need more than one
bridge-in at a time, you can discard this option.
Bridge in:
--sout-bridge-in-delay=<integer>
Delay
Pictures coming from the picture video outputs will be delayed
according to this value (in milliseconds, should be >= 100 ms). For
high values, you will need to raise caching values.
--sout-bridge-in-id-offset=<integer>
ID Offset
Offset to add to the stream IDs specified in bridge_out to obtain the
stream IDs bridge_in will register.
--sout-bridge-in-name=<string>
Name of current instance
Name of this bridge-in instance. If you do not need more than one
bridge-in at a time, you can discard this option.
--sout-bridge-in-placeholder, --no-sout-bridge-in-placeholder
Fallback to placeholder stream when out of
data (default disabled)
If set to true, the bridge will discard all input elementary streams
except if it doesn't receive data from another bridge-in. This can be
used to configure a place holder stream when the real source breaks.
Source and placeholder streams should have the same format. (default
disabled)
--sout-bridge-in-placeholder-delay=<integer>
Placeholder delay
Delay (in ms) before the placeholder kicks in.
--sout-bridge-in-placeholder-switch-on-iframe, --no-sout-bridge-in-placeholder-switch-on-iframe
Wait for I frame before toggling placholder
(default enabled)
If enabled, switching between the placeholder and the normal stream
will only occur on I frames. This will remove artifacts on stream
switching at the expense of a slightly longer delay, depending on the
frequence of I frames in the streams. (default enabled)

DVD subtitles decoder
--dvdsub-transparency, --no-dvdsub-transparency
Disable DVD subtitle transparency (default
disabled)
Removes all transparency effects used in DVD subtitles. (default
disabled)

Speex audio decoder
--sout-speex-mode={0 (Narrow-band (8kHz)), 1 (Wide-band (16kHz)), 2 (Ultra-wideband (32kHz))}
Mode
Enforce the mode of the encoder.
--sout-speex-complexity=<integer [1 .. 10]>
Encoding complexity
Enforce the complexity of the encoder.
--sout-speex-cbr, --no-sout-speex-cbr
CBR encoding (default disabled)
Enforce a constant bitrate encoding (CBR) instead of default variable
bitrate encoding (VBR). (default disabled)
--sout-speex-quality=<float [0.000000 .. 10.000000]>
Encoding quality
Enforce a quality between 0 (low) and 10 (high).
--sout-speex-max-bitrate=<integer>
Maximal bitrate
Enforce the maximal VBR bitrate
--sout-speex-vad, --no-sout-speex-vad
Voice activity detection (default enabled)
Enable voice activity detection (VAD). It is automatically activated
in VBR mode. (default enabled)
--sout-speex-dtx, --no-sout-speex-dtx
Discontinuous Transmission (default disabled)
Enable discontinuous transmission (DTX). (default disabled)

Audio Spatializer
--spatializer-roomsize=<float>
Room size
Defines the virtual surface of the room emulated by the filter.
--spatializer-width=<float>
Room width
Width of the virtual room
--spatializer-wet=<float> Wet
--spatializer-dry=<float> Dry
--spatializer-damp=<float> Damp

Skinnable Interface
--skins2-last=<string> Skin to use
Path to the skin to use.
--skins2-config=<string> Config of last used skin
Windows configuration of the last skin used. This option is updated
automatically, do not touch it.
--skins2-systray, --no-skins2-systray
Systray icon (default disabled)
Show a systray icon for VLC (default disabled)
--skins2-taskbar, --no-skins2-taskbar
Show VLC on the taskbar (default enabled)
Show VLC on the taskbar (default enabled)
--skins2-transparency, --no-skins2-transparency
Enable transparency effects (default disabled)
You can disable all transparency effects if you want. This is mainly
useful when moving windows does not behave correctly. (default
disabled)
--skinned-playlist, --no-skinned-playlist
Use a skinned playlist (default enabled)
Use a skinned playlist (default enabled)
--skinned-video, --no-skinned-video
Display video in a skinned window if any
(default enabled)
When set to 'no', this parameter is intended to give old skins a
chance to play back video even though no video tag is implemented
(default enabled)

Sharpen video filter
Augment contrast between contours.
--sharpen-sigma=<float [0.000000 .. 2.000000]>
Sharpen strength (0-2)
Set the Sharpen strength, between 0 and 2. Defaults to 0.05.

Screen Input
--screen-caching=<integer> Caching value in ms
Caching value for screen capture. This value should be set in
milliseconds.
--screen-fps=<float> Frame rate
Desired frame rate for the capture.
--screen-top=<integer> Subscreen top left corner
Top coordinate of the subscreen top left corner.
--screen-left=<integer> Subscreen top left corner
Left coordinate of the subscreen top left corner.
--screen-width=<integer> Subscreen width
Subscreen width
--screen-height=<integer> Subscreen height
Subscreen height
--screen-follow-mouse, --no-screen-follow-mouse
Follow the mouse (default disabled)
Follow the mouse when capturing a subscreen. (default disabled)
--screen-mouse-image=<string>
Mouse pointer image
If specified, will use the image to draw the mouse pointer on the
capture.
--screen-fragment-size=<integer>
Capture fragment size
Optimize the capture by fragmenting the screen in chunks of
predefined height (16 might be a good value, and 0 means disabled).

Scene video filter
Send your video to picture files
--scene-format=<string> Image format
Format of the output images (png, jpeg, ...).
--scene-width=<integer> Image width
You can enforce the image width. By default (-1) VLC will adapt to
the video characteristics.
--scene-height=<integer> Image height
You can enforce the image height. By default (-1) VLC will adapt to
the video characteristics.
--scene-prefix=<string> Filename prefix
Prefix of the output images filenames. Output filenames will have the
"prefixNUMBER.format" form if replace is not true.
--scene-path=<string> Directory path prefix
Directory path where images files should be saved.If not set, then
images will be automatically saved in users homedir.
--scene-replace, --no-scene-replace
Always write to the same file (default
disabled)
Always write to the same file instead of creating one file per image.
In this case, the number is not appended to the filename. (default
disabled)
--scene-ratio=<integer> Recording ratio
Ratio of images to record. 3 means that one image out of three is
recorded.

Audio tempo scaler synched with rate
--scaletempo-stride=<integer [1 .. 2000]>
Stride Length
Length in milliseconds to output each stride
--scaletempo-overlap=<float [0.000000 .. 1.000000]>
Overlap Length
Percentage of stride to overlap
--scaletempo-search=<integer [0 .. 200]>
Search Length
Length in milliseconds to search for best overlap position

Network streams (SAP)
--sap-addr=<string> SAP multicast address
The SAP module normally chooses itself the right addresses to listen
to. However, you can specify a specific address.
--sap-ipv4, --no-sap-ipv4 IPv4 SAP (default enabled)
Listen to IPv4 announcements on the standard addresses. (default
enabled)
--sap-ipv6, --no-sap-ipv6 IPv6 SAP (default enabled)
Listen to IPv6 announcements on the standard addresses. (default
enabled)
--sap-timeout=<integer> SAP timeout (seconds)
Delay after which SAP items get deleted if no new announcement is
received.
--sap-parse, --no-sap-parse
Try to parse the announce (default enabled)
This enables actual parsing of the announces by the SAP module.
Otherwise, all announcements are parsed by the "live555" (RTP/RTSP)
module. (default enabled)
--sap-strict, --no-sap-strict
SAP Strict mode (default disabled)
When this is set, the SAP parser will discard some non-compliant
announcements. (default disabled)

Real-Time Protocol (RTP) input
--rtp-caching=<integer [0 .. 65535]>
RTP de-jitter buffer length (msec)
How long to wait for late RTP packets (and delay the performance).
--rtcp-port=<integer [0 .. 65535]>
RTCP (local) port
RTCP packets will be received on this transport protocol port. If
zero, multiplexed RTP/RTCP is used.
--srtp-key=<string> SRTP key (hexadecimal)
RTP packets will be authenticated and deciphered with this Secure RTP
master shared secret key.
--srtp-salt=<string> SRTP salt (hexadecimal)
Secure RTP requires a (non-secret) master salt value.
--rtp-max-src=<integer [1 .. 255]>
Maximum RTP sources
How many distinct active RTP sources are allowed at a time.
--rtp-timeout=<integer> RTP source timeout (sec)
How long to wait for any packet before a source is expired.
--rtp-max-dropout=<integer [0 .. 32767]>
Maximum RTP sequence number dropout
RTP packets will be discarded if they are too much ahead (i.e. in the
future) by this many packets from the last received packet.
--rtp-max-misorder=<integer [0 .. 32767]>
Maximum RTP sequence number misordering
RTP packets will be discarded if they are too far behind (i.e. in the
past) by this many packets from the last received packet.

RSS and Atom feed display
Display a RSS or ATOM Feed on your video
--rss-urls=<string> Feed URLs
RSS/Atom feed '|' (pipe) separated URLs.
Position:
--rss-x=<integer> X offset
X offset, from the left screen edge.
--rss-y=<integer> Y offset
Y offset, down from the top.
--rss-position={0 (Center), 1 (Left), 2 (Right), 4 (Top), 8 (Bottom), 5 (Top-Left), 6 (Top-Right), 9 (Bottom-Left), 10 (Bottom-Right)}
Text position
You can enforce the text position on the video (0=center, 1=left,
2=right, 4=top, 8=bottom; you can also use combinations of these
values, eg 6 = top-right).
Font:
--rss-opacity=<integer [0 .. 255]>
Opacity
Opacity (inverse of transparency) of overlay text. 0 = transparent,
255 = totally opaque.
--rss-color={-268435456 (Default), 0 (Black), 8421504 (Gray), 12632256 (Silver), 16777215 (White), 8388608 (Maroon), 16711680 (Red), 16711935 (Fuchsia), 16776960 (Yellow), 8421376 (Olive), 32768 (Green), 32896 (Teal), 65280 (Lime), 8388736 (Purple), 128 (Navy), 255 (Blue), 65535 (Aqua)}
Color
Color of the text that will be rendered on the video. This must be an
hexadecimal (like HTML colors). The first two chars are for red, then
green, then blue. #000000 = black, #FF0000 = red, #00FF00 = green,
#FFFF00 = yellow (red + green), #FFFFFF = white
--rss-size=<integer> Font size, pixels
Font size, in pixels. Default is -1 (use default font size).
Misc:
--rss-speed=<integer> Speed of feeds
Speed of the RSS/Atom feeds in microseconds (bigger is slower).
--rss-length=<integer> Max length
Maximum number of characters displayed on the screen.
--rss-ttl=<integer> Refresh time
Number of seconds between each forced refresh of the feeds. 0 means
that the feeds are never updated.
--rss-images, --no-rss-images
Feed images (default enabled)
Display feed images if available. (default enabled)
--rss-title={-1 (Default), 0 (Don't show), 1 (Always visible), 2 (Scroll with feed)}
Title display mode
Title display mode. Default is 0 (hidden) if the feed has an image
and feed images are enabled, 1 otherwise.

Rotate video filter
--rotate-angle=<integer [0 .. 359]>
Angle in degrees
Angle in degrees (0 to 359)

Remote-OSD over VNC
--rmtosd-host=<string> VNC Host
VNC hostname or IP address.
--rmtosd-port=<integer [1 .. 65535]>
VNC Port
VNC portnumber.
--rmtosd-password=<string> VNC Password
VNC password.
--rmtosd-update=<integer [200 .. 300]>
VNC poll interval
In this interval an update from VNC is requested, default every 300
ms.
--rmtosd-vnc-polling, --no-rmtosd-vnc-polling
VNC polling (default disabled)
Activate VNC polling. Do NOT activate for use as VDR ffnetdev client.
(default disabled)
--rmtosd-mouse-events, --no-rmtosd-mouse-events
Mouse events (default disabled)
Send mouse events to VNC host. Not needed for use as VDR ffnetdev
client. (default disabled)
--rmtosd-key-events, --no-rmtosd-key-events
Key events (default disabled)
Send key events to VNC host. (default disabled)
--rmtosd-alpha=<integer [0 .. 255]>
Alpha transparency value (default 255)
The transparency of the OSD VNC can be changed by giving a value
between 0 and 255. A lower value specifies more transparency a higher
means less transparency. The default is being not transparent (value
255) the minimum is fully transparent (value 0).

Raw video demuxer
--rawvid-fps=<string> Frames per Second
This is the desired frame rate when playing raw video streams. In
the form 30000/1001 or 29.97
--rawvid-width=<integer> Width
This specifies the width in pixels of the raw video stream.
--rawvid-height=<integer> Height
This specifies the height in pixels of the raw video stream.
--rawvid-chroma=<string> Force chroma (Use carefully)
Force chroma. This is a four character string.
--rawvid-aspect-ratio=<string>
Aspect ratio
Aspect ratio (4:3, 16:9). Default assumes square pixels.

DV (Digital Video) demuxer
--rawdv-hurry-up, --no-rawdv-hurry-up
Hurry up (default disabled)
The demuxer will advance timestamps if the input can't keep up with
the rate. (default disabled)

Raw audio demuxer
--rawaud-channels=<integer>
Audio channels
Audio channels in input stream. Numeric value >0. Default is 2.
--rawaud-samplerate=<integer>
Audio samplerate (Hz)
Audio sample rate in Hertz. Default is 48000 Hz.
--rawaud-fourcc=<string> FOURCC code of raw input format
FOURCC code of the raw input format. This is a four character string.
--rawaud-lang=<string> Forces the audio language
Forces the audio language for the output mux. Three letter ISO639
code. Default is 'eng'.

Qt interface
--qt-minimal-view, --no-qt-minimal-view
Start in minimal view (without menus)
(default disabled)
Start in minimal view (without menus) (default disabled)
--qt-notification, --no-qt-notification
Show notification popup on track change
(default enabled)
Show a notification popup with the artist and track name when the
current playlist item changes, when VLC is minimized or hidden.
(default enabled)
--qt-opacity=<float [0.100000 .. 1.000000]>
Windows opacity between 0.1 and 1
Sets the windows opacity between 0.1 and 1 for main interface,
playlist and extended panel. This option only works with Windows and
X11 with composite extensions.
--qt-fs-opacity=<float [0.100000 .. 1.000000]>
Fullscreen controller opacity between 0.1 and
1
Sets the fullscreen controller opacity between 0.1 and 1 for main
interface, playlist and extended panel. This option only works with
Windows and X11 with composite extensions.
--qt-system-tray, --no-qt-system-tray
Systray icon (default enabled)
Show an icon in the systray allowing you to control VLC media player
for basic actions. (default enabled)
--qt-start-minimized, --no-qt-start-minimized
Start VLC with only a systray icon (default
disabled)
VLC will start with just an icon in your taskbar (default disabled)
--qt-video-autoresize, --no-qt-video-autoresize
Resize interface to the native video size
(default enabled)
You have two choices:
- The interface will resize to the native
video size
- The video will fit to the interface size
By default,
interface resize to the native video size. (default enabled)
--qt-name-in-title, --no-qt-name-in-title
Show playing item name in window title
(default enabled)
Show the name of the song or video in the controler window title.
(default enabled)
--qt-fs-controller, --no-qt-fs-controller
Show a controller in fullscreen mode (default
enabled)
Show a controller in fullscreen mode (default enabled)
--qt-volume-complete, --no-qt-volume-complete
Allow the volume to be set to 400% (default
disabled)
Allow the volume to have range from 0% to 400%, instead of 0% to
200%. This option can distort the audio, since it uses software
amplification. (default disabled)
--qt-autosave-volume, --no-qt-autosave-volume
Automatically save the volume on exit
(default disabled)
Automatically save the volume on exit (default disabled)
--qt-embedded-open, --no-qt-embedded-open
Embed the file browser in open dialog
(default disabled)
Embed the file browser in open dialog (default disabled)
--qt-recentplay, --no-qt-recentplay
Save the recently played items in the menu
(default enabled)
Save the recently played items in the menu (default enabled)
--qt-recentplay-filter=<string>
List of words separated by | to filter
Regular expression used to filter the recent items played in the
player
--qt-adv-options, --no-qt-adv-options
Advanced options (default disabled)
Show all the advanced options in the dialogs. (default disabled)
--qt-advanced-pref, --no-qt-advanced-pref
Show advanced preferences over simple ones
(default disabled)
Show advanced preferences and not simple preferences when opening the
preferences dialog. (default disabled)
--qt-error-dialogs, --no-qt-error-dialogs
Show unimportant error and warnings dialogs
(default enabled)
Show unimportant error and warnings dialogs (default enabled)
--qt-updates-notif, --no-qt-updates-notif
Activate the updates availability
notification (default enabled)
Activate the automatic notification of new versions of the software.
It runs once every two weeks. (default enabled)
--qt-updates-days=<integer>
Number of days between two update checks
Number of days between two update checks
--qt-slider-colours=<string>
Define the colors of the volume slider
Define the colors of the volume slider
By specifying the 12 numbers
separated by a ';'
Default is '255;255;255;20;226;20;255;176;15;235;30
;20'
An alternative can be '30;30;50;40;40;100;50;50;160;150;150;255'
--qt-privacy-ask, --no-qt-privacy-ask
Ask for network policy at start (default
enabled)
Ask for network policy at start (default enabled)
--qt-fullscreen-screennumber=<integer>
Define which screen fullscreen goes
Screennumber of fullscreen, instead ofsame screen where interface is
--qt-autoload-extensions, --no-qt-autoload-extensions
Load extensions on startup (default enabled)
Automatically load the extensions module on startup (default enabled)

Puzzle interactive game video filter
--puzzle-rows=<integer [2 .. 16]>
Number of puzzle rows
Number of puzzle rows
--puzzle-cols=<integer [2 .. 16]>
Number of puzzle columns
Number of puzzle columns
--puzzle-black-slot, --no-puzzle-black-slot
Make one tile a black slot (default disabled)
Make one slot black. Other tiles can only be swapped with the black
slot. (default disabled)

MPEG-PS demuxer
--ps-trust-timestamps, --no-ps-trust-timestamps
Trust MPEG timestamps (default enabled)
Normally we use the timestamps of the MPEG files to calculate
position and duration. However sometimes this might not be usable.
Disable this option to calculate from the bitrate instead. (default
enabled)

Video post processing filter
--postproc-q=<integer [0 .. 6]>
Post processing quality
Quality of post processing. Valid range is 0 to 6
Higher levels
require considerable more CPU power, but produce better looking
pictures.
--postproc-name=<string> FFmpeg post processing filter chains
FFmpeg post processing filter chains

PORTAUDIO audio output
--portaudio-audio-device=<integer>
Output device
Portaudio identifier for the output device

Podcasts
--podcast-urls=<string> Podcast URLs list
Enter the list of podcasts to retrieve, separated by '|' (pipe).

Playlist
--playlist-autostart, --no-playlist-autostart
Auto start (default enabled)
Automatically start playing the playlist content once it's loaded.
(default enabled)
--playlist-skip-ads, --no-playlist-skip-ads
Skip ads (default enabled)
Use playlist options usually used to prevent ads skipping to detect
ads and prevent adding them to the playlist. (default enabled)
--shoutcast-show-adult, --no-shoutcast-show-adult
Show shoutcast adult content (default
disabled)
Show NC17 rated video streams when using shoutcast video playlists.
(default disabled)

Parametric Equalizer
--param-eq-lowf=<float> Low freq (Hz)
--param-eq-lowgain=<float [-20.000000 .. 20.000000]>
Low freq gain (dB)
--param-eq-highf=<float> High freq (Hz)
--param-eq-highgain=<float [-20.000000 .. 20.000000]>
High freq gain (dB)
--param-eq-f1=<float> Freq 1 (Hz)
--param-eq-gain1=<float [-20.000000 .. 20.000000]>
Freq 1 gain (dB)
--param-eq-q1=<float [0.100000 .. 100.000000]>
Freq 1 Q
--param-eq-f2=<float> Freq 2 (Hz)
--param-eq-gain2=<float [-20.000000 .. 20.000000]>
Freq 2 gain (dB)
--param-eq-q2=<float [0.100000 .. 100.000000]>
Freq 2 Q
--param-eq-f3=<float> Freq 3 (Hz)
--param-eq-gain3=<float [-20.000000 .. 20.000000]>
Freq 3 gain (dB)
--param-eq-q3=<float [0.100000 .. 100.000000]>
Freq 3 Q

Panoramix: wall with overlap video filter
Split the video in multiple windows to display on a wall of screens
--panoramix-cols=<integer> Number of columns
Select the number of horizontal video windows in which to split the
video
--panoramix-rows=<integer> Number of rows
Select the number of vertical video windows in which to split the
video
--panoramix-bz-length=<integer [0 .. 100]>
length of the overlapping area (in %)
Select in percent the length of the blended zone
--panoramix-bz-height=<integer [0 .. 100]>
height of the overlapping area (in %)
Select in percent the height of the blended zone (case of 2x2 wall)
--panoramix-attenuate, --no-panoramix-attenuate
Attenuation (default enabled)
Check this option if you want attenuate blended zone by this plug-in
(if option is unchecked, attenuate is made by opengl) (default
enabled)
--panoramix-bz-begin=<integer [0 .. 100]>
Attenuation, begin (in %)
Select in percent the Lagrange coeff of the beginning blended zone
--panoramix-bz-middle=<integer [0 .. 100]>
Attenuation, middle (in %)
Select in percent the Lagrange coeff of the middle of blended zone
--panoramix-bz-end=<integer [0 .. 100]>
Attenuation, end (in %)
Select in percent the Lagrange coeff of the end of blended zone
--panoramix-bz-middle-pos=<integer [1 .. 99]>
middle position (in %)
Select in percent (50 is center) the position of the middle point
(Lagrange) of blended zone
--panoramix-bz-gamma-red=<float [0.000000 .. 5.000000]>
Gamma (Red) correction
Select the gamma for the correction of blended zone (Red or Y
component)
--panoramix-bz-gamma-green=<float [0.000000 .. 5.000000]>
Gamma (Green) correction
Select the gamma for the correction of blended zone (Green or U
component)
--panoramix-bz-gamma-blue=<float [0.000000 .. 5.000000]>
Gamma (Blue) correction
Select the gamma for the correction of blended zone (Blue or V
component)
--panoramix-bz-blackcrush-red=<integer [0 .. 255]>
Black Crush for Red
Select the Black Crush of blended zone (Red or Y component)
--panoramix-bz-blackcrush-green=<integer [0 .. 255]>
Black Crush for Green
Select the Black Crush of blended zone (Green or U component)
--panoramix-bz-blackcrush-blue=<integer [0 .. 255]>
Black Crush for Blue
Select the Black Crush of blended zone (Blue or V component)
--panoramix-bz-whitecrush-red=<integer [0 .. 255]>
White Crush for Red
Select the White Crush of blended zone (Red or Y component)
--panoramix-bz-whitecrush-green=<integer [0 .. 255]>
White Crush for Green
Select the White Crush of blended zone (Green or U component)
--panoramix-bz-whitecrush-blue=<integer [0 .. 255]>
White Crush for Blue
Select the White Crush of blended zone (Blue or V component)
--panoramix-bz-blacklevel-red=<integer [0 .. 255]>
Black Level for Red
Select the Black Level of blended zone (Red or Y component)
--panoramix-bz-blacklevel-green=<integer [0 .. 255]>
Black Level for Green
Select the Black Level of blended zone (Green or U component)
--panoramix-bz-blacklevel-blue=<integer [0 .. 255]>
Black Level for Blue
Select the Black Level of blended zone (Blue or V component)
--panoramix-bz-whitelevel-red=<integer [0 .. 255]>
White Level for Red
Select the White Level of blended zone (Red or Y component)
--panoramix-bz-whitelevel-green=<integer [0 .. 255]>
White Level for Green
Select the White Level of blended zone (Green or U component)
--panoramix-bz-whitelevel-blue=<integer [0 .. 255]>
White Level for Blue
Select the White Level of blended zone (Blue or V component)
--panoramix-active=<string>
Active windows
Comma separated list of active windows, defaults to all

MPEG-I/II video packetizer
--packetizer-mpegvideo-sync-iframe, --no-packetizer-mpegvideo-sync-iframe
Sync on Intra Frame (default disabled)
Normally the packetizer would sync on the next full frame. This flags
instructs the packetizer to sync on the first Intra Frame found.
(default disabled)

On Screen Display menu
--osdmenu-x=<integer> X coordinate
You can move the OSD menu by left-clicking on it.
--osdmenu-y=<integer> Y coordinate
You can move the OSD menu by left-clicking on it.
--osdmenu-position={0 (Center), 1 (Left), 2 (Right), 4 (Top), 8 (Bottom), 5 (Top-Left), 6 (Top-Right), 9 (Bottom-Left), 10 (Bottom-Right)}
Menu position
You can enforce the OSD menu position on the video (0=center, 1=left,
2=right, 4=top, 8=bottom, you can also use combinations of these
values, eg. 6 = top-right).
--osdmenu-file=<string> Configuration file
Configuration file for the OSD Menu.
--osdmenu-file-path=<string>
Path to OSD menu images
Path to the OSD menu images. This will override the path defined in
the OSD configuration file.
--osdmenu-timeout=<integer>
Menu timeout
OSD menu pictures get a default timeout of 15 seconds added to their
remaining time. This will ensure that they are at least the specified
time visible.
--osdmenu-update=<integer [0 .. 1000]>
Menu update interval
The default is to update the OSD menu picture every 200 ms. Shorten
the update time for environments that experience transmissions
errors. Be careful with this option as encoding OSD menu pictures is
very computing intensive. The range is 0 - 1000 ms.
--osdmenu-alpha=<integer [0 .. 255]>
Alpha transparency value (default 255)
The transparency of the OSD menu can be changed by giving a value
between 0 and 255. A lower value specifies more transparency a higher
means less transparency. The default is being not transparent (value
255) the minimum is fully transparent (value 0).

VLM remote control interface
--telnet-host=<string> Host
This is the host on which the interface will listen. It defaults to
all network interfaces (0.0.0.0). If you want this interface to be
available only on the local machine, enter "127.0.0.1".
--telnet-port=<integer> Port
This is the TCP port on which this interface will listen. It defaults
to 4212.
--telnet-password=<string> Password
A single administration password is used to protect this interface.
The default value is "admin".

Remote control interface
--rc-show-pos, --no-rc-show-pos
Show stream position (default disabled)
Show the current position in seconds within the stream from time to
time. (default disabled)
--rc-quiet, --no-rc-quiet Do not open a DOS command box interface
(default disabled)
By default the rc interface plugin will start a DOS command box.
Enabling the quiet mode will not bring this command box but can also
be pretty annoying when you want to stop VLC and no video window is
open. (default disabled)
--rc-host=<string> TCP command input
Accept commands over a socket rather than stdin. You can set the
address and port the interface will bind to.

HTTP remote control interface
--http-host=<string> Host address
Address and port the HTTP interface will listen on. It defaults to
all network interfaces (0.0.0.0). If you want the HTTP interface to
be available only on the local machine, enter 127.0.0.1
--http-src=<string> Source directory
Source directory
--http-handlers=<string> Handlers
List of handler extensions and executable paths (for instance:
php=/usr/bin/php,pl=/usr/bin/perl).
--http-album-art, --no-http-album-art
Export album art as /art (default disabled)
Allow exporting album art for current playlist items at the /art and
/art?id=<id> URLs. (default disabled)
HTTP SSL:
--http-intf-cert=<string> Certificate file
HTTP interface x509 PEM certificate file (enables SSL).
--http-intf-key=<string> Private key file
HTTP interface x509 PEM private key file.
--http-intf-ca=<string> Root CA file
HTTP interface x509 PEM trusted root CA certificates file.
--http-intf-crl=<string> CRL file
HTTP interace Certificates Revocation List file.

Windows Service interface
--ntservice-install, --no-ntservice-install
Install Windows Service (default disabled)
Install the Service and exit. (default disabled)
--ntservice-uninstall, --no-ntservice-uninstall
Uninstall Windows Service (default disabled)
Uninstall the Service and exit. (default disabled)
--ntservice-name=<string> Display name of the Service
Change the display name of the Service.
--ntservice-options=<string>
Configuration options
Configuration options that will be used by the Service (eg. --foo=bar
--no-foobar). It should be specified at install time so the Service
is properly configured.
--ntservice-extraintf=<string>
Extra interface modules
Additional interfaces spawned by the Service. It should be specified
at install time so the Service is properly configured. Use a comma
separated list of interface modules. (common values are: logger, sap,
rc, http)

Volume normalizer
--norm-buff-size=<integer> Number of audio buffers
This is the number of audio buffers on which the power measurement is
made. A higher number of buffers will increase the response time of
the filter to a spike but will make it less sensitive to short
variations.
--norm-max-level=<float> Maximal volume level
If the average power over the last N buffers is higher than this
value, the volume will be normalized. This value is a positive
floating point number. A value between 0.5 and 10 seems sensible.

Network synchronisation
--netsync-master, --no-netsync-master
Network master clock (default disabled)
When set then this vlc instance shall dictate its clock for
synchronisationover clients listening on the masters network ip
address (default disabled)
--netsync-master-ip=<string>
Master server ip address
The IP address of the network master clock to use for clock
synchronisation.
--netsync-timeout=<integer>
UDP timeout (in ms)
Amount of time (in ms) to wait before aborting network reception of
data.

TS muxer (libdvbpsi)
--sout-ts-pid-video=<integer>
Video PID
Assign a fixed PID to the video stream. The PCR PID will
automatically be the video.
--sout-ts-pid-audio=<integer>
Audio PID
Assign a fixed PID to the audio stream.
--sout-ts-pid-spu=<integer>
SPU PID
Assign a fixed PID to the SPU.
--sout-ts-pid-pmt=<integer>
PMT PID
Assign a fixed PID to the PMT
--sout-ts-tsid=<integer> TS ID
Assign a fixed Transport Stream ID.
--sout-ts-netid=<integer> NET ID
Assign a fixed Network ID (for SDT table)
--sout-ts-program-pmt=<string>
PMT Program numbers
Assign a program number to each PMT. This requires "Set PID to ID of
ES" to be enabled.
--sout-ts-es-id-pid, --no-sout-ts-es-id-pid
Set PID to ID of ES (default disabled)
Sets PID to the ID if the incoming ES. This is for use with
--ts-es-id-pid, and allows to have the same PIDs in the input and
output streams. (default disabled)
--sout-ts-muxpmt=<string> Mux PMT (requires --sout-ts-es-id-pid)
Define the pids to add to each pmt. This requires "Set PID to ID of
ES" to be enabled.
--sout-ts-sdtdesc=<string> SDT Descriptors (requires --sout-ts-es-id-pid)
Defines the descriptors of each SDT. Thisrequires "Set PID to ID of
ES" to be enabled.
--sout-ts-alignment, --no-sout-ts-alignment
Data alignment (default enabled)
Enforces alignment of all access units on PES boundaries. Disabling
this might save some bandwidth but introduce incompatibilities.
(default enabled)
--sout-ts-shaping=<integer>
Shaping delay (ms)
Cut the stream in slices of the given duration, and ensure a constant
bitrate between the two boundaries. This avoids having huge bitrate
peaks, especially for reference frames.
--sout-ts-use-key-frames, --no-sout-ts-use-key-frames
Use keyframes (default disabled)
If enabled, and shaping is specified, the TS muxer will place the
boundaries at the end of I pictures. In that case, the shaping
duration given by the user is a worse case used when no reference
frame is available. This enhances the efficiency of the shaping
algorithm, since I frames are usually the biggest frames in the
stream. (default disabled)
--sout-ts-pcr=<integer> PCR interval (ms)
Set at which interval PCRs (Program Clock Reference) will be sent (in
milliseconds). This value should be below 100ms. (default is 70ms).
--sout-ts-bmin=<integer> Minimum B (deprecated)
This setting is deprecated and not used anymore
--sout-ts-bmax=<integer> Maximum B (deprecated)
This setting is deprecated and not used anymore
--sout-ts-dts-delay=<integer>
DTS delay (ms)
Delay the DTS (decoding time stamps) and PTS (presentation
timestamps) of the data in the stream, compared to the PCRs. This
allows for some buffering inside the client decoder.
--sout-ts-crypt-audio, --no-sout-ts-crypt-audio
Crypt audio (default enabled)
Crypt audio using CSA (default enabled)
--sout-ts-crypt-video, --no-sout-ts-crypt-video
Crypt video (default enabled)
Crypt video using CSA (default enabled)
--sout-ts-csa-ck=<string> CSA Key
CSA encryption key. This must be a 16 char string (8 hexadecimal
bytes).
--sout-ts-csa2-ck=<string> Second CSA Key
The even CSA encryption key. This must be a 16 char string (8
hexadecimal bytes).
--sout-ts-csa-use=<string> CSA Key in use
CSA encryption key used. It can be the odd/first/1 (default) or the
even/second/2 one.
--sout-ts-csa-pkt=<integer>
Packet size in bytes to encrypt
Size of the TS packet to encrypt. The encryption routines subtract
the TS-header from the value before encrypting.

PS muxer
--sout-ps-dts-delay=<integer>
DTS delay (ms)
Delay the DTS (decoding time stamps) and PTS (presentation
timestamps) of the data in the stream, compared to the SCRs. This
allows for some buffering inside the client decoder.
--sout-ps-pes-max-size=<integer>
PES maximum size
Set the maximum allowed PES size when producing the MPEG PS streams.

Multipart JPEG muxer

MP4/MOV muxer
--sout-mp4-faststart, --no-sout-mp4-faststart
Create "Fast Start" files (default enabled)
Create "Fast Start" files. "Fast Start" files are optimized for
downloads and allow the user to start previewing the file while it is
downloading. (default enabled)

ASF muxer
--sout-asf-title=<string> Title
Title to put in ASF comments.
--sout-asf-author=<string> Author
Author to put in ASF comments.
--sout-asf-copyright=<string>
Copyright
Copyright string to put in ASF comments.
--sout-asf-comment=<string>
Comment
Comment to put in ASF comments.
--sout-asf-rating=<string> Rating
"Rating" to put in ASF comments.
--sout-asf-packet-size=<integer>
Packet Size
ASF packet size -- default is 4096 bytes
--sout-asf-bitrate-override=<integer>
Bitrate override
Do not try to guess ASF bitrate. Setting this, allows you to control
how Windows Media Player will cache streamed content. Set to
audio+video bitrate in bytes

MSN Now-Playing
--msn-format=<string> Title format string
Format of the string to send to MSN {0} Artist, {1} Title, {2} Album.
Defaults to "Artist - Title" ({0} - {1}).

Motion blur filter
--blur-factor=<integer [1 .. 127]>
Blur factor (1-127)
The degree of blurring from 1 to 127.

Mosaic video sub filter
--mosaic-alpha=<integer [0 .. 255]>
Transparency
Transparency of the mosaic foreground pictures. 0 means transparent,
255 opaque (default).
--mosaic-height=<integer> Height
Total height of the mosaic, in pixels.
--mosaic-width=<integer> Width
Total width of the mosaic, in pixels.
--mosaic-align={0 (Center), 1 (Left), 2 (Right), 4 (Top), 8 (Bottom), 5 (Top-Left), 6 (Top-Right), 9 (Bottom-Left), 10 (Bottom-Right)}
Mosaic alignment
You can enforce the mosaic alignment on the video (0=center, 1=left,
2=right, 4=top, 8=bottom, you can also use combinations of these
values, eg 6 = top-right).
--mosaic-xoffset=<integer> Top left corner X coordinate
X Coordinate of the top-left corner of the mosaic.
--mosaic-yoffset=<integer> Top left corner Y coordinate
Y Coordinate of the top-left corner of the mosaic.
--mosaic-borderw=<integer> Border width
Width in pixels of the border between miniatures.
--mosaic-borderh=<integer> Border height
Height in pixels of the border between miniatures.
--mosaic-position={0 (auto), 1 (fixed), 2 (offsets)}
Positioning method
Positioning method for the mosaic. auto: automatically choose the
best number of rows and columns. fixed: use the user-defined number
of rows and columns. offsets: use the user-defined offsets for each
image.
--mosaic-rows=<integer> Number of rows
Number of image rows in the mosaic (only used if positionning method
is set to "fixed").
--mosaic-cols=<integer> Number of columns
Number of image columns in the mosaic (only used if positionning
method is set to "fixed".
--mosaic-keep-aspect-ratio, --no-mosaic-keep-aspect-ratio
Keep aspect ratio (default disabled)
Keep the original aspect ratio when resizing mosaic elements.
(default disabled)
--mosaic-keep-picture, --no-mosaic-keep-picture
Keep original size (default disabled)
Keep the original size of mosaic elements. (default disabled)
--mosaic-order=<string> Elements order
You can enforce the order of the elements on the mosaic. You must
give a comma-separated list of picture ID(s).These IDs are assigned
in the "mosaic-bridge" module.
--mosaic-offsets=<string> Offsets in order
You can enforce the (x,y) offsets of the elements on the mosaic (only
used if positioning method is set to "offsets"). You must give a
comma-separated list of coordinates (eg: 10,10,150,10).
--mosaic-delay=<integer> Delay
Pictures coming from the mosaic elements will be delayed according to
this value (in milliseconds). For high values you will need to raise
caching at input.
</nowiki>
Part 2/2
<nowiki>
Audio filter for stereo to mono conversion
--sout-mono-downmix, --no-sout-mono-downmix
Use downmix algorithm (default enabled)
This option selects a stereo to mono downmix algorithm that is used
in the headphone channel mixer. It gives the effect of standing in a
room full of speakers. (default enabled)
--sout-mono-channel={0 (Left), 1 (Right), 2 (Left rear), 4 (Right rear), 8 (Center), 5 (Left front)}
Select channel to keep
This option silences all other channels except the selected channel.
Choose one from (0=left, 1=right, 2=rear left, 3=rear right,
4=center, 5=left front)

MOD demuxer (libmodplug)
--mod-noisereduction, --no-mod-noisereduction
Noise reduction (default enabled)
Enable noise reduction algorithm. (default enabled)
--mod-reverb, --no-mod-reverb
Reverb (default disabled)
Enable reverberation (default disabled)
--mod-reverb-level=<integer [0 .. 100]>
Reverberation level
Reverberation level (from 0 to 100, default value is 0).
--mod-reverb-delay=<integer [0 .. 1000]>
Reverberation delay
Reverberation delay, in ms. Usual values are from to 40 to 200ms.
--mod-megabass, --no-mod-megabass
Mega bass (default disabled)
Enable megabass mode (default disabled)
--mod-megabass-level=<integer [0 .. 100]>
Mega bass level
Megabass mode level (from 0 to 100, default value is 0).
--mod-megabass-range=<integer [10 .. 100]>
Mega bass cutoff
Megabass mode cutoff frequency, in Hz. This is the maximum frequency
for which the megabass effect applies. Valid values are from 10 to
100 Hz.
--mod-surround, --no-mod-surround
Surround (default disabled)
Surround (default disabled)
--mod-surround-level=<integer [0 .. 100]>
Surround level
Surround effect level (from 0 to 100, default value is 0).
--mod-surround-delay=<integer [0 .. 1000]>
Surround delay (ms)
Surround delay, in ms. Usual values are from 5 to 40 ms.

Matroska stream demuxer
--mkv-use-ordered-chapters, --no-mkv-use-ordered-chapters
Ordered chapters (default enabled)
Play ordered chapters as specified in the segment. (default enabled)
--mkv-use-chapter-codec, --no-mkv-use-chapter-codec
Chapter codecs (default enabled)
Use chapter codecs found in the segment. (default enabled)
--mkv-preload-local-dir, --no-mkv-preload-local-dir
Preload Directory (default disabled)
Preload matroska files from the same family in the same directory
(not good for broken files). (default disabled)
--mkv-seek-percent, --no-mkv-seek-percent
Seek based on percent not time (default
disabled)
Seek based on percent not time. (default disabled)
--mkv-use-dummy, --no-mkv-use-dummy
Dummy Elements (default disabled)
Read and discard unknown EBML elements (not good for broken files).
(default disabled)

M-JPEG camera demuxer
--mjpeg-fps=<float> Frames per Second
This is the desired frame rate when playing MJPEG from a file. Use 0
(this is the default value) for a live stream (from a camera).

Mirror video filter
Splits video in two same parts, like in a mirror
--mirror-split={0 (Vertical), 1 (Horizontal)}
Mirror orientation
Defines orientation of the mirror splitting. Can be vertical or
horizontal
--mirror-direction={0 (Left to right/Top to bottom), 1 (Right to left/Bottom to top)}
Direction
Direction of the mirroring

Marquee display
Display text above the video
--marq-marquee=<string> Text
Marquee text to display. (Available format strings: Time related: %Y
= year, %m = month, %d = day, %H = hour, %M = minute, %S = second,
... Meta data related: $a = artist, $b = album, $c = copyright, $d =
description, $e = encoded by, $g = genre, $l = language, $n = track
num, $p = now playing, $r = rating, $s = subtitles language, $t =
title, $u = url, $A = date, $B = audio bitrate (in kb/s), $C =
chapter,$D = duration, $F = full name with path, $I = title, $L =
time left, $N = name, $O = audio language, $P = position (in %), $R =
rate, $S = audio sample rate (in kHz), $T = time, $U = publisher, $V
= volume, $_ = new line)
Position:
--marq-x=<integer> X offset
X offset, from the left screen edge.
--marq-y=<integer> Y offset
Y offset, down from the top.
--marq-position={0 (Center), 1 (Left), 2 (Right), 4 (Top), 8 (Bottom), 5 (Top-Left), 6 (Top-Right), 9 (Bottom-Left), 10 (Bottom-Right)}
Marquee position
You can enforce the marquee position on the video (0=center, 1=left,
2=right, 4=top, 8=bottom, you can also use combinations of these
values, eg 6 = top-right).
Font:
--marq-opacity=<integer [0 .. 255]>
Opacity
Opacity (inverse of transparency) of overlayed text. 0 = transparent,
255 = totally opaque.
--marq-color={-268435456 (Default), 0 (Black), 8421504 (Gray), 12632256 (Silver), 16777215 (White), 8388608 (Maroon), 16711680 (Red), 16711935 (Fuchsia), 16776960 (Yellow), 8421376 (Olive), 32768 (Green), 32896 (Teal), 65280 (Lime), 8388736 (Purple), 128 (Navy), 255 (Blue), 65535 (Aqua)}
Color
Color of the text that will be rendered on the video. This must be an
hexadecimal (like HTML colors). The first two chars are for red, then
green, then blue. #000000 = black, #FF0000 = red, #00FF00 = green,
#FFFF00 = yellow (red + green), #FFFFFF = white
--marq-size=<integer> Font size, pixels
Font size, in pixels. Default is -1 (use default font size).
Misc:
--marq-timeout=<integer> Timeout
Number of milliseconds the marquee must remain displayed. Default
value is 0 (remains forever).
--marq-refresh=<integer> Refresh period in ms
Number of milliseconds between string updates. This is mainly useful
when using meta data or time format string sequences.

Interfaces implemented using lua scripts
--lua-intf=<string> Lua interface
Lua interface module to load
--lua-config=<string> Lua interface configuration
Lua interface configuration string. Format is: '["<interface module
name>"] = { <option> = <value>, ...}, ...'.
Lua HTTP:
--http-host=<string> Host address
Address and port the HTTP interface will listen on. It defaults to
all network interfaces (0.0.0.0). If you want the HTTP interface to
be available only on the local machine, enter 127.0.0.1
--http-src=<string> Source directory
Source directory
--http-index, --no-http-index
Directory index (default disabled)
Allow to build directory index (default disabled)
Lua Telnet:
--telnet-host=<string> Host
This is the host on which the interface will listen. It defaults to
all network interfaces (0.0.0.0). If you want this interface to be
available only on the local machine, enter "127.0.0.1".
--telnet-port=<integer> Port
This is the TCP port on which this interface will listen. It defaults
to 4212.
--telnet-password=<string> Password
A single administration password is used to protect this interface.
The default value is "admin".
--lua-sd=<string> (null)
--lua-longname=<string> (null)

Logo sub filter
Use a local picture as logo on the video
--logo-file=<string> Logo filenames
Full path of the image files to use. Format is <image>[,<delay in
ms>[,<alpha>]][;<image>[,<delay>[,<alpha>]]][;...]. If you only have
one file, simply enter its filename.
--logo-x=<integer> X coordinate
X coordinate of the logo. You can move the logo by left-clicking it.
--logo-y=<integer> Y coordinate
Y coordinate of the logo. You can move the logo by left-clicking it.
--logo-delay=<integer> Logo individual image time in ms
Individual image display time of 0 - 60000 ms.
--logo-repeat=<integer> Logo animation # of loops
Number of loops for the logo animation.-1 = continuous, 0 = disabled
--logo-opacity=<integer [0 .. 255]>
Opacity of the logo
Logo opacity value (from 0 for full transparency to 255 for full
opacity).
--logo-position={0 (Center), 1 (Left), 2 (Right), 4 (Top), 8 (Bottom), 5 (Top-Left), 6 (Top-Right), 9 (Bottom-Left), 10 (Bottom-Right)}
Logo position
Enforce the logo position on the video (0=center, 1=left, 2=right,
4=top, 8=bottom, you can also use combinations of these values, eg 6
= top-right).

File logging
--logfile=<string> Log filename
Specify the log filename.
--logmode={text,html} Log format
Specify the log format. Available choices are "text" (default) and
"html".
--log-verbose=<integer> Verbosity
Select the verbosity to use for log or -1 to use the same verbosity
given by --verbose.

RTP/RTSP/SDP demuxer (using Live555)
--rtsp-tcp, --no-rtsp-tcp Use RTP over RTSP (TCP) (default disabled)
Use RTP over RTSP (TCP) (default disabled)
--rtp-client-port=<integer>
Client port
Port to use for the RTP source of the session
--rtsp-mcast, --no-rtsp-mcast
Force multicast RTP via RTSP (default
disabled)
Force multicast RTP via RTSP (default disabled)
--rtsp-http, --no-rtsp-http
Tunnel RTSP and RTP over HTTP (default
disabled)
Tunnel RTSP and RTP over HTTP (default disabled)
--rtsp-http-port=<integer> HTTP tunnel port
Port to use for tunneling the RTSP/RTP over HTTP.
--rtsp-caching=<integer> Caching value (ms)
Allows you to modify the default caching value for RTSP streams. This
value should be set in millisecond units.
--rtsp-kasenna, --no-rtsp-kasenna
Kasenna RTSP dialect (default disabled)
Kasenna servers use an old and nonstandard dialect of RTSP. With this
parameter VLC will try this dialect, but then it cannot connect to
normal RTSP servers. (default disabled)
--rtsp-wmserver, --no-rtsp-wmserver
WMServer RTSP dialect (default disabled)
WMServer uses an unstandard dialect of RTSP. Selecting this parameter
will tell VLC to assume some options contrary to RFC 2326 guidelines.
(default disabled)
--rtsp-user=<string> RTSP user name
Sets the username for the connection, if no username or password are
set in the url.
--rtsp-pwd=<string> RTSP password
Sets the password for the connection, if no username or password are
set in the url.

Kate overlay decoder
Kate is a codec for text and image based overlays.
The Tiger rendering library is needed to render complex Kate streams, but VLC can still render static text and image based subtitles if it is not available.
Note that changing settings below will not take effect until a new stream is played. This will hopefully be fixed soon.
--kate-formatted, --no-kate-formatted
Formatted Subtitles (default enabled)
Kate streams allow for text formatting. VLC partly implements this,
but you can choose to disable all formatting.Note that this has no
effect is rendering via Tiger is enabled. (default enabled)

Memory video decoder
--invmem-width=<integer> Width
Video memory buffer width.
--invmem-height=<integer> Height
Video memory buffer height.
--invmem-lock=<string> Lock function
Address of the locking callback function. This function must return a
valid memory address for use by the video renderer.
--invmem-unlock=<string> Unlock function
Address of the unlocking callback function
--invmem-data=<string> Callback data
Data for the locking and unlocking functions
--invmem-chroma=<string> Chroma
Output chroma for the memory image as a 4-character string, eg.
"RV32".

Hotkeys management interface
--hotkeys-mousewheel-mode={0 (Volume Control), 1 (Position Control), 2 (Ignore)}
MouseWheel x-axis Control
MouseWheel x-axis can control volume, position or mousewheel event
can be ignored

Headphone virtual spatialization effect
This effect gives you the feeling that you are standing in a room with a complete 7.1 speaker set when using only a headphone, providing a more realistic sound experience. It should also be more comfortable and less tiring when listening to music for long periods of time.
It works with any source format from mono to 7.1.
--headphone-dim=<integer> Characteristic dimension
Distance between front left speaker and listener in meters.
--headphone-compensate, --no-headphone-compensate
Compensate delay (default disabled)
The delay which is introduced by the physical algorithm may sometimes
be disturbing for the synchronization between lips-movement and
speech. In case, turn this on to compensate. (default disabled)
--headphone-dolby, --no-headphone-dolby
No decoding of Dolby Surround (default
disabled)
Dolby Surround encoded streams won't be decoded before being
processed by this filter. Enabling this setting is not recommended.
(default disabled)

H264 video demuxer
--h264-fps=<float> Frames per Second
Desired frame rate for the H264 stream.

Gradient video filter
Apply color gradient or edge detection effects
--gradient-mode={gradient,edge,hough}
Distort mode
Distort mode, one of "gradient", "edge" and "hough".
--gradient-type=<integer [0 .. 1]>
Gradient image type
Gradient image type (0 or 1). 0 will turn the image to white while 1
will keep colors.
--gradient-cartoon, --no-gradient-cartoon
Apply cartoon effect (default enabled)
Apply cartoon effect. It is only used by "gradient" and "edge".
(default enabled)

Goom effect
--goom-width=<integer> Goom display width
This allows you to set the resolution of the Goom display (bigger
resolution will be prettier but more CPU intensive).
--goom-height=<integer> Goom display height
This allows you to set the resolution of the Goom display (bigger
resolution will be prettier but more CPU intensive).
--goom-speed=<integer> Goom animation speed
This allows you to set the animation speed (between 1 and 10,
defaults to 6).

GnuTLS transport layer security
--gnutls-cache-timeout=<integer>
Expiration time for resumed TLS sessions
It is possible to cache the resumed TLS sessions. This is the
expiration time of the sessions stored in this cache, in seconds.
--gnutls-cache-size=<integer>
Number of resumed TLS sessions
This is the maximum number of resumed TLS sessions that the cache
will hold.

Mouse gestures control interface
--gestures-threshold=<integer>
Motion threshold (10-100)
Amount of movement required for a mouse gesture to be recorded.
--gestures-button={left,middle,right}
Trigger button
Trigger button for mouse gestures.

Gaussian blur video filter
Add a blurring effect
--gaussianblur-sigma=<float>
Gaussian's std deviation
Gaussian's standard deviation. The bluring will take into account
pixels up to 3*sigma away in any direction.

Freetype2 font renderer
--freetype-font=<string> Font
Font family for the font you want to use
--freetype-fontsize=<integer>
Font size in pixels
This is the default size of the fonts that will be rendered on the
video. If set to something different than 0 this option will override
the relative font size.
--freetype-opacity=<integer [0 .. 255]>
Opacity
The opacity (inverse of transparency) of the text that will be
rendered on the video. 0 = transparent, 255 = totally opaque.
--freetype-color={0 (Black), 8421504 (Gray), 12632256 (Silver), 16777215 (White), 8388608 (Maroon), 16711680 (Red), 16711935 (Fuchsia), 16776960 (Yellow), 8421376 (Olive), 32768 (Green), 32896 (Teal), 65280 (Lime), 8388736 (Purple), 128 (Navy), 255 (Blue), 65535 (Aqua)}
Text default color
The color of the text that will be rendered on the video. This must
be an hexadecimal (like HTML colors). The first two chars are for
red, then green, then blue. #000000 = black, #FF0000 = red, #00FF00 =
green, #FFFF00 = yellow (red + green), #FFFFFF = white
--freetype-rel-fontsize={20 (Smaller), 18 (Small), 16 (Normal), 12 (Large), 6 (Larger)}
Relative font size
This is the relative default size of the fonts that will be rendered
on the video. If absolute font size is set, relative size will be
overridden.
--freetype-effect={1 (Background), 2 (Outline), 3 (Fat Outline)}
Font Effect
It is possible to apply effects to the rendered text to improve its
readability.
--freetype-yuvp, --no-freetype-yuvp
Use YUVP renderer (default disabled)
This renders the font using "paletized YUV". This option is only
needed if you want to encode into DVB subtitles (default disabled)

Folder meta data
--album-art-filename=<string>
Album art filename
Filename to look for album art in current directory

FluidSynth MIDI synthetizer
--soundfont=<string> Sound fonts (required)
A sound fonts file is required for software synthesis.

File input
--file-caching=<integer> Caching value (ms)
Caching value for files, in milliseconds.
--network-caching=<integer>
Extra network caching value (ms)
Supplementary caching value for remote files, in milliseconds.
--recursive={none,collapse,expand}
Subdirectory behavior
Select whether subdirectories must be expanded.
none: subdirectories
do not appear in the playlist.
collapse: subdirectories appear but
are expanded on first play.
expand: all subdirectories are expanded.

--ignore-filetypes=<string>
Ignored extensions
Files with these extensions will not be added to playlist when
opening a directory.
This is useful if you add directories that
contain playlist files for instance. Use a comma-separated list of
extensions.

Fake video decoder
--fake-file=<string> Image file
Path of the image file for fake input.
--fake-file-reload=<integer>
Reload image file
Reload image file every n seconds.
--fake-width=<integer> Video width
Output video width.
--fake-height=<integer> Video height
Output video height.
--fake-keep-ar, --no-fake-keep-ar
Keep aspect ratio (default disabled)
Consider width and height as maximum values. (default disabled)
--fake-aspect-ratio=<string>
Background aspect ratio
Aspect ratio of the image file (4:3, 16:9). Default is square pixels.
--fake-deinterlace, --no-fake-deinterlace
Deinterlace video (default disabled)
Deinterlace the image after loading it. (default disabled)
--fake-deinterlace-module={deinterlace,ffmpeg-deinterlace}
Deinterlace module
Deinterlace module to use.
--fake-chroma=<string> Chroma used
Force use of a specific chroma for output. Default is I420.

Extract RGB component video filter
--extract-component={16711680 (Red), 65280 (Green), 255 (Blue)}
RGB component to extract
RGB component to extract. 0 for Red, 1 for Green and 2 for Blue.

MPEG-I/II/4 / A52 / DTS / MLP audio
--es-fps=<float> Frames per Second
This is the frame rate used as a fallback when playing MPEG video
elementary streams.

Erase video filter
Remove zones of the video using a picture as mask
--erase-mask=<string> Image mask
Image mask. Pixels with an alpha value greater than 50% will be
erased.
--erase-x=<integer> X coordinate
X coordinate of the mask.
--erase-y=<integer> Y coordinate
Y coordinate of the mask.

Equalizer with 10 bands
--equalizer-preset={flat,classical,club,dance,fullbass,fullbasstreble,fulltreble,headphones,largehall,live,party,pop,reggae,rock,ska,soft,softrock,techno}
Equalizer preset
Preset to use for the equalizer.
--equalizer-bands=<string> Bands gain
Don't use presets, but manually specified bands. You need to provide
10 values between -20dB and 20dB, separated by spaces, e.g. "0 2 4 2
0 -2 -4 -2 0 2".
--equalizer-2pass, --no-equalizer-2pass
Two pass (default disabled)
Filter the audio twice. This provides a more intense effect. (default
disabled)
--equalizer-preamp=<float> Global gain
Set the global gain in dB (-20 ... 20).

DVDRead Input (no menu support)
--dvdread-angle=<integer> DVD angle
Default DVD angle.
--dvdread-caching=<integer>
Caching value in ms
Caching value for DVDs. This value should be set in milliseconds.

DVDnav Input
--dvdnav-angle=<integer> DVD angle
Default DVD angle.
--dvdnav-caching=<integer> Caching value in ms
Caching value for DVDs. This value should be set in milliseconds.
--dvdnav-menu, --no-dvdnav-menu
Start directly in menu (default enabled)
Start the DVD directly in the main menu. This will try to skip all
the useless warning introductions. (default enabled)

DVB subtitles decoder
--dvbsub-position={0 (Center), 1 (Left), 2 (Right), 4 (Top), 8 (Bottom), 5 (Top-Left), 6 (Top-Right), 9 (Bottom-Left), 10 (Bottom-Right)}
Subpicture position
You can enforce the subpicture position on the video (0=center,
1=left, 2=right, 4=top, 8=bottom, you can also use combinations of
these values, e.g. 6=top-right).
--dvbsub-x=<integer> Decoding X coordinate
X coordinate of the rendered subtitle
--dvbsub-y=<integer> Decoding Y coordinate
Y coordinate of the rendered subtitle
--sout-dvbsub-x=<integer> Encoding X coordinate
X coordinate of the encoded subtitle
--sout-dvbsub-y=<integer> Encoding Y coordinate
Y coordinate of the encoded subtitle

Dummy interface function
Dummy Interface:
--dummy-quiet, --no-dummy-quiet
Do not open a DOS command box interface
(default disabled)
By default the dummy interface plugin will start a DOS command box.
Enabling the quiet mode will not bring this command box but can also
be pretty annoying when you want to stop VLC and no video window is
open. (default disabled)
Dummy decoder:
--dummy-save-es, --no-dummy-save-es
Save raw codec data (default disabled)
Save the raw codec data if you have selected/forced the dummy decoder
in the main options. (default disabled)
Dummy Video output:
--dummy-chroma=<string> Dummy image chroma format
Force the dummy video output to create images using a specific chroma
format instead of trying to improve performances by using the most
efficient one.

DTS Coherent Acoustics audio decoder
--dts-dynrng, --no-dts-dynrng
DTS dynamic range compression (default
enabled)
Dynamic range compression makes the loud sounds softer, and the soft
sounds louder, so you can more easily listen to the stream in a noisy
environment without disturbing anyone. If you disable the dynamic
range compression the playback will be more adapted to a movie
theater or a listening room. (default enabled)

DirectShow input
--dshow-caching=<integer> Caching value in ms
Caching value for DirectShow streams. This value should be set in
milliseconds.
--dshow-vdev={,none} Video device name
Name of the video device that will be used by the DirectShow plugin.
If you don't specify anything, the default device will be used.
--dshow-adev={,none} Audio device name
Name of the audio device that will be used by the DirectShow plugin.
If you don't specify anything, the default device will be used.
--dshow-size=<string> Video size
Size of the video that will be displayed by the DirectShow plugin. If
you don't specify anything the default size for your device will be
used. You can specify a standard size (cif, d1, ...) or
<width>x<height>.
--dshow-chroma=<string> Video input chroma format
Force the DirectShow video input to use a specific chroma format (eg.
I420 (default), RV24, etc.)
--dshow-fps=<float> Video input frame rate
Force the DirectShow video input to use a specific frame rate(eg. 0
means default, 25, 29.97, 50, 59.94, etc.)
--dshow-config, --no-dshow-config
Device properties (default disabled)
Show the properties dialog of the selected device before starting the
stream. (default disabled)
--dshow-tuner, --no-dshow-tuner
Tuner properties (default disabled)
Show the tuner properties [channel selection] page. (default disabled)
--dshow-tuner-channel=<integer>
Tuner TV Channel
Set the TV channel the tuner will set to (0 means default).
--dshow-tuner-country=<integer>
Tuner country code
Set the tuner country code that establishes the current
channel-to-frequency mapping (0 means default).
--dshow-tuner-input={0 (Default), 1 (Cable), 2 (Antenna)}
Tuner input type
Select the tuner input type (Cable/Antenna).
--dshow-video-input=<integer>
Video input pin
Select the video input source, such as composite, s-video, or tuner.
Since these settings are hardware-specific, you should find good
settings in the "Device config" area, and use those numbers here. -1
means that settings will not be changed.
--dshow-video-output=<integer>
Video output pin
Select the video output type. See the "video input" option.
--dshow-audio-input=<integer>
Audio input pin
Select the audio input source. See the "video input" option.
--dshow-audio-output=<integer>
Audio output pin
Select the audio output type. See the "video input" option.
--dshow-amtuner-mode={0 (Default), 1 (TV), 2 (FM radio), 4 (AM radio), 8 (DSS)}
AM Tuner mode
AM Tuner mode. Can be one of Default (0), TV (1),AM Radio (2), FM
Radio (3) or DSS (4).
--dshow-audio-channels=<integer>
Number of audio channels
Select audio input format with the given number of audio channels (if
non 0)
--dshow-audio-samplerate=<integer>
Audio sample rate
Select audio input format with the given sample rate (if non 0)
--dshow-audio-bitspersample=<integer>
Audio bits per sample
Select audio input format with the given bits/sample (if non 0)

DirectX (DirectDraw) video output
Recommended video output for Windows XP. Incompatible with Vista's Aero interface
--directx-hw-yuv, --no-directx-hw-yuv
Use hardware YUV->RGB conversions (default
enabled)
Try to use hardware acceleration for YUV->RGB conversions. This
option doesn't have any effect when using overlays. (default enabled)
--directx-use-sysmem, --no-directx-use-sysmem
Use video buffers in system memory (default
disabled)
Create video buffers in system memory instead of video memory. This
isn't recommended as usually using video memory allows to benefit
from more hardware acceleration (like rescaling or YUV->RGB
conversions). This option doesn't have any effect when using
overlays. (default disabled)
--directx-3buffering, --no-directx-3buffering
Use triple buffering for overlays (default
enabled)
Try to use triple buffering when using YUV overlays. That results in
much better video quality (no flickering). (default enabled)
--directx-device={} Name of desired display device
In a multiple monitor configuration, you can specify the Windows
device name of the display that you want the video window to open on.
For example, "\\.\DISPLAY1" or "\\.\DISPLAY2".

Direct3D video output
Recommended video output for Windows Vista and later versions
--direct3d-desktop, --no-direct3d-desktop
Enable desktop mode (default disabled)
The desktop mode allows you to display the video on the desktop.
(default disabled)

Dirac video encoder using dirac-research library
--sout-dirac-quality=<float [0.000000 .. 10.000000]>
Constant quality factor
If bitrate=0, use this value for constant quality
--sout-dirac-bitrate=<integer [-1 .. 2147483647]>
CBR bitrate (kbps)
A value > 0 enables constant bitrate mode
--sout-dirac-lossless, --no-sout-dirac-lossless
Enable lossless coding (default disabled)
Lossless coding ignores bitrate and quality settings, allowing for
perfect reproduction of the original (default disabled)
--sout-dirac-prefilter={none,cwm,rectlp,diaglp}
Prefilter
Enable adaptive prefiltering
--sout-dirac-prefilter-strength=<integer [0 .. 10]>
Amount of prefiltering
Higher value implies more prefiltering
--sout-dirac-chroma-fmt={420,422,444}
Chroma format
Picking chroma format will force a conversion of the video into that
format
--sout-dirac-l1-sep=<integer [-1 .. 2147483647]>
Distance between 'P' frames
Distance between 'P' frames
--sout-dirac-num-l1=<integer [-1 .. 2147483647]>
Number of 'P' frames per GOP
Number of 'P' frames per GOP
--sout-dirac-coding-mode={auto,progressive,field}
Picture coding mode
Field coding is where interlaced fields are coded seperately as
opposed to a pseudo-progressive frame
--sout-dirac-mv-prec={1,1/2,1/4,1/8}
Motion vector precision
Motion vector precision in pels.
--sout-dirac-mc-blk-width=<integer [-1 .. 2147483647]>
Width of motion compensation blocks
--sout-dirac-mc-blk-height=<integer [-1 .. 2147483647]>
mc-blk-height
--sout-dirac-mc-blk-overlap=<integer [-1 .. 100]>
Block overlap (%)
Amount that each motion block should be overlapped by its neighbours
--sout-dirac-mc-blk-xblen=<integer [-1 .. 2147483647]>
xblen
Total horizontal block length including overlaps
--sout-dirac-mc-blk-yblen=<integer [-1 .. 2147483647]>
yblen
Total vertical block length including overlaps
--sout-dirac-me-simple-search=<string>
Simple ME search area x:y
(Not recommended) Perform a simple (non hierarchical block matching
motion vector search with search range of +/-x, +/-y
--sout-dirac-me-combined, --no-sout-dirac-me-combined
Three component motion estimation (default
enabled)
Use chroma as part of the motion estimation process (default enabled)
--sout-dirac-dwt-intra=<integer [-1 .. 6]>
Intra picture DWT filter
Intra picture DWT filter
--sout-dirac-dwt-inter=<integer [-1 .. 6]>
Inter picture DWT filter
Inter picture DWT filter
--sout-dirac-dwt-depth=<integer [-1 .. 4]>
Number of DWT iterations
Also known as DWT levels
--sout-dirac-multi-quant=<integer [-1 .. 1]>
Enable multiple quantizers
Enable multiple quantizers per subband (one per codeblock)
--sout-dirac-spartition=<integer [-1 .. 1]>
Enable spatial partitioning
Enable spatial partitioning
--sout-dirac-noac, --no-sout-dirac-noac
Disable arithmetic coding (default disabled)
Use variable length codes instead, useful for very high bitrates
(default disabled)
--sout-dirac-cpd=<float> cycles per degree
cycles per degree

File dumper
--demuxdump-file=<string> Dump filename
Name of the file to which the raw stream will be dumped.
--demuxdump-append, --no-demuxdump-append
Append to existing file (default disabled)
If the file already exists, it will not be overwritten. (default
disabled)

Deinterlacing video filter
Display:
--filter-deinterlace-mode={discard,blend,mean,bob,linear,x,yadif,yadif2x}
Deinterlace mode
Deinterlace method to use for local playback.
Streaming:
--sout-deinterlace-mode={discard,blend,mean,bob,linear,x,yadif,yadif2x}
Streaming deinterlace mode
Deinterlace method to use for streaming.

Crop video filter
Remove borders of the video and replace them by black borders
--crop-geometry=<string> Crop geometry (pixels)
Set the geometry of the zone to crop. This is set as <width> x
<height> + <left offset> + <top offset>.
--autocrop, --no-autocrop Automatic cropping (default disabled)
Automatically detect black borders and crop them. (default disabled)
--autocrop-ratio-max=<integer [0 .. 15000]>
Ratio max (x 1000)
Maximum image ratio. The crop plugin will never automatically crop to
a higher ratio (ie, to a more "flat" image). The value is x1000: 1333
means 4/3.
--crop-ratio=<integer [0 .. 15000]>
Manual ratio
Force a ratio (0 for automatic). Value is x1000: 1333 means 4/3.
--autocrop-time=<integer> Number of images for change
The number of consecutive images with the same detected ratio
(different from the previously detected ratio) to consider that ratio
chnged and trigger recrop.
--autocrop-diff=<integer> Number of lines for change
The minimum difference in the number of detected black lines to
consider that ratio changed and trigger recrop.
--autocrop-non-black-pixels=<integer>
Number of non black pixels
The maximum of non-black pixels in a line to consider that the line
is black.
--autocrop-skip-percent=<integer [0 .. 100]>
Skip percentage (%)
Percentage of the line to consider while checking for black lines.
This allows to skip logos in black borders and crop them anyway.
--autocrop-luminance-threshold=<integer [0 .. 128]>
Luminance threshold
Maximum luminance to consider a pixel as black (0-255).

Video scaling filter
Crop:
--croppadd-croptop=<integer [0 .. 2147483647]>
Pixels to crop from top
Number of pixels to crop from the top of the image.
--croppadd-cropbottom=<integer [0 .. 2147483647]>
Pixels to crop from bottom
Number of pixels to crop from the bottom of the image.
--croppadd-cropleft=<integer [0 .. 2147483647]>
Pixels to crop from left
Number of pixels to crop from the left of the image.
--croppadd-cropright=<integer [0 .. 2147483647]>
Pixels to crop from right
Number of pixels to crop from the right of the image.
Padd:
--croppadd-paddtop=<integer [0 .. 2147483647]>
Pixels to padd to top
Number of pixels to padd to the top of the image after cropping.
--croppadd-paddbottom=<integer [0 .. 2147483647]>
Pixels to padd to bottom
Number of pixels to padd to the bottom of the image after cropping.
--croppadd-paddleft=<integer [0 .. 2147483647]>
Pixels to padd to left
Number of pixels to padd to the left of the image after cropping.
--croppadd-paddright=<integer [0 .. 2147483647]>
Pixels to padd to right
Number of pixels to padd to the right of the image after cropping.

Color threshold filter
Select one color in the video
--colorthres-color={16711680 (Red), 16711935 (Fuchsia), 16776960 (Yellow), 65280 (Lime), 255 (Blue), 65535 (Aqua)}
Color
Colors similar to this will be kept, others will be grayscaled. This
must be an hexadecimal (like HTML colors). The first two chars are
for red, then green, then blue. #000000 = black, #FF0000 = red,
#00FF00 = green, #FFFF00 = yellow (red + green), #FFFFFF = white
--colorthres-saturationthres=<integer>
Saturaton threshold
--colorthres-similaritythres=<integer>
Similarity threshold

Clone video filter
Duplicate your video to multiple windows and/or video output modules
--clone-count=<integer> Number of clones
Number of video windows in which to clone the video.
--clone-vout-list=<string> Video output modules
You can use specific video output modules for the clones. Use a
comma-separated list of modules.

Sound Delay
Add a delay effect to the sound
--delay-time=<float> Delay time
Time in milliseconds of the average delay. Note average
--sweep-depth=<float> Sweep Depth
Time in milliseconds of the maximum sweep depth. Thus, the sweep
range will be delay-time +/- sweep-depth.
--sweep-rate=<float> Sweep Rate
Rate of change of sweep depth in milliseconds shift per second of play
--feedback-gain=<float [-0.900000 .. 0.900000]>
Feedback Gain
Gain on Feedback loop
--wet-mix=<float [-0.999000 .. 0.999000]>
Wet mix
Level of delayed signal
--dry-mix=<float [-0.999000 .. 0.999000]>
Dry Mix
Level of input signal

Audio CD input
--cdda-caching=<integer> Caching value in ms
Default caching value for Audio CDs. This value should be set in
milliseconds.
--cdda-track=<integer> (null)
--cdda-first-sector=<integer>
(null)
--cdda-last-sector=<integer>
(null)
--cddb-server=<string> CDDB Server
Address of the CDDB server to use.
--cddb-port=<integer> CDDB port
CDDB Server port to use.

Canvas video filter
Automatically resize and pad a video
--canvas-width=<integer [0 .. 2147483647]>
Output width
Output (canvas) image width
--canvas-height=<integer [0 .. 2147483647]>
Output height
Output (canvas) image height
--canvas-aspect=<string> Output picture aspect ratio
Set the canvas' picture aspect ratio. If omitted, the canvas is
assumed to have the same SAR as the input.
--canvas-padd, --no-canvas-padd
Pad video (default enabled)
If enabled, video will be padded to fit in canvas after scaling.
Otherwise, video will be cropped to fix in canvas after scaling.
(default enabled)

Bluescreen video filter
This effect, also known as "greenscreen" or "chroma key" blends the "blue parts" of the foreground image of the mosaic on the background (like weather forecasts). You can choose the "key" color for blending (blue by default).
--bluescreen-u=<integer [0 .. 255]>
Bluescreen U value
"U" value for the bluescreen key color (in YUV values). From 0 to
255. Defaults to 120 for blue.
--bluescreen-v=<integer [0 .. 255]>
Bluescreen V value
"V" value for the bluescreen key color (in YUV values). From 0 to
255. Defaults to 90 for blue.
--bluescreen-ut=<integer [0 .. 255]>
Bluescreen U tolerance
Tolerance of the bluescreen blender on color variations for the U
plane. A value between 10 and 20 seems sensible.
--bluescreen-vt=<integer [0 .. 255]>
Bluescreen V tolerance
Tolerance of the bluescreen blender on color variations for the V
plane. A value between 10 and 20 seems sensible.

Blending benchmark filter
Benchmarking:
--blendbench-loops=<integer>
Number of time to blend
The number of time the blend will be performed
--blendbench-alpha=<integer [0 .. 255]>
Alpha of the blended image
Alpha with which the blend image is blended
Base image:
--blendbench-base-image=<string>
Image to be blended onto
The image which will be used to blend onto
--blendbench-base-chroma=<string>
Chroma for the base image
Chroma which the base image will be loaded in
Blend image:
--blendbench-blend-image=<string>
Image which will be blended
The image blended onto the base image
--blendbench-blend-chroma=<string>
Chroma for the blend image
Chroma which the blend image will be loadedin

DirectShow DVB input
--dvb-caching=<integer> Caching value in ms
Caching value for DVB streams. This value should be set in
milliseconds.
--dvb-frequency=<integer> Transponder/multiplex frequency
In kHz for DVB-S or Hz for DVB-C/T
--dvb-network-name=<string>
Network Name
Unique network name in the System Tuning Spaces
--dvb-create-name=<string> Network Name to Create
Create Unique name in the System Tuning Spaces
--dvb-adapter=<integer> Adapter card to tune
Adapter cards have a device file in directory named
/dev/dvb/adapter[n] with n>=0.
--dvb-inversion={-1 (Undefined), 0 (Off), 1 (On), 2 (Auto)}
Inversion mode
Inversion mode [0=off, 1=on, 2=auto]
--dvb-polarisation={H,V,L,R}
Satellite Polarisation
Satellite Polarisation [H/V/L/R]
--dvb-network-id=<integer> Network Identifier
--dvb-azimuth=<integer> Satellite Azimuth
Satellite Azimuth in tenths of degree
--dvb-elevation=<integer> Satellite Elevation
Satellite Elevation in tenths of degree
--dvb-longitude=<integer> Satellite Longitude
Satellite Longitude in 10ths of degree, -ve=West
--dvb-range=<string> Satellite Range Code
Satellite Range Code as defined by manufacturer e.g. DISEqC switch
code
--dvb-lnb-lof1=<integer> Antenna lnb_lof1 (kHz)
Low Band Local Osc Freq in kHz (usually 9.75GHz)
--dvb-lnb-lof2=<integer> Antenna lnb_lof2 (kHz)
High Band Local Osc Freq in kHz (usually 10.6GHz)
--dvb-lnb-slof=<integer> Antenna lnb_slof (kHz)
Low Noise Block switch freq in kHz (usually 11.7GHz)
--dvb-srate=<integer> Transponder symbol rate in kHz
--dvb-modulation={-1 (Undefined), 16 (QAM16), 32 (QAM32), 64 (QAM64), 128 (QAM128), 256 (QAM256), 10002 (BPSK), 10004 (QPSK), 20008 (8VSB), 20016 (16VSB)}
Modulation type
QAM, PSK or VSB modulation method
--dvb-major-channel=<integer>
ATSC Major Channel
ATSC Major Channel
--dvb-minor-channel=<integer>
ATSC Minor Channel
ATSC Minor Channel
--dvb-physical-channel=<integer>
ATSC Physical Channel
ATSC Physical Channel
--dvb-code-rate-hp={-1 (Undefined), 1 (1/2), 2 (2/3), 3 (3/4), 4 (5/6), 5 (7/8)}
FEC rate
FEC rate includes DVB-T high priority stream FEC Rate
--dvb-code-rate-lp={-1 (Undefined), 1 (1/2), 2 (2/3), 3 (3/4), 4 (5/6), 5 (7/8)}
Terrestrial low priority stream code rate
(FEC)
Low Priority FEC Rate [Undefined,1/2,2/3,3/4,5/6,7/8]
--dvb-bandwidth={-1 (Undefined), 6 (6 MHz), 7 (7 MHz), 8 (8 MHz)}
Terrestrial bandwidth
Terrestrial bandwidth [0=auto,6,7,8 in MHz]
--dvb-guard={-1 (Undefined), 4 (1/4), 8 (1/8), 16 (1/16), 32 (1/32)}
Terrestrial guard interval
Guard interval [Undefined,1/4,1/8,1/16,1/32]
--dvb-transmission={-1 (Undefined), 2 (2k), 8 (8k)}
Terrestrial transmission mode
Transmission mode [Undefined,2k,8k]
--dvb-hierarchy={-1 (Undefined), 1 (1), 2 (2), 4 (4)}
Terrestrial hierarchy mode
Hierarchy alpha value [Undefined,1,2,4]

Ball video filter
Augmented reality ball game
--ball-color={red,green,blue,white}
Ball color
Ball color, one of "red", "blue" and "green".
--ball-speed=<integer [1 .. 15]>
Ball speed
Set ball speed, the displacement value
in number of pixels by frame.
--ball-size=<integer [5 .. 30]>
Ball size
Set ball size giving its radius in number
of pixels
--ball-gradient-threshold=<integer [1 .. 200]>
Gradient threshold
Set gradient threshold for edge computation.
--ball-edge-visible, --no-ball-edge-visible
Edge visible (default enabled)
Set edge visibility. (default enabled)

AVI demuxer
--avi-interleaved, --no-avi-interleaved
Force interleaved method (default disabled)
Force interleaved method. (default disabled)
--avi-index={0 (Ask for action), 1 (Always fix), 2 (Never fix)}
Force index creation
Recreate a index for the AVI file. Use this if your AVI file is
damaged or incomplete (not seekable).

FFmpeg audio/video decoder
Various audio and video decoders/encoders delivered by the FFmpeg library. This includes (MS)MPEG4, DivX, SV1,H261, H263, H264, WMV, WMA, AAC, AMR, DV, MJPEG and other codecs
Decoding:
--ffmpeg-dr, --no-ffmpeg-dr
Direct rendering (default enabled)
Direct rendering (default enabled)
--ffmpeg-error-resilience=<integer>
Error resilience
FFmpeg can do error resilience.
However, with a buggy encoder (such
as the ISO MPEG-4 encoder from M$) this can produce a lot of
errors.
Valid values range from 0 to 4 (0 disables all errors
resilience).
--ffmpeg-workaround-bugs=<integer>
Workaround bugs
Try to fix some bugs:
1 autodetect
2 old msmpeg4
4 xvid
interlaced
8 ump4
16 no padding
32 ac vlc
64 Qpel chroma.
This must
be the sum of the values. For example, to fix "ac vlc" and "ump4",
enter 40.
--ffmpeg-hurry-up, --no-ffmpeg-hurry-up
Hurry up (default enabled)
The decoder can partially decode or skip frame(s) when there is not
enough time. It's useful with low CPU power but it can produce
distorted pictures. (default enabled)
--ffmpeg-skip-frame=<integer [-1 .. 4]>
Skip frame (default=0)
Force skipping of frames to speed up decoding (-1=None, 0=Default,
1=B-frames, 2=P-frames, 3=B+P frames, 4=all frames).
--ffmpeg-skip-idct=<integer [-1 .. 4]>
Skip idct (default=0)
Force skipping of idct to speed up decoding for frame types(-1=None,
0=Default, 1=B-frames, 2=P-frames, 3=B+P frames, 4=all frames).
--ffmpeg-vismv=<integer> Visualize motion vectors
You can overlay the motion vectors (arrows showing how the images
move) on the image. This value is a mask, based on these values:
1 -
visualize forward predicted MVs of P frames
2 - visualize forward
predicted MVs of B frames
4 - visualize backward predicted MVs of B
frames
To visualize all vectors, the value should be 7.
--ffmpeg-lowres=<integer [0 .. 2]>
Low resolution decoding
Only decode a low resolution version of the video. This requires less
processing power
--ffmpeg-fast, --no-ffmpeg-fast
Allow speed tricks (default disabled)
Allow non specification compliant speedup tricks. Faster but
error-prone. (default disabled)
--ffmpeg-skiploopfilter={0 (None), 1 (Non-ref), 2 (Bidir), 3 (Non-key), 4 (All)}
Skip the loop filter for H.264 decoding
Skipping the loop filter (aka deblocking) usually has a detrimental
effect on quality. However it provides a big speedup for high
definition streams.
--ffmpeg-debug=<integer> Debug mask
Set FFmpeg debug mask
--ffmpeg-hw, --no-ffmpeg-hw
Hardware decoding (default disabled)
This allows hardware decoding when available. (default disabled)
Encoding:
--sout-ffmpeg-hq={rd,bits,simple}
Quality level
Quality level for the encoding of motions vectors (this can slow down
the encoding very much).
--sout-ffmpeg-keyint=<integer>
Ratio of key frames
Number of frames that will be coded for one key frame.
--sout-ffmpeg-bframes=<integer>
Ratio of B frames
Number of B frames that will be coded between two reference frames.
--sout-ffmpeg-hurry-up, --no-sout-ffmpeg-hurry-up
Hurry up (default disabled)
The encoder can make on-the-fly quality tradeoffs if your CPU can't
keep up with the encoding rate. It will disable trellis quantization,
then the rate distortion of motion vectors (hq), and raise the noise
reduction threshold to ease the encoder's task. (default disabled)
--sout-ffmpeg-interlace, --no-sout-ffmpeg-interlace
Interlaced encoding (default disabled)
Enable dedicated algorithms for interlaced frames. (default disabled)
--sout-ffmpeg-interlace-me, --no-sout-ffmpeg-interlace-me
Interlaced motion estimation (default enabled)
Enable interlaced motion estimation algorithms. This requires more
CPU. (default enabled)
--sout-ffmpeg-vt=<integer> Video bitrate tolerance
Video bitrate tolerance in kbit/s.
--sout-ffmpeg-pre-me, --no-sout-ffmpeg-pre-me
Pre-motion estimation (default disabled)
Enable the pre-motion estimation algorithm. (default disabled)
--sout-ffmpeg-rc-buffer-size=<integer>
Rate control buffer size
Rate control buffer size (in kbytes). A bigger buffer will allow for
better rate control, but will cause a delay in the stream.
--sout-ffmpeg-rc-buffer-aggressivity=<float>
Rate control buffer aggressiveness
Rate control buffer aggressiveness.
--sout-ffmpeg-i-quant-factor=<float>
I quantization factor
Quantization factor of I frames, compared with P frames (for instance
1.0 => same qscale for I and P frames).
--sout-ffmpeg-noise-reduction=<integer>
Noise reduction
Enable a simple noise reduction algorithm to lower the encoding
length and bitrate, at the expense of lower quality frames.
--sout-ffmpeg-mpeg4-matrix, --no-sout-ffmpeg-mpeg4-matrix
MPEG4 quantization matrix (default disabled)
Use the MPEG4 quantization matrix for MPEG2 encoding. This generally
yields a better looking picture, while still retaining the
compatibility with standard MPEG2 decoders. (default disabled)
--sout-ffmpeg-qmin=<integer>
Minimum video quantizer scale
Minimum video quantizer scale.
--sout-ffmpeg-qmax=<integer>
Maximum video quantizer scale
Maximum video quantizer scale.
--sout-ffmpeg-trellis, --no-sout-ffmpeg-trellis
Trellis quantization (default disabled)
Enable trellis quantization (rate distortion for block coefficients).
(default disabled)
--sout-ffmpeg-qscale=<float>
Fixed quantizer scale
A fixed video quantizer scale for VBR encoding (accepted values: 0.01
to 255.0).
--sout-ffmpeg-strict=<integer>
Strict standard compliance
Force a strict standard compliance when encoding (accepted values:
-1, 0, 1).
--sout-ffmpeg-lumi-masking=<float>
Luminance masking
Raise the quantizer for very bright macroblocks (default: 0.0).
--sout-ffmpeg-dark-masking=<float>
Darkness masking
Raise the quantizer for very dark macroblocks (default: 0.0).
--sout-ffmpeg-p-masking=<float>
Motion masking
Raise the quantizer for macroblocks with a high temporal complexity
(default: 0.0).
--sout-ffmpeg-border-masking=<float>
Border masking
Raise the quantizer for macroblocks at the border of the frame
(default: 0.0).
--sout-ffmpeg-luma-elim-threshold=<integer>
Luminance elimination
Eliminates luminance blocks when the PSNR isn't much changed
(default: 0.0). The H264 specification recommends -4.
--sout-ffmpeg-chroma-elim-threshold=<integer>
Chrominance elimination
Eliminates chrominance blocks when the PSNR isn't much changed
(default: 0.0). The H264 specification recommends 7.
--sout-ffmpeg-aac-profile=<string>
Specify AAC audio profile to use
Specify the AAC audio profile to use for encoding the audio
bitstream. It takes the following options: main, low, ssr (not
supported) and ltp (default: main)
--ffmpeg-mux=<string> Ffmpeg mux
Force use of ffmpeg muxer.

Submission of played songs to last.fm
--lastfm-username=<string> Username
The username of your last.fm account
--lastfm-password=<string> Password
The password of your last.fm account
--scrobbler-url=<string> Scrobbler URL
The URL set for an alternative scrobbler engine

Audio Bar Graph Video sub filter
--audiobargraph_v-i_values=<string>
Value of the audio channels levels
Value of the audio level of each channels between 0 and 1Each level
should be separated with ':'.
--audiobargraph_v-x=<integer>
X coordinate
X coordinate of the bargraph.
--audiobargraph_v-y=<integer>
Y coordinate
Y coordinate of the bargraph.
--audiobargraph_v-transparency=<integer [0 .. 255]>
Transparency of the bargraph
Bargraph transparency value (from 0 for full transparency to 255 for
full opacity).
--audiobargraph_v-position={0 (Center), 1 (Left), 2 (Right), 4 (Top), 8 (Bottom), 5 (Top-Left), 6 (Top-Right), 9 (Bottom-Left), 10 (Bottom-Right)}
Bargraph position
Enforce the bargraph position on the video (0=center, 1=left,
2=right, 4=top, 8=bottom, you can also use combinations of these
values, eg 6 = top-right).
--audiobargraph_v-alarm=<integer>
Alarm
Signals a silence and displays and alert (0=no alarm, 1=alarm).
--audiobargraph_v-barWidth=<integer>
Bar width in pixel (default : 10)
Width in pixel of each bar in the BarGraph to be displayed (default :
10).

Audio part of the BarGraph function
--audiobargraph_a-address=<string>
TCP address to use (default localhost)
TCP address to use to communicate with the video part of the Bar
Graph (default localhost).In the case of bargraph incrustation, use
localhost.
--audiobargraph_a-port=<integer>
TCP port to use (default 12345)
TCP port to use to communicate with the video part of the Bar Graph
(default 12345).Use the same port as the one used in the rc interface.
--audiobargraph_a-bargraph=<integer>
Defines if BarGraph information should be
sent (default 1)
Defines if BarGraph information should be sent. 1 if the information
should be sent, 0 otherwise (default 1).
--audiobargraph_a-bargraph_repetition=<integer>
Sends the barGraph information every n audio
packets (default 4)
Defines how often the barGraph information should be sent. Sends the
barGraph information every n audio packets (default 4).
--audiobargraph_a-silence=<integer>
Defines if silence alarm information should
be sent (default 1)
Defines if silence alarm information should be sent. 1 if the
information should be sent, 0 otherwise (default 1).
--audiobargraph_a-time_window=<integer>
Time window to use in ms (default 5000)
Time Window during when the audio level is measured in ms for silence
detection. If the audio level is under the threshold during this
time, an alarm is sent (default 5000).
--audiobargraph_a-alarm_threshold=<float>
Minimum Audio level to raise the alarm
(default 0.1)
Threshold to be attained to raise an alarm. If the audio level is
under the threshold during this time, an alarm is sent (default 0.1).
--audiobargraph_a-repetition_time=<integer>
Time between two alarm messages in ms
(default 2000)
Time between two alarm messages in ms. This value is used to avoid
alarm saturation (default 2000).
--audiobargraph_a-connection_reset=<integer>
Force connection reset regularly (default 1)
Defines if the TCP connection should be reset. This is to be used
when using with audiobargraph_v (default 1).

AtmoLight Filter
This module allows to control an so called AtmoLight device connected to your computer.
AtmoLight is the homegrown version of what Philips calls AmbiLight.
If you need further information feel free to visit us at

http://www.vdr-wiki.de/wiki/index.php/Atmo-plugin
http://www.vdr-wiki.de/wiki/index.php/AtmoWin

You can find there detailed descriptions on how to build it for yourself and where to get the required parts.
You can also have a look at pictures and some movies showing such a device in live action.
Choose Devicetype and Connection:
--atmo-device={0 (AtmoWin Software), 1 (Classic AtmoLight), 2 (Quattro AtmoLight), 3 (DMX), 4 (MoMoLight), 5 (fnordlicht)}
Device type
Choose your prefered hardware from the list, or choose AtmoWin
Software to delegate processing to the external process - with more
options
--atmo-serialdev=<string> Serial Port/Device
Name of the serial port where the AtmoLight controller is attached
to.
On Windows usually something like COM1 or COM2. On Linux
/dev/ttyS01 f.e.
--atmo-atmowinexe=<string> Filename of AtmoWin*.exe
if you want the AtmoLight control software to be launched by VLC,
enter the complete path of AtmoWinA.exe here.
Illuminate the room with this color on pause:
--atmo-usepausecolor, --no-atmo-usepausecolor
Color when paused (default disabled)
Set the color to show if the user pauses the video. (Have light to
get another beer?) (default disabled)
--atmo-pcolor-red=<integer [0 .. 255]>
Pause-Red
Red component of the pause color
--atmo-pcolor-green=<integer [0 .. 255]>
Pause-Green
Green component of the pause color
--atmo-pcolor-blue=<integer [0 .. 255]>
Pause-Blue
Blue component of the pause color
--atmo-fadesteps=<integer [1 .. 250]>
Pause-Fadesteps
Number of steps to change current color to pause color (each step
takes 40ms)
Illuminate the room with this color on shutdown:
--atmo-ecolor-red=<integer [0 .. 255]>
End-Red
Red component of the shutdown color
--atmo-ecolor-green=<integer [0 .. 255]>
End-Green
Green component of the shutdown color
--atmo-ecolor-blue=<integer [0 .. 255]>
End-Blue
Blue component of the shutdown color
--atmo-efadesteps=<integer [1 .. 250]>
End-Fadesteps
Number of steps to change current color to end color for dimming up
the light in cinema style... (each step takes 40ms)
DMX options:
--atmo-dmx-channels=<integer [1 .. 64]>
Count of AtmoLight channels
How many AtmoLight channels, should be emulated with that DMX device
--atmo-dmx-chbase=<string> DMX address for each channel
Define here the DMX base address for each channel use , or ; to
seperate the values
MoMoLight options:
--atmo-momo-channels=<integer [3 .. 4]>
Count of channels
Depending on your MoMoLight hardware choose 3 or 4 channels
fnordlicht options:
--atmo-fnordlicht-amount=<integer [1 .. 4]>
Count of fnordlicht's
Depending on the amount your fnordlicht hardware choose 1 to 4
channels
Zone Layout for the build-in Atmo:
--atmo-zones-top=<integer [0 .. 16]>
Number of zones on top
Number of zones on the top of the screen
--atmo-zones-bottom=<integer [0 .. 16]>
Number of zones on bottom
Number of zones on the bottom of the screen
--atmo-zones-lr=<integer [0 .. 16]>
Zones on left / right side
left and right side having allways the same number of zones
--atmo-zone-summary, --no-atmo-zone-summary
Calculate a average zone (default disabled)
it contains the average of all pixels in the sample image (only
useful for single channel AtmoLight) (default disabled)
Settings for the built-in Live Video Processor only:
--atmo-edgeweightning=<integer [1 .. 30]>
Edge Weightning
Increasing this value will result in color more depending on the
border of the frame.
--atmo-brightness=<integer [50 .. 300]>
Brightness
Overall brightness of your LED stripes
--atmo-darknesslimit=<integer [0 .. 10]>
Darkness Limit
Pixels with a saturation lower than this will be ignored. Should be
greater than one for letterboxed videos.
--atmo-huewinsize=<integer [0 .. 5]>
Hue windowing
Used for statistics.
--atmo-satwinsize=<integer [0 .. 5]>
Sat windowing
Used for statistics.
--atmo-filtermode={0 (No Filtering), 1 (Combined), 2 (Percent)}
Output Color filter mode
defines the how the output color should be calculated based on
previous color
--atmo-meanlength=<integer [300 .. 5000]>
Filter length (ms)
Time it takes until a color is completely changed. This prevents
flickering.
--atmo-meanthreshold=<integer [1 .. 100]>
Filter threshold
How much a color has to be changed for an immediate color change.
--atmo-percentnew=<integer [1 .. 100]>
Filter Smoothness (in %)
Filter Smoothness
--atmo-framedelay=<integer [0 .. 200]>
Frame delay (ms)
Helps to get the video output and the light effects in sync. Values
around 20ms should do the trick.
Change channel assignment (fixes wrong wiring):
--atmo-channel_0={-1 (disabled), 4 (Zone 4:summary), 3 (Zone 3:left), 1 (Zone 1:right), 0 (Zone 0:top), 2 (Zone 2:bottom)}
Channel 0: summary
Maps the hardware channel X to logical zone Y to fix wrong wiring :-)
--atmo-channel_1={-1 (disabled), 4 (Zone 4:summary), 3 (Zone 3:left), 1 (Zone 1:right), 0 (Zone 0:top), 2 (Zone 2:bottom)}
Channel 1: left
Maps the hardware channel X to logical zone Y to fix wrong wiring :-)
--atmo-channel_2={-1 (disabled), 4 (Zone 4:summary), 3 (Zone 3:left), 1 (Zone 1:right), 0 (Zone 0:top), 2 (Zone 2:bottom)}
Channel 2: right
Maps the hardware channel X to logical zone Y to fix wrong wiring :-)
--atmo-channel_3={-1 (disabled), 4 (Zone 4:summary), 3 (Zone 3:left), 1 (Zone 1:right), 0 (Zone 0:top), 2 (Zone 2:bottom)}
Channel 3: top
Maps the hardware channel X to logical zone Y to fix wrong wiring :-)
--atmo-channel_4={-1 (disabled), 4 (Zone 4:summary), 3 (Zone 3:left), 1 (Zone 1:right), 0 (Zone 0:top), 2 (Zone 2:bottom)}
Channel 4: bottom
Maps the hardware channel X to logical zone Y to fix wrong wiring :-)
--atmo-channels=<string> Channel / Zone Assignment
for devices with more than five channels / zones write down here for
each channel the zone number to show and seperate the values with ,
or ; and use -1 to not use some channels. For the classic AtmoLight
the sequence 4,3,1,0,2 would set the default channel/zone mapping.
Having only two zones on top, and one zone on left and right and no
summary zone the mapping for classic AtmoLight would be -1,3,2,1,0
Adjust the white light to your LED stripes:
--atmo-whiteadj, --no-atmo-whiteadj
Use Software White adjust (default enabled)
Should the buildin driver do a white adjust or your LED stripes?
recommend. (default enabled)
--atmo-white-red=<integer [0 .. 255]>
White Red
Red value of a pure white on your LED stripes.
--atmo-white-green=<integer [0 .. 255]>
White Green
Green value of a pure white on your LED stripes.
--atmo-white-blue=<integer [0 .. 255]>
White Blue
Blue value of a pure white on your LED stripes.
Change gradients:
--atmo-gradient_zone_0=<string>
Zone 0: Top gradient
Defines a small bitmap with 64x48 pixels, containing a grayscale
gradient
--atmo-gradient_zone_1=<string>
Zone 1: Right gradient
Defines a small bitmap with 64x48 pixels, containing a grayscale
gradient
--atmo-gradient_zone_2=<string>
Zone 2: Bottom gradient
Defines a small bitmap with 64x48 pixels, containing a grayscale
gradient
--atmo-gradient_zone_3=<string>
Zone 3: Left gradient
Defines a small bitmap with 64x48 pixels, containing a grayscale
gradient
--atmo-gradient_zone_4=<string>
Zone 4: Summary gradient
Defines a small bitmap with 64x48 pixels, containing a grayscale
gradient
--atmo-gradient_path=<string>
Gradient bitmap searchpath
Now prefered option to assign gradient bitmaps, put them as
zone_0.bmp, zone_1.bmp etc. into one folder and set the foldername
here
--atmo-width=<integer [64 .. 512]>
Extracted Image Width
The width of the mini image for further processing (64 is default)
--atmo-height=<integer [48 .. 384]>
Extracted Image Height
The height of the mini image for further processing (48 is default)
--atmo-showdots, --no-atmo-showdots
Mark analyzed pixels (default disabled)
makes the sample grid visible on screen as white pixels (default
disabled)

File audio output
--audiofile-format={u8,s8,u16,s16,u16_le,s16_le,u16_be,s16_be,fixed32,float32,spdif}
Output format
One of "u8", "s8", "u16", "s16", "u16_le", "s16_le", "u16_be",
"s16_be", "fixed32", "float32" or "spdif"
--audiofile-channels=<integer>
Number of output channels
By default, all the channels of the incoming will be saved but you
can restrict the number of channels here.
--audiofile-file=<string> Output file
File to which the audio samples will be written to. ("-" for stdout
--audiofile-wav, --no-audiofile-wav
Add WAVE header (default enabled)
Instead of writing a raw file, you can add a WAV header to the file.
(default enabled)

DirectX audio output
--directx-audio-device-name={default}
Output device
Select your audio output device
--directx-audio-float32, --no-directx-audio-float32
Use float32 output (default disabled)
The option allows you to enable or disable the high-quality float32
audio output mode (which is not well supported by some soundcards).
(default disabled)
--directx-audio-speaker={Windows default,Mono,Stereo,Quad,5.1,7.1}
Speaker configuration
Select speaker configuration you want to use. This option doesn't
upmix! So NO e.g. Stereo -> 5.1 conversion.

Alpha mask video filter
Use an image's alpha channel as a transparency mask.
--alphamask-mask=<string> Transparency mask
Alpha blending transparency mask. Uses a png alpha channel.

Image properties filter
--contrast=<float [0.000000 .. 2.000000]>
Image contrast (0-2)
Set the image contrast, between 0 and 2. Defaults to 1.
--brightness=<float [0.000000 .. 2.000000]>
Image brightness (0-2)
Set the image brightness, between 0 and 2. Defaults to 1.
--hue=<integer [0 .. 360]> Image hue (0-360)
Set the image hue, between 0 and 360. Defaults to 0.
--saturation=<float [0.000000 .. 3.000000]>
Image saturation (0-3)
Set the image saturation, between 0 and 3. Defaults to 1.
--gamma=<float [0.010000 .. 10.000000]>
Image gamma (0-10)
Set the image gamma, between 0.01 and 10. Defaults to 1.
--brightness-threshold, --no-brightness-threshold
Brightness threshold (default disabled)
When this mode is enabled, pixels will be shown as black or white.
The threshold value will be the brighness defined below. (default
disabled)

UDP input
--udp-caching=<integer> Caching value in ms
Caching value for UDP streams. This value should be set in
milliseconds.

TCP input
--tcp-caching=<integer> Caching value in ms
Caching value for TCP streams. This value should be set in
milliseconds.

SMB input
Samba (Windows network shares) input
--smb-caching=<integer> Caching value in ms
Caching value for SMB streams. This value should be set in
milliseconds.
--smb-user=<string> SMB user name
User name that will be used for the connection.
--smb-pwd=<string> SMB password
Password that will be used for the connection.
--smb-domain=<string> SMB domain
Domain/Workgroup that will be used for the connection.

Real RTSP
--realrtsp-caching=<integer>
Caching value (ms)
Caching value for RTSP streams. This value should be set in
milliseconds.

UDP stream output
--sout-udp-caching=<integer>
Caching value (ms)
Default caching value for outbound UDP streams. This value should be
set in milliseconds.
--sout-udp-group=<integer> Group packets
Packets can be sent one by one at the right time or by groups. You
can choose the number of packets that will be sent at a time. It
helps reducing the scheduling load on heavily-loaded systems.

IceCAST output
--sout-shout-name=<string> Stream name
Name to give to this stream/channel on the shoutcast/icecast server.
--sout-shout-description=<string>
Stream description
Description of the stream content or information about your channel.
--sout-shout-mp3, --no-sout-shout-mp3
Stream MP3 (default disabled)
You normally have to feed the shoutcast module with Ogg streams. It
is also possible to stream MP3 instead, so you can forward MP3
streams to the shoutcast/icecast server. (default disabled)
--sout-shout-genre=<string>
Genre description
Genre of the content.
--sout-shout-url=<string> URL description
URL with information about the stream or your channel.
--sout-shout-bitrate=<string>
Bitrate
Bitrate information of the transcoded stream.
--sout-shout-samplerate=<string>
Samplerate
Samplerate information of the transcoded stream.
--sout-shout-channels=<string>
Number of channels
Number of channels information of the transcoded stream.
--sout-shout-quality=<string>
Ogg Vorbis Quality
Ogg Vorbis Quality information of the transcoded stream.
--sout-shout-public, --no-sout-shout-public
Stream public (default disabled)
Make the server publicly available on the 'Yellow Pages' (directory
listing of streams) on the icecast/shoutcast website. Requires the
bitrate information specified for shoutcast. Requires Ogg streaming
for icecast. (default disabled)

HTTP stream output
--sout-http-user=<string> Username
User name that will be requested to access the stream.
--sout-http-pwd=<string> Password
Password that will be requested to access the stream.
--sout-http-mime=<string> Mime
MIME returned by the server (autodetected if not specified).
--sout-http-cert=<string> Certificate file
Path to the x509 PEM certificate file that will be used for HTTPS.
--sout-http-key=<string> Private key file
Path to the x509 PEM private key file that will be used for HTTPS.
Leave empty if you don't have one.
--sout-http-ca=<string> Root CA file
Path to the x509 PEM trusted root CA certificates (certificate
authority) file that will be used for HTTPS. Leave empty if you don't
have one.
--sout-http-crl=<string> CRL file
Path to the x509 PEM Certificates Revocation List file that will be
used for SSL. Leave empty if you don't have one.

File stream output
--sout-file-append, --no-sout-file-append
Append to file (default disabled)
Append to file if it exists instead of replacing it. (default
disabled)

Microsoft Media Server (MMS) input
--mms-caching=<integer> Caching value in ms
Caching value for MMS streams. This value should be set in
milliseconds.
--mms-timeout=<integer> TCP/UDP timeout (ms)
Amount of time (in ms) to wait before aborting network reception of
data. Note that there will be 10 retries before completely giving up.
--mms-all, --no-mms-all Force selection of all streams (default
disabled)
MMS streams can contain several elementary streams, with different
bitrates. You can choose to select all of them. (default disabled)
--mms-maxbitrate=<integer> Maximum bitrate
Select the stream with the maximum bitrate under that limit.
--mmsh-proxy=<string> HTTP proxy
HTTP proxy to be used It must be of the form http://[user[:pass]@]mypr
oxy.mydomain:myport/ ; if empty, the http_proxy environment variable
will be tried.

Memory input
--imem-caching=<integer> Caching value in ms
Caching value for imem streams. This value should be set in
milliseconds.
--imem-get=<string> Get function
Address of the get callback function
--imem-release=<string> Release function
Address of the release callback function
--imem-cookie=<string> Callback cookie string
Text identifier for the callback functions
--imem-data=<string> Callback data
Data for the get and release functions
--imem-id=<integer> ID
Set the ID of the elementary stream
--imem-group=<integer> Group
Set the group of the elementary stream
--imem-cat={0 (Unknown), 1 (Audio), 2 (Video), 3 (Subtitle), 4 (Data)}
Category
Set the category of the elementary stream
--imem-codec=<string> Codec
Set the codec of the elementary stream
--imem-language=<string> Language
Language of the elementary stream as described by ISO639
--imem-samplerate=<integer>
Sample rate
Sample rate of an audio elementary stream
--imem-channels=<integer> Channels count
Channels count of an audio elementary stream
--imem-width=<integer> Width
Width of video or subtitle elementary streams
--imem-height=<integer> Height
Height of video or subtitle elementary streams
--imem-dar=<string> Display aspect ratio
Display aspect ratio of a video elementary stream
--imem-fps=<string> Frame rate
Frame rate of a video elementary stream

HTTP input
--http-proxy=<string> HTTP proxy
HTTP proxy to be used It must be of the form http://[user@]myproxy.myd
omain:myport/ ; if empty, the http_proxy environment variable will be
tried.
--http-proxy-pwd=<string> HTTP proxy password
If your HTTP proxy requires a password, set it here.
--http-caching=<integer> Caching value in ms
Caching value for HTTP streams. This value should be set in
milliseconds.
--http-user-agent=<string> HTTP user agent
User agent that will be used for the connection.
--http-reconnect, --no-http-reconnect
Auto re-connect (default disabled)
Automatically try to reconnect to the stream in case of a sudden
disconnect. (default disabled)
--http-continuous, --no-http-continuous
Continuous stream (default disabled)
Read a file that is being constantly updated (for example, a JPG file
on a server). You should not globally enable this option as it will
break all other types of HTTP streams. (default disabled)
--http-forward-cookies, --no-http-forward-cookies
Forward Cookies (default enabled)
Forward Cookies across http redirections. (default enabled)
--http-max-redirect=<integer>
Max number of redirection
Limit the number of redirection to follow.
--http-use-IE-proxy, --no-http-use-IE-proxy
Use Internet Explorer entered HTTP proxy
server (default disabled)
Use Internet Explorer entered HTTP proxy server for all URL. Don't
take into account bypasses settings and auto configuration scripts.
(default disabled)

FTP input
--ftp-caching=<integer> Caching value in ms
Caching value for FTP streams. This value should be set in
milliseconds.
--ftp-user=<string> FTP user name
User name that will be used for the connection.
--ftp-pwd=<string> FTP password
Password that will be used for the connection.
--ftp-account=<string> FTP account
Account that will be used for the connection.

Fake video input
--fake-caching=<integer> Caching value in ms
Caching value for fake streams. This value should be set in
milliseconds.
--fake-fps=<float> Framerate
Number of frames per second (eg. 24, 25, 29.97, 30).
--fake-id=<integer> ID
Set the ID of the fake elementary stream for use in #duplicate{}
constructs (default 0).
--fake-duration=<integer> Duration in ms
Duration of the fake streaming before faking an end-of-file (default
is -1 meaning that the stream is unlimited when fake is forced, or
lasts for 10 seconds otherwise. 0, means that the stream is
unlimited).

Blu-Ray Disc Input
--bd-caching=<integer> Caching value in ms
Caching value for BDs. This value should be set in milliseconds.

ATSC A/52 (AC-3) audio decoder
--a52-dynrng, --no-a52-dynrng
A/52 dynamic range compression (default
enabled)
Dynamic range compression makes the loud sounds softer, and the soft
sounds louder, so you can more easily listen to the stream in a noisy
environment without disturbing anyone. If you disable the dynamic
range compression the playback will be more adapted to a movie
theater or a listening room. (default enabled)
--a52-upmix, --no-a52-upmix
Enable internal upmixing (default disabled)
Enable the internal upmixing algorithm (not recommended). (default
disabled)

Audio
These options allow you to modify the behavior of the audio subsystem, and to add audio filters which can be used for post processing or visual effects (spectrum analyzer, etc.). Enable these filters here, and configure them in the "audio filters" modules section.
--audio, --no-audio Enable audio (default enabled)
You can completely disable the audio output. The audio decoding stage
will not take place, thus saving some processing power. (default
enabled)
--volume=<integer [0 .. 1024]>
Default audio volume
You can set the default audio output volume here, in a range from 0
to 1024.
--volume-step=<integer [0 .. 1024]>
Audio output volume step
The step size of the volume is adjustable using this option, in a
range from 0 to 1024.
--aout-rate=<integer> Audio output frequency (Hz)
You can force the audio output frequency here. Common values are -1
(default), 48000, 44100, 32000, 22050, 16000, 11025, 8000.
--hq-resampling, --no-hq-resampling
High quality audio resampling (default
enabled)
This uses a high quality audio resampling algorithm. High quality
audio resampling can be processor intensive so you can disable it and
a cheaper resampling algorithm will be used instead. (default enabled)
--spdif, --no-spdif Use S/PDIF when available (default disabled)
S/PDIF can be used by default when your hardware supports it as well
as the audio stream being played. (default disabled)
--force-dolby-surround={0 (Auto), 1 (On), 2 (Off)}
Force detection of Dolby Surround
Use this when you know your stream is (or is not) encoded with Dolby
Surround but fails to be detected as such. Even if the stream is not
actually encoded with Dolby Surround, turning on this option might
enhance your experience, especially when combined with the Headphone
Channel Mixer.
--audio-desync=<integer> Audio desynchronization compensation
This delays the audio output. The delay must be given in
milliseconds. This can be handy if you notice a lag between the video
and the audio.
--audio-replay-gain-mode={none,track,album}
Replay gain mode
Select the replay gain mode
--audio-replay-gain-preamp=<float>
Replay preamp
This allows you to change the default target level (89 dB) for stream
with replay gain information
--audio-replay-gain-default=<float>
Default replay gain
This is the gain used for stream without replay gain information
--audio-replay-gain-peak-protection, --no-audio-replay-gain-peak-protection
Peak protection (default enabled)
Protect against sound clipping (default enabled)
--audio-time-stretch, --no-audio-time-stretch
Enable time streching audio (default enabled)
This allows to play audio at lower or higher speed without affecting
the audio pitch (default enabled)
-A, --aout=<string> Audio output module
This is the audio output method used by VLC. The default behavior is
to automatically select the best method available.
--audio-filter=<string> Audio filters
This adds audio post processing filters, to modify the sound
rendering.
--audio-visual=<string> Audio visualizations
This adds visualization modules (spectrum analyzer, etc.).

Video
These options allow you to modify the behavior of the video output subsystem. You can for example enable video filters (deinterlacing, image adjusting, etc.). Enable these filters here and configure them in the "video filters" modules section. You can also set many miscellaneous video options.
--video, --no-video Enable video (default enabled)
You can completely disable the video output. The video decoding stage
will not take place, thus saving some processing power. (default
enabled)
--grayscale, --no-grayscale
Grayscale video output (default disabled)
Output video in grayscale. As the color information aren't decoded,
this can save some processing power. (default disabled)
-f, --fullscreen, --no-fullscreen
Fullscreen video output (default disabled)
Start video in fullscreen mode (default disabled)
--embedded-video, --no-embedded-video
Embedded video (default enabled)
Embed the video output in the main interface. (default enabled)
--x11-display=<string> X11 display
X11 hardware display to use. By default VLC will use the value of the
DISPLAY environment variable.
--xlib, --no-xlib (default enabled)
--drop-late-frames, --no-drop-late-frames
Drop late frames (default enabled)
This drops frames that are late (arrive to the video output after
their intended display date). (default enabled)
--skip-frames, --no-skip-frames
Skip frames (default enabled)
Enables framedropping on MPEG2 stream. Framedropping occurs when your
computer is not powerful enough (default enabled)
--quiet-synchro, --no-quiet-synchro
Quiet synchro (default disabled)
This avoids flooding the message log with debug output from the video
output synchronization mechanism. (default disabled)
--keyboard-events, --no-keyboard-events
Key press events (default enabled)
This enables VLC hotkeys from the (non-embedded) video window.
(default enabled)
--mouse-events, --no-mouse-events
Mouse events (default enabled)
This enables handling of mouse clicks on the video. (default enabled)
--overlay, --no-overlay Overlay video output (default enabled)
Overlay is the hardware acceleration capability of your video card
(ability to render video directly). VLC will try to use it by
default. (default enabled)
--video-on-top, --no-video-on-top
Always on top (default disabled)
Always place the video window on top of other windows. (default
disabled)
--video-wallpaper, --no-video-wallpaper
Enable wallpaper mode (default disabled)
The wallpaper mode allows you to display the video as the desktop
background. (default disabled)
--disable-screensaver, --no-disable-screensaver
Disable screensaver (default enabled)
Disable the screensaver during video playback. (default enabled)
--video-title-show, --no-video-title-show
Show media title on video (default enabled)
Display the title of the video on top of the movie. (default enabled)
--video-title-timeout=<integer>
Show video title for x milliseconds
Show the video title for n milliseconds, default is 5000 ms (5 sec.)
--video-title-position={0 (Center), 1 (Left), 2 (Right), 4 (Top), 8 (Bottom), 5 (Top-Left), 6 (Top-Right), 9 (Bottom-Left), 10 (Bottom-Right)}
Position of video title
Place on video where to display the title (default bottom center).
--mouse-hide-timeout=<integer>
Hide cursor and fullscreen controller after x
milliseconds
Hide mouse cursor and fullscreen controller after n milliseconds,
default is 3000 ms (3 sec.)
Snapshot:
--snapshot-path=<string> Video snapshot directory (or filename)
Directory where the video snapshots will be stored.
--snapshot-prefix=<string> Video snapshot file prefix
Video snapshot file prefix
--snapshot-format={png,jpg}
Video snapshot format
Image format which will be used to store the video snapshots
--snapshot-preview, --no-snapshot-preview
Display video snapshot preview (default
enabled)
Display the snapshot preview in the screen's top-left corner.
(default enabled)
--snapshot-sequential, --no-snapshot-sequential
Use sequential numbers instead of timestamps
(default disabled)
Use sequential numbers instead of timestamps for snapshot numbering
(default disabled)
--snapshot-width=<integer> Video snapshot width
You can enforce the width of the video snapshot. By default it will
keep the original width (-1). Using 0 will scale the width to keep
the aspect ratio.
--snapshot-height=<integer>
Video snapshot height
You can enforce the height of the video snapshot. By default it will
keep the original height (-1). Using 0 will scale the height to keep
the aspect ratio.
Window properties:
--width=<integer> Video width
You can enforce the video width. By default (-1) VLC will adapt to
the video characteristics.
--height=<integer> Video height
You can enforce the video height. By default (-1) VLC will adapt to
the video characteristics.
--video-x=<integer> Video X coordinate
You can enforce the position of the top left corner of the video
window (X coordinate).
--video-y=<integer> Video Y coordinate
You can enforce the position of the top left corner of the video
window (Y coordinate).
--crop=<string> Video cropping
This forces the cropping of the source video. Accepted formats are
x:y (4:3, 16:9, etc.) expressing the global image aspect.
--custom-crop-ratios=<string>
Custom crop ratios list
Comma separated list of crop ratios which will be added in the
interface's crop ratios list.
--aspect-ratio=<string> Source aspect ratio
This forces the source aspect ratio. For instance, some DVDs claim to
be 16:9 while they are actually 4:3. This can also be used as a hint
for VLC when a movie does not have aspect ratio information. Accepted
formats are x:y (4:3, 16:9, etc.) expressing the global image aspect,
or a float value (1.25, 1.3333, etc.) expressing pixel squareness.
--autoscale, --no-autoscale
Video Auto Scaling (default enabled)
Let the video scale to fit a given window or fullscreen. (default
enabled)
--scale=<float> Video scaling factor
Scaling factor used when Auto Scaling is disabled.
Default value is
1.0 (original video size).
--monitor-par=<string> Monitor pixel aspect ratio
This forces the monitor aspect ratio. Most monitors have square
pixels (1:1). If you have a 16:9 screen, you might need to change
this to 4:3 in order to keep proportions.
--custom-aspect-ratios=<string>
Custom aspect ratios list
Comma separated list of aspect ratios which will be added in the
interface's aspect ratio list.
--hdtv-fix, --no-hdtv-fix Fix HDTV height (default enabled)
This allows proper handling of HDTV-1080 video format even if broken
encoder incorrectly sets height to 1088 lines. You should only
disable this option if your video has a non-standard format requiring
all 1088 lines. (default enabled)
--video-deco, --no-video-deco
Window decorations (default enabled)
VLC can avoid creating window caption, frames, etc... around the
video, giving a "minimal" window. (default enabled)
--video-title=<string> Video title
Custom title for the video window (in case the video is not embedded
in the interface).
--align={0 (Center), 1 (Left), 2 (Right), 4 (Top), 8 (Bottom), 5 (Top-Left), 6 (Top-Right), 9 (Bottom-Left), 10 (Bottom-Right)}
Video alignment
Enforce the alignment of the video in its window. By default (0) it
will be centered (0=center, 1=left, 2=right, 4=top, 8=bottom, you can
also use combinations of these values, like 6=4+2 meaning top-right).
--zoom=<float> Zoom video
You can zoom the video by the specified factor.
--deinterlace={0 (Off), -1 (Automatic), 1 (On)}
Deinterlace
Deinterlace
--deinterlace-mode={discard,blend,mean,bob,linear,x,yadif,yadif2x}
Deinterlace mode
Deinterlace method to use for video processing.
-V, --vout=<string> Video output module
This is the the video output method used by VLC. The default behavior
is to automatically select the best method available.
--video-filter=<string> Video filter module
This adds post-processing filters to enhance the picture quality, for
instance deinterlacing, or distort the video.
--vout-filter=<string> Video output filter module
This adds video output filters like clone or wall

Subpictures
These options allow you to modify the behavior of the subpictures subsystem. You can for example enable subpictures filters (logo, etc.). Enable these filters here and configure them in the "subpictures filters" modules section. You can also set many miscellaneous subpictures options.
On Screen Display:
--spu, --no-spu Enable sub-pictures (default enabled)
You can completely disable the sub-picture processing. (default
enabled)
--osd, --no-osd On Screen Display (default enabled)
VLC can display messages on the video. This is called OSD (On Screen
Display). (default enabled)
--text-renderer=<string> Text rendering module
VLC normally uses Freetype for rendering, but this allows you to use
svg for instance.
Subtitles:
--sub-file=<string> Use subtitle file
Load this subtitle file. To be used when autodetect cannot detect
your subtitle file.
--sub-autodetect-file, --no-sub-autodetect-file
Autodetect subtitle files (default enabled)
Automatically detect a subtitle file, if no subtitle filename is
specified (based on the filename of the movie). (default enabled)
--sub-autodetect-fuzzy=<integer>
Subtitle autodetection fuzziness
This determines how fuzzy subtitle and movie filename matching will
be. Options are:
0 = no subtitles autodetected
1 = any subtitle
file
2 = any subtitle file containing the movie name
3 = subtitle
file matching the movie name with additional chars
4 = subtitle file
matching the movie name exactly
--sub-autodetect-path=<string>
Subtitle autodetection paths
Look for a subtitle file in those paths too, if your subtitle file
was not found in the current directory.
--sub-margin=<integer> Force subtitle position
You can use this option to place the subtitles under the movie,
instead of over the movie. Try several positions.
Overlays:
--sub-filter=<string> Subpictures filter module
This adds so-called "subpicture filters". These filters overlay some
images or text over the video (like a logo, arbitrary text, ...).
Track settings:
--program=<integer> Program
Choose the program to select by giving its Service ID. Only use this
option if you want to read a multi-program stream (like DVB streams
for example).
--programs=<string> Programs
Choose the programs to select by giving a comma-separated list of
Service IDs (SIDs). Only use this option if you want to read a
multi-program stream (like DVB streams for example).
--audio-track=<integer> Audio track
Stream number of the audio track to use (from 0 to n).
--sub-track=<integer> Subtitles track
Stream number of the subtitle track to use (from 0 to n).
--audio-language=<string> Audio language
Language of the audio track you want to use (comma separated, two or
three letter country code, you may use 'none' to avoid a fallback to
another language).
--sub-language=<string> Subtitle language
Language of the subtitle track you want to use (comma separated, two
or three letters country code, you may use 'any' as a fallback).
--audio-track-id=<integer> Audio track ID
Stream ID of the audio track to use.
--sub-track-id=<integer> Subtitles track ID
Stream ID of the subtitle track to use.
Playback control:
--input-repeat=<integer> Input repetitions
Number of time the same input will be repeated
--start-time=<float> Start time
The stream will start at this position (in seconds).
--stop-time=<float> Stop time
The stream will stop at this position (in seconds).
--run-time=<float> Run time
The stream will run this duration (in seconds).
--input-fast-seek, --no-input-fast-seek
Fast seek (default disabled)
Favor speed over precision while seeking (default disabled)
--rate=<float> Playback speed
This defines the playback speed (nominal speed is 1.0).
--input-list=<string> Input list
You can give a comma-separated list of inputs that will be
concatenated together after the normal one.
--input-slave=<string> Input slave (experimental)
This allows you to play from several inputs at the same time. This
feature is experimental, not all formats are supported. Use a '#'
separated list of inputs.
--bookmarks=<string> Bookmarks list for a stream
You can manually give a list of bookmarks for a stream in the form
"{name=bookmark-name,time=optional-time-offset,bytes=optional-byte-off
set},{...}"
Default devices:
--dvd=<string> DVD device
This is the default DVD drive (or file) to use. Don't forget the
colon after the drive letter (eg. D:)
--vcd=<string> VCD device
This is the default VCD device to use.
--cd-audio=<string> Audio CD device
This is the default Audio CD device to use.
Network settings:
--server-port=<integer> UDP port
This is the default port used for UDP streams. Default is 1234.
--mtu=<integer> MTU of the network interface
This is the maximum application-layer packet size that can be
transmitted over the network (in bytes).
-6, --ipv6, --no-ipv6 Force IPv6 (default disabled)
IPv6 will be used by default for all connections. (default disabled)
-4, --ipv4, --no-ipv4 Force IPv4 (default disabled)
IPv4 will be used by default for all connections. (default disabled)
--ipv4-timeout=<integer> TCP connection timeout
Default TCP connection timeout (in milliseconds).
Socks proxy:
--socks=<string> SOCKS server
SOCKS proxy server to use. This must be of the form address:port. It
will be used for all TCP connections
--socks-user=<string> SOCKS user name
User name to be used for connection to the SOCKS proxy.
--socks-pwd=<string> SOCKS password
Password to be used for connection to the SOCKS proxy.
Metadata:
--meta-title=<string> Title metadata
Allows you to specify a "title" metadata for an input.
--meta-author=<string> Author metadata
Allows you to specify an "author" metadata for an input.
--meta-artist=<string> Artist metadata
Allows you to specify an "artist" metadata for an input.
--meta-genre=<string> Genre metadata
Allows you to specify a "genre" metadata for an input.
--meta-copyright=<string> Copyright metadata
Allows you to specify a "copyright" metadata for an input.
--meta-description=<string>
Description metadata
Allows you to specify a "description" metadata for an input.
--meta-date=<string> Date metadata
Allows you to specify a "date" metadata for an input.
--meta-url=<string> URL metadata
Allows you to specify a "url" metadata for an input.
Advanced:
--cr-average=<integer> Clock reference average counter
When using the PVR input (or a very irregular source), you should set
this to 10000.
--clock-synchro={-1 (Default), 0 (Disable), 1 (Enable)}
Clock synchronisation
It is possible to disable the input clock synchronisation for
real-time sources. Use this if you experience jerky playback of
network streams.
--clock-jitter=<integer> Clock jitter
It tells the clock algorithms what is the maximal input jitter that
is considered valid and can be compensated (in milliseconds)
--network-synchronisation, --no-network-synchronisation
Network synchronisation (default disabled)
This allows you to remotely synchronise clocks for server and client.
The detailed settings are available in Advanced / Network Sync.
(default disabled)
--input-record-path=<string>
Record directory or filename
Directory or filename where the records will be stored
--input-record-native, --no-input-record-native
Prefer native stream recording (default
enabled)
When possible, the input stream will be recorded instead of using the
stream output module (default enabled)
--input-timeshift-path=<string>
Timeshift directory
Directory used to store the timeshift temporary files.
--input-timeshift-granularity=<integer>
Timeshift granularity
This is the maximum size in bytes of the temporary files that will be
used to store the timeshifted streams.

Decoders
This option can be used to alter the way VLC selects its codecs (decompression methods). Only advanced users should alter this option as it can break playback of all your streams.
--codec=<string> Preferred decoders list
List of codecs that VLC will use in priority. For instance,
'dummy,a52' will try the dummy and a52 codecs before trying the other
ones. Only advanced users should alter this option as it can break
playback of all your streams.
--encoder=<string> Preferred encoders list
This allows you to select a list of encoders that VLC will use in
priority.

Input
These options allow you to modify the behavior of the input subsystem, such as the DVD or VCD device, the network interface settings or the subtitle channel.
--access=<string> Access module
This allows you to force an access module. You can use it if the
correct access is not automatically detected. You should not set this
as a global option unless you really know what you are doing.
--demux=<string> Demux module
Demultiplexers are used to separate the "elementary" streams (like
audio and video streams). You can use it if the correct demuxer is
not automatically detected. You should not set this as a global
option unless you really know what you are doing.
--prefer-system-codecs, --no-prefer-system-codecs
Prefer system plugins over VLC (default
disabled)
Indicates whether VLC will prefer native plugins installed on system
over VLC owns plugins whenever a choice is available. (default
disabled)
--stream-filter=<string> Stream filter module
Stream filters are used to modify the stream that is being read.

Stream output
These options allow you to set default global options for the stream output subsystem.
--sout=<string> Default stream output chain
You can enter here a default stream output chain. Refer to the
documentation to learn how to build such chains. Warning: this chain
will be enabled for all streams.
--sout-display, --no-sout-display
Display while streaming (default disabled)
Play locally the stream while streaming it. (default disabled)
--sout-keep, --no-sout-keep
Keep stream output open (default disabled)
This allows you to keep an unique stream output instance across
multiple playlist item (automatically insert the gather stream output
if not specified) (default disabled)
--sout-all, --no-sout-all Enable streaming of all ES (default disabled)
Stream all elementary streams (video, audio and subtitles) (default
disabled)
--sout-audio, --no-sout-audio
Enable audio stream output (default enabled)
Choose whether the audio stream should be redirected to the stream
output facility when this last one is enabled. (default enabled)
--sout-video, --no-sout-video
Enable video stream output (default enabled)
Choose whether the video stream should be redirected to the stream
output facility when this last one is enabled. (default enabled)
--sout-spu, --no-sout-spu Enable SPU stream output (default enabled)
Choose whether the SPU streams should be redirected to the stream
output facility when this last one is enabled. (default enabled)
--sout-mux-caching=<integer>
Stream output muxer caching (ms)
This allow you to configure the initial caching amount for stream
output muxer. This value should be set in milliseconds.
VLM:
--vlm-conf=<string> VLM configuration file
Read a VLM configuration file as soon as VLM is started.
--mux=<string> Mux module
This is a legacy entry to let you configure mux modules
--access_output=<string> Access output module
This is a legacy entry to let you configure access output modules
--ttl=<integer> Hop limit (TTL)
This is the hop limit (also known as "Time-To-Live" or TTL) of the
multicast packets sent by the stream output (-1 = use operating
system built-in default).
--miface=<string> Multicast output interface
Default multicast interface. This overrides the routing table.
--miface-addr=<string> IPv4 multicast output interface address
IPv4 address for the default multicast interface. This overrides the
routing table.
--dscp=<integer> DiffServ Code Point
Differentiated Services Code Point for outgoing UDP streams (or IPv4
Type Of Service, or IPv6 Traffic Class). This is used for network
Quality of Service.
--packetizer=<string> Preferred packetizer list
This allows you to select the order in which VLC will choose its
packetizers.
--sap-interval=<integer> SAP announcement interval
When the SAP flow control is disabled, this lets you set the fixed
interval between SAP announcements.

CPU
These options allow you to enable special CPU optimizations. You should always leave all these enabled.
--mmx, --no-mmx Enable CPU MMX support (default enabled)
If your processor supports the MMX instructions set, VLC can take
advantage of them. (default enabled)
--3dn, --no-3dn Enable CPU 3D Now! support (default enabled)
If your processor supports the 3D Now! instructions set, VLC can take
advantage of them. (default enabled)
--mmxext, --no-mmxext Enable CPU MMX EXT support (default enabled)
If your processor supports the MMX EXT instructions set, VLC can take
advantage of them. (default enabled)
--sse, --no-sse Enable CPU SSE support (default enabled)
If your processor supports the SSE instructions set, VLC can take
advantage of them. (default enabled)
--sse2, --no-sse2 Enable CPU SSE2 support (default enabled)
If your processor supports the SSE2 instructions set, VLC can take
advantage of them. (default enabled)
--sse3, --no-sse3 Enable CPU SSE3 support (default enabled)
If your processor supports the SSE3 instructions set, VLC can take
advantage of them. (default enabled)
--ssse3, --no-ssse3 Enable CPU SSSE3 support (default enabled)
If your processor supports the SSSE3 instructions set, VLC can take
advantage of them. (default enabled)
--sse41, --no-sse41 Enable CPU SSE4.1 support (default enabled)
If your processor supports the SSE4.1 instructions set, VLC can take
advantage of them. (default enabled)
--sse42, --no-sse42 Enable CPU SSE4.2 support (default enabled)
If your processor supports the SSE4.2 instructions set, VLC can take
advantage of them. (default enabled)

Miscellaneous
These options allow you to select default modules. Leave these alone unless you really know what you are doing.
Special modules:
--memcpy=<string> Memory copy module
You can select which memory copy module you want to use. By default
VLC will select the fastest one supported by your hardware.
Plugins:
--plugins-cache, --no-plugins-cache
Use a plugins cache (default enabled)
Use a plugins cache which will greatly improve the startup time of
VLC. (default enabled)
--plugin-path=<string> Modules search path
Additional path for VLC to look for its modules. You can add several
paths by concatenating them using " PATH_SEP " as separator
--data-path=<string> Data search path
Override the default data/share search path.
--user-agent=<string> (null)
Performance options:
--one-instance, --no-one-instance
Allow only one running instance (default
disabled)
Allowing only one running instance of VLC can sometimes be useful,
for example if you associated VLC with some media types and you don't
want a new instance of VLC to be opened each time you double-click on
a file in the explorer. This option will allow you to play the file
with the already running instance or enqueue it. (default disabled)
--started-from-file, --no-started-from-file
VLC is started from file association (default
disabled)
Tell VLC that it is being launched due to a file association in the
OS (default disabled)
--one-instance-when-started-from-file, --no-one-instance-when-started-from-file
One instance when started from file (default
enabled)
Allow only one running instance when started from file. (default
enabled)
--playlist-enqueue, --no-playlist-enqueue
Enqueue items to playlist when in one
instance mode (default disabled)
When using the one instance only option, enqueue items to playlist
and keep playing current item. (default disabled)
--high-priority, --no-high-priority
Increase the priority of the process (default
disabled)
Increasing the priority of the process will very likely improve your
playing experience as it allows VLC not to be disturbed by other
applications that could otherwise take too much processor time.
However be advised that in certain circumstances (bugs) VLC could
take all the processor time and render the whole system unresponsive
which might require a reboot of your machine. (default disabled)

Playlist
These options define the behavior of the playlist. Some of them can be overridden in the playlist dialog box.
-Z, --random, --no-random Play files randomly forever (default disabled)
VLC will randomly play files in the playlist until interrupted.
(default disabled)
-L, --loop, --no-loop Repeat all (default disabled)
VLC will keep playing the playlist indefinitely. (default disabled)
-R, --repeat, --no-repeat Repeat current item (default disabled)
VLC will keep playing the current playlist item. (default disabled)
--play-and-exit, --no-play-and-exit
Play and exit (default disabled)
Exit if there are no more items in the playlist. (default disabled)
--play-and-stop, --no-play-and-stop
Play and stop (default disabled)
Stop the playlist after each played playlist item. (default disabled)
--play-and-pause, --no-play-and-pause
Play and pause (default disabled)
Pause each item in the playlist on the last frame. (default disabled)
--media-library, --no-media-library
Use media library (default enabled)
The media library is automatically saved and reloaded each time you
start VLC. (default enabled)
--playlist-tree, --no-playlist-tree
Display playlist tree (default disabled)
The playlist can use a tree to categorize some items, like the
contents of a directory. (default disabled)
--open=<string> Default stream
This stream will always be opened at VLC startup.
--auto-preparse, --no-auto-preparse
Automatically preparse files (default enabled)
Automatically preparse files added to the playlist (to retrieve some
metadata). (default enabled)
--album-art={0 (Manual download only), 1 (When track starts playing), 2 (As soon as track is added)}
Album art policy
Choose how album art will be downloaded.
-S, --services-discovery=<string>
Services discovery modules
Specifies the services discovery modules to load, separated by
colons. Typical values are sap, hal, ...
-v, --verbose=<integer> Verbosity (0,1,2)
This is the verbosity level (0=only errors and standard messages,
1=warnings, 2=debug).
--verbose-objects=<string> Choose which objects should print debug
message
This is a ',' separated string, each objects should be prefixed by a
'+' or a '-' to respectively enable or disable it. The keyword 'all'
refers to all objects. Objects can be refered to by their type or
module name. Rules applying to named objects take precedence over
rules applying to object types. Note that you still need to use -vvv
to actually display debug message.
-q, --quiet, --no-quiet Be quiet (default disabled)
Turn off all warning and information messages. (default disabled)
--file-logging, --no-file-logging
Log to file (default disabled)
Log all VLC messages to a text file. (default disabled)
--language={auto,en,ar,bn,pt_BR,en_GB,bg,ca,zh_TW,cs,da,nl,fi,fr,gl,ka,de,he,hr,hu,id,it,ja,ko,lt,mn,ms,nn,kk,km,oc,fa,pl,pt_PT,pa,ro,ru,zh_CN,sr,sk,sl,ckb,es,sv,tr,uk,vi,wa}
Language
You can manually select a language for the interface. The system
language is auto-detected if "auto" is specified here.
--color, --no-color Color messages (default enabled)
This enables colorization of the messages sent to the console Your
terminal needs Linux color support for this to work. (default enabled)
--advanced, --no-advanced Show advanced options (default disabled)
When this is enabled, the preferences and/or interfaces will show all
available options, including those that most users should never
touch. (default disabled)
--interact, --no-interact Interface interaction (default enabled)
When this is enabled, the interface will show a dialog box each time
some user input is required. (default enabled)
--stats, --no-stats Locally collect statistics (default enabled)
Collect miscellaneous local statistics about the playing media.
(default enabled)
-I, --intf=<string> Interface module
This is the main interface used by VLC. The default behavior is to
automatically select the best module available.
--extraintf=<string> Extra interface modules
You can select "additional interfaces" for VLC. They will be launched
in the background in addition to the default interface. Use a colon
separated list of interface modules. (common values are "rc" (remote
control), "http", "gestures" ...)
--control=<string> Control interfaces
You can select control interfaces for VLC.

Hot keys
These settings are the global VLC key bindings, known as "hotkeys".
--key-toggle-fullscreen=<integer>
Fullscreen
Select the hotkey to use to swap fullscreen state.
--global-key-toggle-fullscreen=<integer>
Fullscreen
Select the hotkey to use to swap fullscreen state.
--key-leave-fullscreen=<integer>
Leave fullscreen
Select the hotkey to use to leave fullscreen state.
--global-key-leave-fullscreen=<integer>
Leave fullscreen
Select the hotkey to use to leave fullscreen state.
--key-play-pause=<integer> Play/Pause
Select the hotkey to use to swap paused state.
--global-key-play-pause=<integer>
Play/Pause
Select the hotkey to use to swap paused state.
--key-pause=<integer> Pause only
Select the hotkey to use to pause.
--global-key-pause=<integer>
Pause only
Select the hotkey to use to pause.
--key-play=<integer> Play only
Select the hotkey to use to play.
--global-key-play=<integer>
Play only
Select the hotkey to use to play.
--key-faster=<integer> Faster
Select the hotkey to use for fast forward playback.
--global-key-faster=<integer>
Faster
Select the hotkey to use for fast forward playback.
--key-slower=<integer> Slower
Select the hotkey to use for slow motion playback.
--global-key-slower=<integer>
Slower
Select the hotkey to use for slow motion playback.
--key-rate-normal=<integer>
Normal rate
Select the hotkey to set the playback rate back to normal.
--global-key-rate-normal=<integer>
Normal rate
Select the hotkey to set the playback rate back to normal.
--key-rate-faster-fine=<integer>
Faster (fine)
Select the hotkey to use for fast forward playback.
--global-key-rate-faster-fine=<integer>
Faster (fine)
Select the hotkey to use for fast forward playback.
--key-rate-slower-fine=<integer>
Slower (fine)
Select the hotkey to use for slow motion playback.
--global-key-rate-slower-fine=<integer>
Slower (fine)
Select the hotkey to use for slow motion playback.
--key-next=<integer> Next
Select the hotkey to use to skip to the next item in the playlist.
--global-key-next=<integer>
Next
Select the hotkey to use to skip to the next item in the playlist.
--key-prev=<integer> Previous
Select the hotkey to use to skip to the previous item in the playlist.
--global-key-prev=<integer>
Previous
Select the hotkey to use to skip to the previous item in the playlist.
--key-stop=<integer> Stop
Select the hotkey to stop playback.
--global-key-stop=<integer>
Stop
Select the hotkey to stop playback.
--key-position=<integer> Position
Select the hotkey to display the position.
--global-key-position=<integer>
Position
Select the hotkey to display the position.
--key-jump-extrashort=<integer>
Very short backwards jump
Select the hotkey to make a very short backwards jump.
--global-key-jump-extrashort=<integer>
Very short backwards jump
Select the hotkey to make a very short backwards jump.
--key-jump+extrashort=<integer>
Very short forward jump
Select the hotkey to make a very short forward jump.
--global-key-jump+extrashort=<integer>
Very short forward jump
Select the hotkey to make a very short forward jump.
--key-jump-short=<integer> Short backwards jump
Select the hotkey to make a short backwards jump.
--global-key-jump-short=<integer>
Short backwards jump
Select the hotkey to make a short backwards jump.
--key-jump+short=<integer> Short forward jump
Select the hotkey to make a short forward jump.
--global-key-jump+short=<integer>
Short forward jump
Select the hotkey to make a short forward jump.
--key-jump-medium=<integer>
Medium backwards jump
Select the hotkey to make a medium backwards jump.
--global-key-jump-medium=<integer>
Medium backwards jump
Select the hotkey to make a medium backwards jump.
--key-jump+medium=<integer>
Medium forward jump
Select the hotkey to make a medium forward jump.
--global-key-jump+medium=<integer>
Medium forward jump
Select the hotkey to make a medium forward jump.
--key-jump-long=<integer> Long backwards jump
Select the hotkey to make a long backwards jump.
--global-key-jump-long=<integer>
Long backwards jump
Select the hotkey to make a long backwards jump.
--key-jump+long=<integer> Long forward jump
Select the hotkey to make a long forward jump.
--global-key-jump+long=<integer>
Long forward jump
Select the hotkey to make a long forward jump.
--key-frame-next=<integer> Next frame
Select the hotkey to got to the next video frame.
--global-key-frame-next=<integer>
Next frame
Select the hotkey to got to the next video frame.
--key-nav-activate=<integer>
Activate
Select the key to activate selected item in DVD menus.
--global-key-nav-activate=<integer>
Activate
Select the key to activate selected item in DVD menus.
--key-nav-up=<integer> Navigate up
Select the key to move the selector up in DVD menus.
--global-key-nav-up=<integer>
Navigate up
Select the key to move the selector up in DVD menus.
--key-nav-down=<integer> Navigate down
Select the key to move the selector down in DVD menus.
--global-key-nav-down=<integer>
Navigate down
Select the key to move the selector down in DVD menus.
--key-nav-left=<integer> Navigate left
Select the key to move the selector left in DVD menus.
--global-key-nav-left=<integer>
Navigate left
Select the key to move the selector left in DVD menus.
--key-nav-right=<integer> Navigate right
Select the key to move the selector right in DVD menus.
--global-key-nav-right=<integer>
Navigate right
Select the key to move the selector right in DVD menus.
--key-disc-menu=<integer> Go to the DVD menu
Select the key to take you to the DVD menu
--global-key-disc-menu=<integer>
Go to the DVD menu
Select the key to take you to the DVD menu
--key-title-prev=<integer> Select previous DVD title
Select the key to choose the previous title from the DVD
--global-key-title-prev=<integer>
Select previous DVD title
Select the key to choose the previous title from the DVD
--key-title-next=<integer> Select next DVD title
Select the key to choose the next title from the DVD
--global-key-title-next=<integer>
Select next DVD title
Select the key to choose the next title from the DVD
--key-chapter-prev=<integer>
Select prev DVD chapter
Select the key to choose the previous chapter from the DVD
--global-key-chapter-prev=<integer>
Select prev DVD chapter
Select the key to choose the previous chapter from the DVD
--key-chapter-next=<integer>
Select next DVD chapter
Select the key to choose the next chapter from the DVD
--global-key-chapter-next=<integer>
Select next DVD chapter
Select the key to choose the next chapter from the DVD
--key-quit=<integer> Quit
Select the hotkey to quit the application.
--global-key-quit=<integer>
Quit
Select the hotkey to quit the application.
--key-vol-up=<integer> Volume up
Select the key to increase audio volume.
--global-key-vol-up=<integer>
Volume up
Select the key to increase audio volume.
--key-vol-down=<integer> Volume down
Select the key to decrease audio volume.
--global-key-vol-down=<integer>
Volume down
Select the key to decrease audio volume.
--key-vol-mute=<integer> Mute
Select the key to mute audio.
--global-key-vol-mute=<integer>
Mute
Select the key to mute audio.
--key-subdelay-up=<integer>
Subtitle delay up
Select the key to increase the subtitle delay.
--global-key-subdelay-up=<integer>
Subtitle delay up
Select the key to increase the subtitle delay.
--key-subdelay-down=<integer>
Subtitle delay down
Select the key to decrease the subtitle delay.
--global-key-subdelay-down=<integer>
Subtitle delay down
Select the key to decrease the subtitle delay.
--key-subpos-up=<integer> Subtitle position up
Select the key to move subtitles higher.
--global-key-subpos-up=<integer>
Subtitle position up
Select the key to move subtitles higher.
--key-subpos-down=<integer>
Subtitle position down
Select the key to move subtitles lower.
--global-key-subpos-down=<integer>
Subtitle position down
Select the key to move subtitles lower.
--key-audiodelay-up=<integer>
Audio delay up
Select the key to increase the audio delay.
--global-key-audiodelay-up=<integer>
Audio delay up
Select the key to increase the audio delay.
--key-audiodelay-down=<integer>
Audio delay down
Select the key to decrease the audio delay.
--global-key-audiodelay-down=<integer>
Audio delay down
Select the key to decrease the audio delay.
--key-audio-track=<integer>
Cycle audio track
Cycle through the available audio tracks(languages).
--global-key-audio-track=<integer>
Cycle audio track
Cycle through the available audio tracks(languages).
--key-audiodevice-cycle=<integer>
Cycle through audio devices
Cycle through available audio devices
--global-key-audiodevice-cycle=<integer>
Cycle through audio devices
Cycle through available audio devices
--key-subtitle-track=<integer>
Cycle subtitle track
Cycle through the available subtitle tracks.
--global-key-subtitle-track=<integer>
Cycle subtitle track
Cycle through the available subtitle tracks.
--key-aspect-ratio=<integer>
Cycle source aspect ratio
Cycle through a predefined list of source aspect ratios.
--global-key-aspect-ratio=<integer>
Cycle source aspect ratio
Cycle through a predefined list of source aspect ratios.
--key-crop=<integer> Cycle video crop
Cycle through a predefined list of crop formats.
--global-key-crop=<integer>
Cycle video crop
Cycle through a predefined list of crop formats.
--key-toggle-autoscale=<integer>
Toggle autoscaling
Activate or deactivate autoscaling.
--global-key-toggle-autoscale=<integer>
Toggle autoscaling
Activate or deactivate autoscaling.
--key-incr-scalefactor=<integer>
Increase scale factor
Increase scale factor.
--global-key-incr-scalefactor=<integer>
Increase scale factor
Increase scale factor.
--key-decr-scalefactor=<integer>
Decrease scale factor
Decrease scale factor.
--global-key-decr-scalefactor=<integer>
Decrease scale factor
Decrease scale factor.
--key-deinterlace=<integer>
Cycle deinterlace modes
Cycle through deinterlace modes.
--global-key-deinterlace=<integer>
Cycle deinterlace modes
Cycle through deinterlace modes.
--key-intf-show=<integer> Show interface
Raise the interface above all other windows.
--global-key-intf-show=<integer>
Show interface
Raise the interface above all other windows.
--key-intf-hide=<integer> Hide interface
Lower the interface below all other windows.
--global-key-intf-hide=<integer>
Hide interface
Lower the interface below all other windows.
--key-snapshot=<integer> Take video snapshot
Takes a video snapshot and writes it to disk.
--global-key-snapshot=<integer>
Take video snapshot
Takes a video snapshot and writes it to disk.
--key-history-back=<integer>
Go back in browsing history
Select the key to go back (to the previous media item) in the
browsing history.
--global-key-history-back=<integer>
Go back in browsing history
Select the key to go back (to the previous media item) in the
browsing history.
--key-history-forward=<integer>
Go forward in browsing history
Select the key to go forward (to the next media item) in the browsing
history.
--global-key-history-forward=<integer>
Go forward in browsing history
Select the key to go forward (to the next media item) in the browsing
history.
--key-record=<integer> Record
Record access filter start/stop.
--global-key-record=<integer>
Record
Record access filter start/stop.
--key-dump=<integer> Dump
Media dump access filter trigger.
--global-key-dump=<integer>
Dump
Media dump access filter trigger.
--key-zoom=<integer> Zoom
Zoom
--global-key-zoom=<integer>
Zoom
Zoom
--key-unzoom=<integer> Un-Zoom
Un-Zoom
--global-key-unzoom=<integer>
Un-Zoom
Un-Zoom
--key-wallpaper=<integer> Toggle wallpaper mode in video output
Toggle wallpaper mode in video output.
--global-key-wallpaper=<integer>
Toggle wallpaper mode in video output
Toggle wallpaper mode in video output.
--key-menu-on=<integer> Display OSD menu on top of video output
Display OSD menu on top of video output
--global-key-menu-on=<integer>
Display OSD menu on top of video output
Display OSD menu on top of video output
--key-menu-off=<integer> Do not display OSD menu on video output
Do not display OSD menu on top of video output
--global-key-menu-off=<integer>
Do not display OSD menu on video output
Do not display OSD menu on top of video output
--key-menu-right=<integer> Highlight widget on the right
Move OSD menu highlight to the widget on the right
--global-key-menu-right=<integer>
Highlight widget on the right
Move OSD menu highlight to the widget on the right
--key-menu-left=<integer> Highlight widget on the left
Move OSD menu highlight to the widget on the left
--global-key-menu-left=<integer>
Highlight widget on the left
Move OSD menu highlight to the widget on the left
--key-menu-up=<integer> Highlight widget on top
Move OSD menu highlight to the widget on top
--global-key-menu-up=<integer>
Highlight widget on top
Move OSD menu highlight to the widget on top
--key-menu-down=<integer> Highlight widget below
Move OSD menu highlight to the widget below
--global-key-menu-down=<integer>
Highlight widget below
Move OSD menu highlight to the widget below
--key-menu-select=<integer>
Select current widget
Selecting current widget performs the associated action.
--global-key-menu-select=<integer>
Select current widget
Selecting current widget performs the associated action.
--key-crop-top=<integer> Crop one pixel from the top of the video
Crop one pixel from the top of the video
--global-key-crop-top=<integer>
Crop one pixel from the top of the video
Crop one pixel from the top of the video
--key-uncrop-top=<integer> Uncrop one pixel from the top of the video
Uncrop one pixel from the top of the video
--global-key-uncrop-top=<integer>
Uncrop one pixel from the top of the video
Uncrop one pixel from the top of the video
--key-crop-left=<integer> Crop one pixel from the left of the video
Crop one pixel from the left of the video
--global-key-crop-left=<integer>
Crop one pixel from the left of the video
Crop one pixel from the left of the video
--key-uncrop-left=<integer>
Uncrop one pixel from the left of the video
Uncrop one pixel from the left of the video
--global-key-uncrop-left=<integer>
Uncrop one pixel from the left of the video
Uncrop one pixel from the left of the video
--key-crop-bottom=<integer>
Crop one pixel from the bottom of the video
Crop one pixel from the bottom of the video
--global-key-crop-bottom=<integer>
Crop one pixel from the bottom of the video
Crop one pixel from the bottom of the video
--key-uncrop-bottom=<integer>
Uncrop one pixel from the bottom of the video
Uncrop one pixel from the bottom of the video
--global-key-uncrop-bottom=<integer>
Uncrop one pixel from the bottom of the video
Uncrop one pixel from the bottom of the video
--key-crop-right=<integer> Crop one pixel from the right of the video
Crop one pixel from the right of the video
--global-key-crop-right=<integer>
Crop one pixel from the right of the video
Crop one pixel from the right of the video
--key-uncrop-right=<integer>
Uncrop one pixel from the right of the video
Uncrop one pixel from the right of the video
--global-key-uncrop-right=<integer>
Uncrop one pixel from the right of the video
Uncrop one pixel from the right of the video
--key-random=<integer> Random
Toggle random playlist playback
--global-key-random=<integer>
Random
Toggle random playlist playback
--key-loop=<integer> Normal/Repeat/Loop
Toggle Normal/Repeat/Loop playlist modes
--global-key-loop=<integer>
Normal/Repeat/Loop
Toggle Normal/Repeat/Loop playlist modes
Zoom:
--key-zoom-quarter=<integer>
1:4 Quarter
--global-key-zoom-quarter=<integer>
1:4 Quarter
--key-zoom-half=<integer> 1:2 Half
--global-key-zoom-half=<integer>
1:2 Half
--key-zoom-original=<integer>
1:1 Original
--global-key-zoom-original=<integer>
1:1 Original
--key-zoom-double=<integer>
2:1 Double
--global-key-zoom-double=<integer>
2:1 Double
Jump sizes:
--extrashort-jump-size=<integer>
Very short jump length
Very short jump length, in seconds.
--short-jump-size=<integer>
Short jump length
Short jump length, in seconds.
--medium-jump-size=<integer>
Medium jump length
Medium jump length, in seconds.
--long-jump-size=<integer> Long jump length
Long jump length, in seconds.
--key-set-bookmark1=<integer>
Set playlist bookmark 1
Select the key to set this playlist bookmark.
--global-key-set-bookmark1=<integer>
Set playlist bookmark 1
Select the key to set this playlist bookmark.
--key-set-bookmark2=<integer>
Set playlist bookmark 2
Select the key to set this playlist bookmark.
--global-key-set-bookmark2=<integer>
Set playlist bookmark 2
Select the key to set this playlist bookmark.
--key-set-bookmark3=<integer>
Set playlist bookmark 3
Select the key to set this playlist bookmark.
--global-key-set-bookmark3=<integer>
Set playlist bookmark 3
Select the key to set this playlist bookmark.
--key-set-bookmark4=<integer>
Set playlist bookmark 4
Select the key to set this playlist bookmark.
--global-key-set-bookmark4=<integer>
Set playlist bookmark 4
Select the key to set this playlist bookmark.
--key-set-bookmark5=<integer>
Set playlist bookmark 5
Select the key to set this playlist bookmark.
--global-key-set-bookmark5=<integer>
Set playlist bookmark 5
Select the key to set this playlist bookmark.
--key-set-bookmark6=<integer>
Set playlist bookmark 6
Select the key to set this playlist bookmark.
--global-key-set-bookmark6=<integer>
Set playlist bookmark 6
Select the key to set this playlist bookmark.
--key-set-bookmark7=<integer>
Set playlist bookmark 7
Select the key to set this playlist bookmark.
--global-key-set-bookmark7=<integer>
Set playlist bookmark 7
Select the key to set this playlist bookmark.
--key-set-bookmark8=<integer>
Set playlist bookmark 8
Select the key to set this playlist bookmark.
--global-key-set-bookmark8=<integer>
Set playlist bookmark 8
Select the key to set this playlist bookmark.
--key-set-bookmark9=<integer>
Set playlist bookmark 9
Select the key to set this playlist bookmark.
--global-key-set-bookmark9=<integer>
Set playlist bookmark 9
Select the key to set this playlist bookmark.
--key-set-bookmark10=<integer>
Set playlist bookmark 10
Select the key to set this playlist bookmark.
--global-key-set-bookmark10=<integer>
Set playlist bookmark 10
Select the key to set this playlist bookmark.
--key-play-bookmark1=<integer>
Play playlist bookmark 1
Select the key to play this bookmark.
--global-key-play-bookmark1=<integer>
Play playlist bookmark 1
Select the key to play this bookmark.
--key-play-bookmark2=<integer>
Play playlist bookmark 2
Select the key to play this bookmark.
--global-key-play-bookmark2=<integer>
Play playlist bookmark 2
Select the key to play this bookmark.
--key-play-bookmark3=<integer>
Play playlist bookmark 3
Select the key to play this bookmark.
--global-key-play-bookmark3=<integer>
Play playlist bookmark 3
Select the key to play this bookmark.
--key-play-bookmark4=<integer>
Play playlist bookmark 4
Select the key to play this bookmark.
--global-key-play-bookmark4=<integer>
Play playlist bookmark 4
Select the key to play this bookmark.
--key-play-bookmark5=<integer>
Play playlist bookmark 5
Select the key to play this bookmark.
--global-key-play-bookmark5=<integer>
Play playlist bookmark 5
Select the key to play this bookmark.
--key-play-bookmark6=<integer>
Play playlist bookmark 6
Select the key to play this bookmark.
--global-key-play-bookmark6=<integer>
Play playlist bookmark 6
Select the key to play this bookmark.
--key-play-bookmark7=<integer>
Play playlist bookmark 7
Select the key to play this bookmark.
--global-key-play-bookmark7=<integer>
Play playlist bookmark 7
Select the key to play this bookmark.
--key-play-bookmark8=<integer>
Play playlist bookmark 8
Select the key to play this bookmark.
--global-key-play-bookmark8=<integer>
Play playlist bookmark 8
Select the key to play this bookmark.
--key-play-bookmark9=<integer>
Play playlist bookmark 9
Select the key to play this bookmark.
--global-key-play-bookmark9=<integer>
Play playlist bookmark 9
Select the key to play this bookmark.
--key-play-bookmark10=<integer>
Play playlist bookmark 10
Select the key to play this bookmark.
--global-key-play-bookmark10=<integer>
Play playlist bookmark 10
Select the key to play this bookmark.
--bookmark1=<string> Playlist bookmark 1
This allows you to define playlist bookmarks.
--bookmark2=<string> Playlist bookmark 2
This allows you to define playlist bookmarks.
--bookmark3=<string> Playlist bookmark 3
This allows you to define playlist bookmarks.
--bookmark4=<string> Playlist bookmark 4
This allows you to define playlist bookmarks.
--bookmark5=<string> Playlist bookmark 5
This allows you to define playlist bookmarks.
--bookmark6=<string> Playlist bookmark 6
This allows you to define playlist bookmarks.
--bookmark7=<string> Playlist bookmark 7
This allows you to define playlist bookmarks.
--bookmark8=<string> Playlist bookmark 8
This allows you to define playlist bookmarks.
--bookmark9=<string> Playlist bookmark 9
This allows you to define playlist bookmarks.
--bookmark10=<string> Playlist bookmark 10
This allows you to define playlist bookmarks.
-h, --help, --no-help print help for VLC (can be combined with
--advanced and --help-verbose) (default
disabled)
-H, --full-help, --no-full-help
Exhaustive help for VLC and its modules
(default disabled)
--longhelp, --no-longhelp print help for VLC and all its modules (can
be combined with --advanced and
--help-verbose) (default disabled)
--help-verbose, --no-help-verbose
ask for extra verbosity when displaying help
(default disabled)
-l, --list, --no-list print a list of available modules (default
disabled)
--list-verbose, --no-list-verbose
print a list of available modules with extra
detail (default disabled)
-p, --module=<string> print help on a specific module (can be
combined with --advanced and --help-verbose).
Prefix the module name with = for strict
matches.
--ignore-config, --no-ignore-config
no configuration option will be loaded nor
saved to config file (default enabled)
--reset-config, --no-reset-config
reset the current config to the default
values (default disabled)
--reset-plugins-cache, --no-reset-plugins-cache
resets the current plugins cache (default
disabled)
--version, --no-version print version information (default disabled)
--config=<string> use alternate config file
</nowiki>

==See also==
*[[Mac OS X]] for special notes on using the command line on Mac OS X

[[Category:Documentation]]

OldFAQ

2010-08-21T15:04:14Z

Popol0909: /* Other Problems */ Finer volume control

User:Popol0909

2010-08-21T15:02:06Z

Popol0909: Created page with 'Administrators list/Liste des administrateurs (WikiSysop, Administrators, Bureaucrats, ...): Developers_Corner'

Administrators list/Liste des administrateurs (WikiSysop, Administrators, Bureaucrats, ...): 
[[Developers_Corner]]

User:Jheena789

2010-08-21T14:56:42Z

Popol0909: Created page with 'This user is a spammer. Please see: http://wiki.videolan.org/index.php?title=Common_Problems&diff=16884&oldid=16872'

This user is a spammer. Please see: 
http://wiki.videolan.org/index.php?title=Common_Problems&diff=16884&oldid=16872

OldFAQ

2010-08-21T14:45:43Z

Popol0909: Undo revision 16884 by Jheena789 (Talk) Revert to version before spam