VideoLAN Wiki - User contributions [en]

MP4

2006-07-09T05:15:19Z

Gniw: link mpeg

==MP4 = MPEG-4==

MP4 (*'''.mp4''') is the global file extension for the official container format defined in the [[MPEG]]-4 standard [[ISO 14496-14]].

==MP4 Filename Extensions==

* '''.mp4''': the only official extension; used for both audio and video files (and advanced content)
* '''.m4a''': introduced by Apple for aac/alac ''audio-only'' files.

NOTE: .m4a files can safely be renamed to .mp4 -- but the distinction between audio (m4a) and video (mp4) may be useful if you are going to share files, or if you tend to forget what files you have.

For complete details on MP4, see the following link:

*http://forum.doom9.org/showthread.php?s=&threadid=62723

What can VLC do?

2006-07-08T06:48:41Z

Gniw: /* VLM */ sp

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.

'''Note:''' 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.

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

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

=== Announce whats 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 aproach 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 cant 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>

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 poretty 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 thisa 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 doesnt 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 Inf3rn0 ==
Script and help for Inf3rn0's Now Playing script here: [http://www.home.no/inf3rn0/NowPlaying/]

Based on E-Bola's Now Playing script.

== 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 top 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 stream availeble, 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 u want to add, the longer delay u 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.

== Streaming - server ==

=== VLM ===

The VLM is the Video On Demand part of the VLC streaming server features. It lets u 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 devide VLM entries into 2 general categories VOD and broadcast entries.

== Capture / Record things==

Transcode

2006-07-03T04:10:25Z

Gniw: /* Completely non-interactive transcoding */

Transcoding is the process of taking a video file and changing it to a different format or bitrate.

Transcoding in VLC copies the movie to a new file in a different format, so you end up with both the original and new files. This means you need to have enough space on your hard drive to store this extra file. You should also have a reasonably fast computer, as transcoding can be very slow.

In VLC, transcoding is exactly the same as [[streaming]] accross a network, except that the output is sent to a file instead of a network.

== Transcoding with the Wizard ==

VLC includes a transcoding and streaming wizard. To transcode a file, just select the transcode option. You will then be asked what format to convert to: you can give a video [[codec]], and audio codec and an [[encapsulation]] format. Only some encapsulation formats can support some codecs - look [http://www.videolan.org/streaming/features.html here] to see what supportes what.

{{doc|http://www.videolan.org/doc/streaming-howto/en/ch02.html}}

== Transcoding with the Command Prompt ==

The most flexible way to transcode with vlc is using a [[command prompt]] to start vlc. Transcoding works the same as [[streaming]]. For example, the following command changes an [[asf]] file to an [[MPEG-2]] file:
:vlc "C:\Movies\Your File.asf" :sout='#transcode{vcodec=mp2v,vb=4096,acodec=mp2a,ab=192,scale=1,channels=2,deinterlace,audio-sync}:std{access=file, mux=ps,url="C:\Movies\Your File Output.ps.mpg"}'
The access=file instructs vlc to store the output in a file (and not stream it), and the url is the location of the new (output) file.

(Note: If you are running VLC on [[Mac OS X]], you should use clivlc instead of VLC to avoid possible Bus error problems.)

Transcoding takes quite a while, so it's advisable to use an option like '''--stop-time=30''' to only encode the first 30 seconds - this means you can check the file has transcoded correctly, and that the output is of a suitable quality.

The transcode statement can contain '''vcodec''' and '''vb''' to change the video codec and '''acodec''' and '''ab''' to change the audio codec. If vcodec is missing, the video codec will stay the same (same for acodec).

Common additional options to use are '''audio-sync''' (to make sure the audio is in sync correctly) and '''deinterlace''' (to increase quality slightly on interlaced video).

===Completely non-interactive transcoding===
For completely non-interactive transcoding (such as the case necessary when running under [[Mac OS X]]), the above example could be rewritten as
:vlc -I dummy "C:\Movies\Your File.asf" :sout='#transcode{vcodec=mp2v,vb=4096,acodec=mp2a,ab=192,scale=1,channels=2,deinterlace,audio-sync}:std{access=file, mux=ps,url="C:\Movies\Your File Output.ps.mpg"}' vlc:quit
The two extra options are
;-I dummy: Disables the graphical interface
;<nowiki>vlc:quit</nowiki>: Quit VLC after transcoding
If transcoding from a DVD, it is also necessary to use the dvdsimple:// notation instead of the dvd:// notation, in order to avoid interacting with the DVD menu system (which is quite impossible without the graphical interface).

{{doc|http://www.videolan.org/doc/streaming-howto/en/ch03.html}}

SVCD

2006-07-02T04:51:54Z

Gniw: /* Compatability */ sp

{{wikipedia|SVCD}}
'''SVCD''', or '''Super Video CD''' is a way of storing a video on a [[CD]] in a similar way to storing it on a [[DVD]]. It is (of course) generally lower quality than a DVD due to the smaller size of a CD rather than a DVD.

==Compatibility==
SVCDs often do not work in VLC Player. VLC can sometimes play SVCDs using [[libcdio]] and [[libvcdinfo]] - the [http://www.videolan.org/vlc/features.html features] page has more details. For a complete VCD/SVCD which includes menu selections, hot spots and playback control, see [http://www.xinehq.de xine].

Transcode

2006-07-02T02:34:24Z

Gniw: /* Completely non-interactive transcoding */

Transcoding is the process of taking a video file and changing it to a different format or bitrate.

Transcoding in VLC copies the movie to a new file in a different format, so you end up with both the original and new files. This means you need to have enough space on your hard drive to store this extra file. You should also have a reasonably fast computer, as transcoding can be very slow.

In VLC, transcoding is exactly the same as [[streaming]] accross a network, except that the output is sent to a file instead of a network.

== Transcoding with the Wizard ==

VLC includes a transcoding and streaming wizard. To transcode a file, just select the transcode option. You will then be asked what format to convert to: you can give a video [[codec]], and audio codec and an [[encapsulation]] format. Only some encapsulation formats can support some codecs - look [http://www.videolan.org/streaming/features.html here] to see what supportes what.

{{doc|http://www.videolan.org/doc/streaming-howto/en/ch02.html}}

== Transcoding with the Command Prompt ==

The most flexible way to transcode with vlc is using a [[command prompt]] to start vlc. Transcoding works the same as [[streaming]]. For example, the following command changes an [[asf]] file to an [[MPEG-2]] file:
:vlc "C:\Movies\Your File.asf" :sout='#transcode{vcodec=mp2v,vb=4096,acodec=mp2a,ab=192,scale=1,channels=2,deinterlace,audio-sync}:std{access=file, mux=ps,url="C:\Movies\Your File Output.ps.mpg"}'
The access=file instructs vlc to store the output in a file (and not stream it), and the url is the location of the new (output) file.

(Note: If you are running VLC on [[Mac OS X]], you should use clivlc instead of VLC to avoid possible Bus error problems.)

Transcoding takes quite a while, so it's advisable to use an option like '''--stop-time=30''' to only encode the first 30 seconds - this means you can check the file has transcoded correctly, and that the output is of a suitable quality.

The transcode statement can contain '''vcodec''' and '''vb''' to change the video codec and '''acodec''' and '''ab''' to change the audio codec. If vcodec is missing, the video codec will stay the same (same for acodec).

Common additional options to use are '''audio-sync''' (to make sure the audio is in sync correctly) and '''deinterlace''' (to increase quality slightly on interlaced video).

===Completely non-interactive transcoding===
For completely non-interactive transcoding (such as the case necessary when running under [[Mac OS X]]), the above example could be rewritten as
:vlc -I dummy "C:\Movies\Your File.asf" :sout='#transcode{vcodec=mp2v,vb=4096,acodec=mp2a,ab=192,scale=1,channels=2,deinterlace,audio-sync}:std{access=file, mux=ps,url="C:\Movies\Your File Output.ps.mpg"}' vlc:quit
The two extra options are
;-I dummy: Disables the graphical interface
;<nowiki>vlc:quit</nowiki>: Quit VLC after transcoding

{{doc|http://www.videolan.org/doc/streaming-howto/en/ch03.html}}

Transcode

2006-07-02T02:20:16Z

Gniw: sp

Transcoding is the process of taking a video file and changing it to a different format or bitrate.

Transcoding in VLC copies the movie to a new file in a different format, so you end up with both the original and new files. This means you need to have enough space on your hard drive to store this extra file. You should also have a reasonably fast computer, as transcoding can be very slow.

In VLC, transcoding is exactly the same as [[streaming]] accross a network, except that the output is sent to a file instead of a network.

== Transcoding with the Wizard ==

VLC includes a transcoding and streaming wizard. To transcode a file, just select the transcode option. You will then be asked what format to convert to: you can give a video [[codec]], and audio codec and an [[encapsulation]] format. Only some encapsulation formats can support some codecs - look [http://www.videolan.org/streaming/features.html here] to see what supportes what.

{{doc|http://www.videolan.org/doc/streaming-howto/en/ch02.html}}

== Transcoding with the Command Prompt ==

The most flexible way to transcode with vlc is using a [[command prompt]] to start vlc. Transcoding works the same as [[streaming]]. For example, the following command changes an [[asf]] file to an [[MPEG-2]] file:
:vlc "C:\Movies\Your File.asf" :sout='#transcode{vcodec=mp2v,vb=4096,acodec=mp2a,ab=192,scale=1,channels=2,deinterlace,audio-sync}:std{access=file, mux=ps,url="C:\Movies\Your File Output.ps.mpg"}'
The access=file instructs vlc to store the output in a file (and not stream it), and the url is the location of the new (output) file.

(Note: If you are running VLC on [[Mac OS X]], you should use clivlc instead of VLC to avoid possible Bus error problems.)

Transcoding takes quite a while, so it's advisable to use an option like '''--stop-time=30''' to only encode the first 30 seconds - this means you can check the file has transcoded correctly, and that the output is of a suitable quality.

The transcode statement can contain '''vcodec''' and '''vb''' to change the video codec and '''acodec''' and '''ab''' to change the audio codec. If vcodec is missing, the video codec will stay the same (same for acodec).

Common additional options to use are '''audio-sync''' (to make sure the audio is in sync correctly) and '''deinterlace''' (to increase quality slightly on interlaced video).

===Completely non-interactive transcoding===
For completely non-interactive transcoding (such as the case necessary when running under [[Mac OS X]]), the above example could be rewritten as
:vlc -I dummy "C:\Movies\Your File.asf" :sout='#transcode{vcodec=mp2v,vb=4096,acodec=mp2a,ab=192,scale=1,channels=2,deinterlace,audio-sync}:std{access=file, mux=ps,url="C:\Movies\Your File Output.ps.mpg"}' vlc:quit
The two extra options are
;-I dummy: Disables the graphical interface
;vlc:quit: Quit VLC after transcoding

{{doc|http://www.videolan.org/doc/streaming-howto/en/ch03.html}}

MacOS

2006-07-02T02:17:44Z

Gniw: /* Command line */

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

Some handy key combo's are:

* You can use the spacebar to start/pause the video.
* When in fullscreen you can use the escape key to exit the fullscreen state
* When you are watching a DVD and the video window is the front-most window you can use the arrow keys and the enter key to navigate the DVD menus.

==Streaming Wizard==
A streaming wizard is available since the VLC media player 0.8.4 release.

==Command line==
You can run VLC on Mac OS X using a terminal application (for example Terminal.app in /Applications/Utilities) with the following command: ./VLC.app/Contents/MacOS/VLC [your options, "--intf=rc" for example]. Note that you can replace the "VLC" at the end of the path with "clivlc" to suppress the launch of any Mac-like interface. VLC won't even appear in the Dock then.

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

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

User:Gniw

2006-07-02T02:09:37Z

Gniw:

:''I like my Soke; but with VLC, my iBook's DVD drive suddenly actually became useful.''
I am a VLC user who lives in a place with DVD region code 1, but where many people must be able to play region code 2 or 3 (and other) discs. (And my collection of both region 2 and 3 discs is growing…)

Transcode

2006-07-02T01:54:06Z

Gniw: /* Transcoding with the Command Prompt */ non-interactive example

Transcoding is the process of taking a video file and changing it to a different format or bitrate.

Transcoding in VLC copies the movie to a new file in a different format, so you end up with both the original and new files. This means you need to have enough space on your hard drive to store this extra file. You should also have a reasonably fast computer, as transcoding can be very slow.

In VLC, transcoding is exactly the same as [[streaming]] accross a network, except that the output is sent to a file insted of a network.

== Transcoding with the Wizard ==

VLC includes a transcoding and streaming wizard. To transcode a file, just select the transcode option. You will then be asked what format to convert to: you can give a video [[codec]], and audio codec and an [[encapsulation]] format. Only some encapsulation formats can support some codecs - look [http://www.videolan.org/streaming/features.html here] to see what supportes what.

{{doc|http://www.videolan.org/doc/streaming-howto/en/ch02.html}}

== Transcoding with the Command Prompt ==

The most flexible way to transcode with vlc is using a [[command prompt]] to start vlc. Transcoding works the same as [[streaming]]. For example, the following command changes an [[asf]] file to an [[MPEG-2]] file:
:vlc "C:\Movies\Your File.asf" :sout='#transcode{vcodec=mp2v,vb=4096,acodec=mp2a,ab=192,scale=1,channels=2,deinterlace,audio-sync}:std{access=file, mux=ps,url="C:\Movies\Your File Output.ps.mpg"}'
The access=file instructs vlc to store the output in a file (and not stream it), and the url is the location of the new (output) file.

(Note: If you are running VLC on [[Mac OS X]], you should use clivlc instead of VLC to avoid possible Bus error problems.)

Transcoding takes quite a while, so it's advisable to use an option like '''--stop-time=30''' to only encode the first 30 seconds - this means you can check the file has transcoded correctly, and that the output is of a suitable quality.

The transcode statement can contain '''vcodec''' and '''vb''' to change the video codec and '''acodec''' and '''ab''' to change the audio codec. If vcodec is missing, the video codec will stay the same (same for acodec).

Common additional options to use are '''audio-sync''' (to make sure the audio is in sync correctly) and '''deinterlace''' (to increase quality slightly on interlaced video).

===Completely non-interactive transcoding===
For completely non-interactive transcoding (such as the case necessary when running under [[Mac OS X]]), the above example could be rewritten as
:vlc -I dummy "C:\Movies\Your File.asf" :sout='#transcode{vcodec=mp2v,vb=4096,acodec=mp2a,ab=192,scale=1,channels=2,deinterlace,audio-sync}:std{access=file, mux=ps,url="C:\Movies\Your File Output.ps.mpg"}' vlc:quit
The two extra options are
;-I dummy: Disables the graphical interface
;vlc:quit: Quit VLC after transcoding

{{doc|http://www.videolan.org/doc/streaming-howto/en/ch03.html}}

Transcode

2006-07-02T01:48:40Z

Gniw: /* Transcoding with the Command Prompt */ Note for OS X

Transcoding is the process of taking a video file and changing it to a different format or bitrate.

Transcoding in VLC copies the movie to a new file in a different format, so you end up with both the original and new files. This means you need to have enough space on your hard drive to store this extra file. You should also have a reasonably fast computer, as transcoding can be very slow.

In VLC, transcoding is exactly the same as [[streaming]] accross a network, except that the output is sent to a file insted of a network.

== Transcoding with the Wizard ==

VLC includes a transcoding and streaming wizard. To transcode a file, just select the transcode option. You will then be asked what format to convert to: you can give a video [[codec]], and audio codec and an [[encapsulation]] format. Only some encapsulation formats can support some codecs - look [http://www.videolan.org/streaming/features.html here] to see what supportes what.

{{doc|http://www.videolan.org/doc/streaming-howto/en/ch02.html}}

== Transcoding with the Command Prompt ==

The most flexible way to transcode with vlc is using a [[command prompt]] to start vlc. Transcoding works the same as [[streaming]]. For example, the following command changes an [[asf]] file to an [[MPEG-2]] file:
:vlc "C:\Movies\Your File.asf" :sout='#transcode{vcodec=mp2v,vb=4096,acodec=mp2a,ab=192,scale=1,channels=2,deinterlace,audio-sync}:std{access=file, mux=ps,url="C:\Movies\Your File Output.ps.mpg"}'
The access=file instructs vlc to store the output in a file (and not stream it), and the url is the location of the new (output) file.

(Note: If you are running VLC on [[Mac OS X]], you should use clivlc instead of VLC to avoid possible Bus error problems.)

Transcoding takes quite a while, so it's advisable to use an option like '''--stop-time=30''' to only encode the first 30 seconds - this means you can check the file has transcoded correctly, and that the output is of a suitable quality.

The transcode statement can contain '''vcodec''' and '''vb''' to change the video codec and '''acodec''' and '''ab''' to change the audio codec. If vcodec is missing, the video codec will stay the same (same for acodec).

Common additional options to use are '''audio-sync''' (to make sure the audio is in sync correctly) and '''deinterlace''' (to increase quality slightly on interlaced video).

{{doc|http://www.videolan.org/doc/streaming-howto/en/ch03.html}}

VLC command-line help

2006-07-02T01:46:14Z

Gniw: /* See also */ new section - link to Mac OS X article so that people looking for command line help on OS X can find it

As you may have noticed, the command ''vlc --help'' is not very useful due to to the non-scrollable pop-up window that opened.

If you look for help, on a particular module, use ''vlc -p module --advanced''

So here's the output of ''vlc --longhelp --advanced --help-verbose'' for the 0.8.5-test1 (2006/03/27) version in Windows.

<nowiki>
Usage: vlc.exe [options] [playlistitems] ...
You can specify multiple playlistitems 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 playlistitem directly before it
and that overrides previous settings.

Playlistitem 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

Help options
-h, --help Afficher l’aide de VLC (peut être combiné
avec --advanced)
-H, --longhelp Afficher l’aide de VLC et de ses modules
(peut être combiné avec --advanced)
--advanced Afficher l’aide pour les options avancées
--help-verbose Afficher plus de détails dans l’aide
-l, --list Affiche la liste des modules disponibles
-p, --module <string> Afficher l’aide d'un module spécifique
(peut être combiné avec --advanced)
--save-config Enregistre les options de la ligne de
commande actuelle dans la configuration
--reset-config Remet à zéro la configuration
--config <string> Utilise un autre fichier de configuration
--reset-plugins-cache Remet à zéro le cache des modules
--version Affiche le numéro de version

Audio
--audio, --no-audio Enable audio (default enabled)
You can completely disable the audio output.
In this case, the audio decoding stage will
not take place, thus saving some processing
power. (default enabled)
--volume <integer> Default audio volume
You can set the default audio output volume
here, in a range from 0 to 1024.
--spdif, --no-spdif Use the S/PDIF audio output when available
(default disabled)
This option allows you to use the S/PDIF
audio output 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. And 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-filter <string> Audio filters
This allows you to add audio post processing
filters, to modify the sound
--audio-visual <string> Audio visualizations
This allows you to add visualization modules
(spectrum analyzer, etc.).

Video
-f, --fullscreen, --no-fullscreen
Fullscreen video output (default disabled)
If this option is enabled, VLC will always
start a video in fullscreen mode. (default
disabled)
--overlay, --no-overlay Overlay video output (default enabled)
If enabled, VLC will try to take advantage of
the overlay capabilities of your graphics
card (hardware acceleration). (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)
--snapshot-path <string> Video snapshot directory
Allows you to specify the directory where the
video snapshots will be stored.
--snapshot-format {png,jpg}
Video snapshot format
Allows you to specify the image format in
which the video snapshots will be stored.
--snapshot-preview, --no-snapshot-preview
Display video snapshot preview (default
enabled)
Enable / disable displaying the snapshot
preview in the screen's to left corner.
(default enabled)
--crop <string> Video cropping
This will force the cropping of the source
video. Accepted formats are x:y (4:3, 16:9,
etc.) expressing the global image aspect.
--aspect-ratio <string> Source aspect ratio
This will force 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.
--vout-filter <string> Video filter module
This will allow you to add a post-processing
filter to enhance the picture quality, for
instance deinterlacing, or to clone or
distort the video window.

Subpictures
--osd, --no-osd On Screen Display (default enabled)
VLC can display messages on the video. This
is called OSD (On Screen Display). You can
disable this feature here. (default enabled)
--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. (default
enabled)
--sub-filter <string> Subpictures filter module
This will allow you to add a subpictures
filter for instance to overlay a logo.
--audio-language <string> Audio language
Give the language of the audio track you want
to use (comma separted, two or three letter
country code).
--sub-language <string> Subtitle language
Give the language of the subtitle track you
want to use (comma separted, two or tree
letter country code).
--input-repeat <integer> Input repetitions
Number of time the same input will be repeated
--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.
--server-port <integer> UDP port
This is the port used for UDP streams. 1234
by default.
-6, --ipv6, --no-ipv6 Force IPv6 (default disabled)
If you check this box, IPv6 will be used by
default for all UDP and HTTP connections.
(default disabled)
-4, --ipv4, --no-ipv4 Force IPv4 (default disabled)
If you check this box, IPv4 will be used by
default for all UDP and HTTP connections.
(default disabled)

Input
--access-filter <string> Access filter module
This is a legacy entry to let you configure
access filter modules.
--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
-Z, --random, --no-random Play files randomly forever (default disabled)
When selected, VLC will randomly play files
in the playlist until interrupted. (default
disabled)
-L, --loop, --no-loop Repeat all (default disabled)
If you want VLC to keep playing the playlist
indefinitely then enable this option.
(default disabled)
-R, --repeat, --no-repeat Repeat current item (default disabled)
When this is active, VLC will keep playing
the current playlist item over and over
again. (default disabled)
--play-and-stop, --no-play-and-stop
Play and stop (default disabled)
Stop the playlist after each played playlist
item. (default disabled)
--open <string> Default stream
This option allows you to always open a
default stream on start-up.
--auto-preparse, --no-auto-preparse
Automatically preparse files (default enabled)
This option enables automatic preparsing of
files added to the playlist (to retrieve some
metadata). (default enabled)
-S, --services-discovery <string>
Services discovery modules
Specifies the services discovery modules to
load, separated by semi-colons. Typical
values are sap, hal, ...
--extraintf <string> Extra interface modules
This option allows you to select additional
interfaces used by VLC. They will be launched
in the background in addition to the default
interface. Use a comma separated list of
interface modules. (common values are logger,
gestures, sap, rc, http or screensaver)
-v, --verbose <integer> Verbosity (0,1,2)
This option sets the verbosity level (0=only
errors and standard messages, 1=warnings,
2=debug).
--language {auto,en,en_GB,ca,da,de,es,fr,it,ja,ka,ko,nl,oc,pt_BR,ro,ru,tr,zh_CN,zh_TW}
Language
This option allows you to set the language of
the interface. The system language is
auto-detected if "auto" is specified here.
--advanced, --no-advanced Show advanced options (default enabled)
When this option is turned on, the
preferences and/or interfaces will show all
the available options, including those that
most users should never touch. (default
enabled)
--show-intf, --no-show-intf
Show interface with mouse (default disabled)
If this enabled, the interface will be shown
when you move the mouse to the edge of the
screen in fullscreen mode. (default disabled)
-I, --intf <string> Interface module
This option allows you to select the
interface used by VLC. The default behavior
is to automatically select the best module
available.
--control <string> Control interfaces
This option allows you to select control
interfaces.
-start-time=<integer>
This option allows you to select the
start-time of your file. The parameter
has to be in seconds.

Hot keys
--key-fullscreen <integer> Fullscreen
Select the hotkey to use to swap fullscreen
state.
--key-play-pause <integer> Play/Pause
Select the hotkey to use to swap paused state.
--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.
--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.
--key-stop <integer> Stop
Select the hotkey to stop the playback.
--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.
--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.
--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.
--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.
--key-quit <integer> Quit
Select the hotkey to quit the application.
--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.
--key-vol-mute <integer> Mute
Select the key to turn off audio volume.
--key-audio-track <integer>
Cycle audio track
Cycle through the available audio
tracks(languages)
--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
--key-crop <integer> Cycle video crop
Cycle through a predefined list of crop
formats
--key-deinterlace <integer>
Cycle deinterlace modes
Cycle through all the deinterlace modes
--extrashort-jump-size <integer>
Very short jump size
Very short jump "size", in seconds
--short-jump-size <integer>
Short jump size
Short jump "size", in seconds
--medium-jump-size <integer>
Medium jump size
Medium jump "size", in seconds
--long-jump-size <integer> Long jump size
Long jump "size", in seconds
--bookmark1 <string> Playlist bookmark 1
This option allows you to define playlist
bookmarks.
--bookmark2 <string> Playlist bookmark 2
This option allows you to define playlist
bookmarks.
--bookmark3 <string> Playlist bookmark 3
This option allows you to define playlist
bookmarks.
--bookmark4 <string> Playlist bookmark 4
This option allows you to define playlist
bookmarks.
--bookmark5 <string> Playlist bookmark 5
This option allows you to define playlist
bookmarks.
--bookmark6 <string> Playlist bookmark 6
This option allows you to define playlist
bookmarks.
--bookmark7 <string> Playlist bookmark 7
This option allows you to define playlist
bookmarks.
--bookmark8 <string> Playlist bookmark 8
This option allows you to define playlist
bookmarks.
--bookmark9 <string> Playlist bookmark 9
This option allows you to define playlist
bookmarks.
--bookmark10 <string> Playlist bookmark 10
This option allows you to define playlist
bookmarks.

ffmpeg audio/video decoder/encoder ((MS)MPEG4,SVQ1,H263,WMV,WMA)
--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
--ffmpeg-hurry-up, --no-ffmpeg-hurry-up
Hurry up (default disabled)
Allow the decoder to 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 disabled)
--ffmpeg-pp-q <integer> 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.
--sout-ffmpeg-hq {rd,bits,simple}
Quality level
Allows you to specify the quality level for
the encoding of motions vectors (this can
slow down the encoding very much).
--sout-ffmpeg-keyint <integer>
Ratio of key frames
Allows you to specify the number of frames
that will be coded for one key frame.
--sout-ffmpeg-bframes <integer>
Ratio of B frames
Allows you to specify the 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)
Allows you to specify if the encoder should
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)

MPEG2 video switcher stream output
--sout-switcher-files <string>
Files
Full paths of the files separated by colons.
--sout-switcher-sizes <string>
Sizes
List of sizes separated by colons
(720x576:480x576).
--sout-switcher-aspect-ratio <string>
Aspect ratio
Aspect ratio (4:3, 16:9).

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)

Standard filesystem directory input
--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>
Ignore files with these extensions
Specify a comma seperated list of file
extensions. Files with these extensions will
not be added to playlist when opening a
directory. This is useful if you add
directories that contain mp3 albums for
instance.

Timeshift
--timeshift-dir <string> Timeshift directory
Directory used to store the timeshift
temporary files.

FTP input
--ftp-user <string> FTP user name
Allows you to modify the user name that will
be used for the connection.
--ftp-pwd <string> FTP password
Allows you to modify the password that will
be used for the connection.
--ftp-account <string> FTP account
Allows you to modify the account that will be
used for the connection.

HTTP input
--http-proxy <string> HTTP proxy
You can specify an HTTP proxy to use. It must
be of the form http://[user[:pass]@]myproxy.my
domain:myport/ ; if empty, the http_proxy
environment variable will be tried.

Microsoft Media Server (MMS) input
--mms-maxbitrate <integer> Maximum bitrate
If this is set, the stream with the maximum
bitrate under that limit will be selected

libshout (icecast) output
--sout-shout-name <string> Stream-name
The name this stream/channel will get on the
icecast server.
--sout-shout-description <string>
Stream-description
A description of the stream content.
(Information about your channel).

UDP stream output

SMB input
--smb-user <string> SMB user name
Allows you to modify the user name that will
be used for the connection.
--smb-pwd <string> SMB password
Allows you to modify the password that will
be used for the connection.
--smb-domain <string> SMB domain
Allows you to modify the domain/workgroup
that will be used for the connection.

Image properties filter
--contrast <float> Image contrast (0-2)
Set the image contrast, between 0 and 2.
Defaults to 1
--brightness <float> Image brightness (0-2)
Set the image brightness, between 0 and 2.
Defaults to 1
--hue <integer> Image hue (0-360)
Set the image hue, between 0 and 360.
Defaults to 0
--saturation <float> Image saturation (0-3)
Set the image saturation, between 0 and 3.
Defaults to 1
--gamma <float> Image gamma (0-10)
Set the image gamma, between 0.01 and 10.
Defaults to 1
--brightness-threshold, --no-brightness-threshold
Enable brightness threshold (default disabled)
Show black and white pixels with brightness
as threshold value (default disabled)

File audio output
--audiofile-file <string> Output file
File to which the audio samples will be
written to

AVI demuxer
--avi-index, --no-avi-index
Force index creation (default disabled)
Recreate a index for the AVI file. Use this
if your AVI file is damaged or incomplete
(not seekable). (default disabled)

Clone video filter
--clone-count <integer> Number of clones
Select the number of video windows in which
to clone the video.

Crop video filter
--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)
Activate automatic black border cropping.
(default disabled)

Deinterlacing video filter
--deinterlace-mode {discard,blend,mean,bob,linear,x}
Deinterlace mode
Default deinterlace method to use for local
playback
--sout-deinterlace-mode {discard,blend,mean,bob,linear,x}
Deinterlace mode
Default deinterlace methode to use for
streaming

File dumpper
--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)

Distort video filter
--distort-mode {wave,ripple,gradient,edge,hough,psychedelic}
Distort mode
Distort mode, one of "wave", "ripple",
"gradient", "edge", "hough" and "psychedelic"
--distort-gradient-type <integer>
Gradient image type
Gradient image type (0 or 1)
--distort-cartoon, --no-distort-cartoon
Apply cartoon effect (default enabled)
Apply cartoon effect. Used by "gradient" and
"edge". (default enabled)

Dummy interface function
--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)

DVB subtitles decoder
--dvbsub-x <integer> X coordinate of the subpicture
You can reposition the subpicture by
providing another value here.
--dvbsub-y <integer> Y coordinate of the subpicture
You can reposition the subpicture by
providing another value here.
--sout-dvbsub-x <integer> X coordinate of the encoded subpicture
You can reposition the subpicture by
providing another value here.
--sout-dvbsub-y <integer> Y coordinate of encoded the subpicture
You can reposition the subpicture by
providing another value here.
--sout-dvbsub-timeout <integer>
Timeout of subpictures
Subpictures get a default timeout of 15
seconds added to their remaining time.This
will ensure that they are at least the
specified time visible.

DVDnav Input
--dvdnav-angle <integer> DVD angle
Allows you to select the default DVD angle.
--dvdnav-menu, --no-dvdnav-menu
Start directly in menu (default enabled)
Allows you to start the DVD directly in the
main menu. This will try to skip all the
useless warnings introductions. (default
enabled)

DVDRead Input (DVD without menu support)
--dvdread-angle <integer> DVD angle
Allows you to select the default DVD angle.

Equalizer 10 bands
--equalizer-preset {flat,classical,club,dance,fullbass,fullbasstreble,fulltreble,headphones,largehall,live,party,pop,reggae,rock,ska,soft,softrock,techno}
Equalizer preset
Equalizer preset

Fake video decoder
--fake-file <string> Image file
Path of the image file when using the fake
input.
--fake-deinterlace, --no-fake-deinterlace
Deinterlace video (default disabled)
Allows you to deinterlace the image after
loading. (default disabled)
--fake-deinterlace-module {deinterlace,ffmpeg-deinterlace}
Deinterlace module
Specifies the deinterlace module to use.

Freetype2 font renderer
--freetype-font <string> Font
Filename for the font you want to use
--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 overriden.
--freetype-effect {1 (Background), 2 (Outline), 3 (Fat Outline)}
Font Effect
It is possible to apply effects to the
renderedtext to improve its readability.

Mouse gestures control interface
--gestures-button {left,middle,right}
Trigger button
You can set the trigger button for mouse
gestures here.

GnuTLS TLS encryption layer
--tls-check-cert, --no-tls-check-cert
Check TLS/SSL server certificate validity
(default enabled)
This ensures that the server certificate is
valid (i.e. signed by an approved
Certification Authority). (default enabled)
--tls-check-hostname, --no-tls-check-hostname
Check TLS/SSL server hostname in certificate
(default enabled)
This ensures that the server hostname in
certificate matches the requested host name.
(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).

Growl Notification Plugin
--growl-server <string> Growl server
This is the host to which Growl notifications
will be sent. By default, notifications are
sent locally.
--growl-password <string> Growl password
Growl password on the server.

Headphone channel mixer with virtual spatialization effect
--headphone-dim <integer> Characteristic dimension
Distance between front left speaker and
listener in meters.

Image video output
--image-out-format {png,jpeg}
Image format
Set the format of the output image.
--image-out-ratio <integer>
Recording ratio
Set the ratio of images that are recorded. 3
means that one image out of three is recorded.
--image-out-prefix <string>
Filename prefix
Set the prefix of the filename. Output
filename will have the form prefixNUMBER.forma
t
--image-out-replace, --no-image-out-replace
Always write to the same file (default
disabled)
Always write to the same file (default
disabled)

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

Logo video filter
--logo-file <string> Logo filenames
Full path of the image files to use. Format
is <image>[,<delay in ms>[,<alpha>]][;<image>[
,<delay>[,<alpha>]]][;...] .
--logo-transparency <integer>
Transparency of the logo
You can set the logo transparency value here
(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
You can 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).

Marquee display sub filter
--marq-marquee <string> Marquee text
Marquee text to display
--marq-position <integer> 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 by adding them).
--marq-opacity <integer> Opacity
The opacity (inverse of transparency) of
overlay 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)}
Text Default Color
The color of overlay text. 1 byte for each
color, hexadecimal. #000000 = all colors off,
0xFF0000 = just Red, 0xFFFFFF = all color on
[White]
--marq-size <integer> Font size, pixels
Specify the font size, in pixels, with -1 =
use freetype-fontsize
--marq-timeout <integer> Marquee timeout
Defines the time the marquee must remain
displayed, in milliseconds. Default value is
0 (remain forever).

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

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-megabass, --no-mod-megabass
Mega bass (default disabled)
Enable megabass mode (default disabled)
--mod-surround, --no-mod-surround
Surround (default disabled)
Surround (default disabled)

Mosaic video sub filter
--mosaic-alpha <integer> Alpha blending
Alpha blending (0 -> 255). Default is 255
--mosaic-height <integer> Height in pixels
Height in pixels
--mosaic-width <integer> Width in pixels
Width in pixels
--mosaic-position {0 (auto), 1 (fixed)}
Positioning method
Positioning method. auto: automatically
choose the best number of rows and columns.
fixed: use the user-defined number of rows
and columns.
--mosaic-rows <integer> Number of rows
Number of rows
--mosaic-cols <integer> Number of columns
Number of columns
--mosaic-keep-aspect-ratio, --no-mosaic-keep-aspect-ratio
Keep aspect ratio when resizing (default
disabled)
Keep aspect ratio when resizing (default
disabled)
--mosaic-keep-picture, --no-mosaic-keep-picture
Keep original size (default disabled)
Keep original size (default disabled)
--mosaic-order <string> Order as a comma separated list of
picture-id(s)
Order as a comma separated list of
picture-id(s)
--mosaic-delay <integer> Delay
Pictures coming from the picture video
outputs will be delayed accordingly (in
milliseconds). For high values you will need
to raise file-caching and others.
--mosaic-bs, --no-mosaic-bs
Enable bluescreen (aka greenscreen or chroma
key) video background replacing (default
disabled)
Enable bluescreen (aka greenscreen or chroma
key) video background replacing (default
disabled)
--mosaic-bsu <integer> Bluescreen chroma key U (0-255)
Bluescreen chroma key U (0-255)
--mosaic-bsv <integer> Bluescreen chroma key V (0-255)
Bluescreen chroma key V (0-255)
--mosaic-bsut <integer> Bluescreen chroma key U tolerance
Bluescreen chroma key U tolerance
--mosaic-bsvt <integer> Bluescreen chroma key V tolerance
Bluescreen chroma key V tolerance

Motion blur filter
--blur-factor <integer> Blur factor (1-127)
The degree of blurring from 1 to 127.

Motion detect video filter
--motiondetect-history <integer>
History parameter
History parameter, number of frames used for
detection
--motiondetect-description <string>
Description file
Description file, file containing simple
playlist

MusePack demuxer
--mpc-replaygain-type {0 (None), 1 (Title), 2 (Album)}
Replay Gain type
Musepack can have a title-specific replay
gain (volume control) or an album-specific
one. Choose which type you want to use

MSN Now-Playing
--msn-format <string> MSN Title format string
Format of the string to send to MSN {0}
Artist, {1} Title, {2} Album. Defaults to
"Artist - Title" ({0} - {1}).

OpenGL video output
--opengl-effect {none,cube,transparent-cube}
Select effect
Allows you to select different visual effects.

On Screen Display menu subfilter
--osdmenu-x <integer> X coordinate of the OSD menu
You can move the OSD menu by left-clicking on
it.
--osdmenu-y <integer> Y coordinate of the OSD menu
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)}
OSD 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).
--osdmenu-file <string> OSD menu configuration file
An OSD menu configuration file that menu
actions with button images
--osdmenu-file-path <string>
Path to OSD menu images
Specify another path to the OSD menu images.
This will override the path as defined in the
OSD configuration file.
--osdmenu-timeout <integer>
Timeout of OSD menu
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.

Parametric Equalizer
--param-eq-lowf <float> Low freq (Hz)
--param-eq-lowgain <float> Low freq gain (Db)
--param-eq-highf <float> High freq (Hz)
--param-eq-highgain <float>
High freq gain (Db)
--param-eq-f1 <float> Freq 1 (Hz)
--param-eq-gain1 <float> Freq 1 gain (Db)
--param-eq-q1 <float> Freq 1 Q
--param-eq-f2 <float> Freq 2 (Hz)
--param-eq-gain2 <float> Freq 2 gain (Db)
--param-eq-q2 <float> Freq 2 Q
--param-eq-f3 <float> Freq 3 (Hz)
--param-eq-gain3 <float> Freq 3 gain (Db)
--param-eq-q3 <float> Freq 3 Q

Playlist
--playlist-autostart, --no-playlist-autostart
Auto start (default enabled)
Automatically start playing the playlist
content once it's loaded.
(default enabled)

Podcasts
--podcast-urls <string> Podcast URLs list
Enter the list of podcasts to retrieve,
separated by '|' (pipe).

PORTAUDIO audio output
--portaudio-device <integer>
Output device
Portaudio identifier for the output device

Remote control interface
--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)

RSS and Atom feed display
--rss-urls <string> RSS/Atom feed URLs
RSS/Atom feed '|' (pipe) seperated URLs
--rss-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 by adding them).
--rss-opacity <integer> Opacity
The 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)}
Text Default Color
The color of overlay text. 1 byte for each
color, hexadecimal. #000000 = all colors off,
0xFF0000 = just Red, 0xFFFFFF = all color on
[White]
--rss-size <integer> Font size, pixels
Specify the font size, in pixels, with -1 =
use freetype-fontsize
--rss-speed <integer> RSS/Atom feed speed
RSS/Atom feed speed (bigger is slower)
--rss-length <integer> RSS/Atom feed max number of chars displayed
RSS/Atom feed max number of chars displayed
--rss-ttl <integer> Number of seconds between each forced refresh
of the feeds
Number of seconds between each forced refresh
of the feeds. If 0, the feeds will never be
updated.
--rss-images, --no-rss-images
Display feed images if available (default
enabled)
Display feed images if available (default
enabled)

Skinnable Interface
--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)

Bridge stream output
--sout-bridge-out-id <integer>
ID
Specify an identifier for this elementary
stream.
--sout-bridge-in-delay <integer>
Delay
Pictures coming from the picture video
outputs will be delayed accordingly (in
milliseconds, >= 100 ms). For high values,
you will need to raise file-caching and
others.
--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.

Mosaic bridge stream output
--sout-mosaic-bridge-id <string>
ID
Specify an identifier string for this
subpicture
--sout-mosaic-bridge-sar <string>
Sample aspect ratio
Sample aspect ratio of the destination (1:1,
3:4, 2:3).

RTP stream output
--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)

Standard stream output
--sout-standard-access <string>
Output access method
This is the output access method that will be
used.
--sout-standard-mux <string>
Output muxer
This is the muxer that will be used.
--sout-standard-dst <string>
Output destination
This is the destination (URL) that will be
used for the stream.

Transcode stream output
--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-vfilter <string>
Video filter
Video filters will be applied to the video
streams (after overlays are applied). You
must enter a comma-separated list of filters.
--sout-transcode-canvas-aspect <string>
Video canvas aspect ratio
This sets aspect (like 4:3) of the video
canvas and letterbox the video accordingly.
--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-channels <integer>
Audio channels
Number of audio channels in the transcoded
streams.
--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-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 coded that will be used.
--sout-transcode-soverlay, --no-sout-transcode-soverlay
Destination subtitles codec (default disabled)
This is the subtitles coded 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 must specify a comma-separated
list of subpicture modules
--sout-transcode-osd, --no-sout-transcode-osd
OSD menu (default disabled)
Stream the On Screen Display menu (using the
osdmenu subpicture module). (default disabled)

Text subtitles decoder
--subsdec-align {0 (Center), 1 (Left), 2 (Right)}
Subtitles justification
Set the justification of subtitles
--subsdec-encoding {Default,ASCII,UTF-8,,ISO-8859-1,CP1252,MacRoman,MacIceland,ISO-8859-15,,ISO-8859-2,CP1250,MacCentralEurope,MacCroatian,MacRomania,,ISO-8859-5,CP1251,MacCyrillic,MacUkraine,KOI8-R,KOI8-U,KOI8-RU,,ISO-8859-6,CP1256,MacArabic,,ISO-8859-7,CP1253,MacGreek,,ISO-8859-8,CP1255,MacHebrew,,ISO-8859-9,CP1254,MacTurkish,,ISO-8859-13,CP1257,,ISO-2022-JP,ISO-2022-JP-1,ISO-2022-JP-2,EUC-JP,SHIFT_JIS,,ISO-2022-CN,ISO-2022-CN-EXT,EUC-CN,EUC-TW,BIG5,BIG5-HKSCS,,ISO-2022-KR,EUC-KR,,MacThai,KOI8-T,,ISO-8859-3,ISO-8859-4,ISO-8859-10,ISO-8859-14,ISO-8859-16,,CP850,CP862,CP866,CP874,CP932,CP949,CP950,CP1133,CP1258,,Macintosh,,UTF-7,UTF-16,UTF-16BE,UTF-16LE,UTF-32,UTF-32BE,UTF-32LE,C99,JAVA,UCS-2,UCS-2BE,UCS-2LE,UCS-4,UCS-4BE,UCS-4LE,,HZ,GBK,GB18030,JOHAB,ARMSCII-8,Georgian-Academy,Georgian-PS,TIS-620,MuleLao-1,VISCII,TCVN,HPROMAN8,NEXTSTEP}
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)

Theora video decoder
--sout-theora-quality <integer>
Encoding quality
Allows you to specify a quality between 1
(low) and 10 (high), instead of specifying a
particular bitrate. This will produce a VBR
stream.

Time display sub filter
--time-position {0 (Center), 1 (Left), 2 (Right), 4 (Top), 8 (Bottom), 5 (Top-Left), 6 (Top-Right), 9 (Bottom-Left), 10 (Bottom-Right)}
Time position
You can enforce the time position on the
video (0=center, 1=left, 2=right, 4=top,
8=bottom, you can also use combinations of
these values by adding them).
--time-opacity <integer> Opacity
The opacity (inverse of transparency) of
overlay text. 0 = transparent, 255 = totally
opaque.
--time-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)}
Text Default Color
The color of overlay text. 1 byte for each
color, hexadecimal. #000000 = all colors off,
0xFF0000 = just Red, 0xFFFFFF = all color on
[White]
--time-size <integer> Font size, pixels
Specify the font size, in pixels, with -1 =
use freetype-fontsize

Video transformation filter
--transform-type {90,180,270,hflip,vflip}
Transform type
One of '90', '180', '270', 'hflip' and 'vflip'

MPEG Transport Stream demuxer
--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)

Libtwolame audio encoder
--sout-twolame-quality <float>
Encoding quality
Allows you to specify a 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
Select how stereo streams will be handled
--sout-twolame-vbr, --no-sout-twolame-vbr
VBR mode (default disabled)
By default the encoding is CBR. (default
disabled)
--sout-twolame-psy <integer>
Psycho-acoustic model
Integer from -1 (no model) to 4.

Visualizer filter
--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.

Vorbis audio decoder
--sout-vorbis-quality <integer>
Encoding quality
Allows you to specify 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
Allows you to specify a maximum bitrate in
kbps. Useful for streaming applications.
--sout-vorbis-min-bitrate <integer>
Minimum encoding bitrate
Allows you to specify a minimum bitrate in
kbps. Useful for encoding for a fixed-size
channel.
--sout-vorbis-cbr, --no-sout-vorbis-cbr
CBR encoding (default disabled)
Allows you to force a constant bitrate
encoding (CBR). (default disabled)

Wall video filter
--wall-cols <integer> Number of columns
Select the number of horizontal video windows
in which to split the video.
--wall-rows <integer> Number of rows
Select the number of vertical video windows
in which to split the video.
--wall-element-aspect <string>
Element aspect ratio
The aspect ratio of the individual displays
building the display wall

wxWidgets interface module
--wx-embed, --no-wx-embed Embed video in interface (default enabled)
Embed the video inside the interface instead
of having it in a separate window. (default
enabled)
--wx-bookmarks, --no-wx-bookmarks
Show bookmarks dialog (default disabled)
Show bookmarks dialog when the interface
starts. (default disabled)
--wx-taskbar, --no-wx-taskbar
Show taskbar entry (default enabled)
Show taskbar entry (default enabled)
--wx-extended, --no-wx-extended
Show extended GUI (default disabled)
Show extended GUI (default disabled)
--wx-playlist-view {0 (Normal), 1 (Embedded), 2 (Both)}
Playlist view
There are two possible playlist views in the
interface : the normal playlist (separate
window), or an embedded playlist (within the
main interface, but with less features. You
can select which one will be available on the
toolbar (or both).
--wx-systray, --no-wx-systray
Show systray icon (default disabled)
Show systray icon (default disabled)

H.264/MPEG4 AVC encoder (using x264 library)
--sout-x264-keyint <integer>
Maximum GOP size
Sets maximum interval between
IDR-frames.Larger values save bits, thus
improve 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
frameref). 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>
How aggressively to insert extra I-frames (-1
to 100)
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 be inserted only
every other keyint frames, which probably
leads to ugly encoding artifacts.
--sout-x264-bframes <integer>
Number of B-frames between I and P (1 to 16)
Number of consecutive B-frames between I and
P-frames.
--sout-x264-b-adapt, --no-sout-x264-b-adapt
Adaptive B-frame decision (default enabled)
If this is on, the specified number of
consecutive B-frames will always be used,
except possibly before an I-frame. (default
enabled)
--sout-x264-b-bias <integer>
Influences how often B-frames are used
Bias the choice to use B-frames. Positive
values cause more B-frames, negative values
cause less B-frames.
--sout-x264-bpyramid, --no-sout-x264-bpyramid
Keep some B-frames as references (default
disabled)
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. (default
disabled)
--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-15% bitrate.
(default enabled)
--sout-x264-ref <integer> Number of reference frames (1 to 16)
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.
--sout-x264-nf, --no-sout-x264-nf
No loop filter (enabling turns off the
deblocking loop filter) (default disabled)
Deblocking loop filter (increases quality).
(default disabled)
--sout-x264-qp <integer> Set QP (0=lossless) (0 to 51)
This selects the quantizer to use. Lower
values result in better fidelity, but higher
bitrates. 26 is a good default value.
--sout-x264-crf <integer> Quality-based VBR (nominal QP) (0 to 51)
1-pass Quality-based VBR.
--sout-x264-qpmin <integer>
Set min QP
Minimum quantizer, 15/35 seems to be a useful
range.
--sout-x264-qpmax <integer>
Set max QP
Maximum quantizer parameter.
--sout-x264-qpstep <integer>
Set max QP step
Max QP step between frames.
--sout-x264-ratetol <float>
Allowed variance of average bitrate
Sets the allowed variance in average. bitrate.
--sout-x264-vbv-maxrate <integer>
Max local bitrate
Sets a maximum local bitrate in kbits/s.
--sout-x264-vbv-bufsize <integer>
Size of VBV buffer
Sets an averaging period for the maximum
local bitrate in kbits/s.
--sout-x264-vbv-init <float>
Initial VBV buffer occupancy
Sets the initial buffer occupancy as a
fraction of the buffer size.
--sout-x264-ipratio <float>
QP factor between I and P
QP factor between I and P.
--sout-x264-pbratio <float>
QP factor between P and B
QP factor between P and B.
--sout-x264-chroma-qp-offset <integer>
QP difference between chroma and luma
QP difference between chroma and luma.
--sout-x264-qcomp <float> QP curve compression (0.0=CBR to 1.0=QCP)
QP curve compression.
--sout-x264-cplxblur <float>
Reduce fluctuations in QP (before curve
compression)
Temporally blur complexity.
--sout-x264-qblur <float> Reduce fluctuations in QP (after curve
compression)
Temporally blur quants.
--sout-x264-analyse {,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),b
8x8
- all : i4x4,p8x8,(i8x8),b8x8,p4x4
(p4x
4 requires p8x8. i8x8 requires 8x8dct).
--sout-x264-direct {,none,spatial,temporal}
Direct MV prediction mode
Direct MV prediction mode.
--sout-x264-weightb, --no-sout-x264-weightb
Weighted prediction for B-frames (default
disabled)
Weighted prediction for B-frames. (default
disabled)
--sout-x264-me {,dia,hex,umh,esa}
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)

--sout-x264-merange <integer>
Maximum motion vector search range (0 to 64)
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-32.
--sout-x264-subme <integer>
Subpixel motion estimation and partition
decision quality (1 to 6)
This parameter controls quality versus speed
tradeoffs involved in the motion estimation
decision process (lower = quicker and higher
= better quality).
--sout-x264-b-rdo, --no-sout-x264-b-rdo
RD based mode decision for B-frames. Requires
subme 6 (default disabled)
RD based mode decision for B-frames.
(default disabled)
--sout-x264-mixed-refs, --no-sout-x264-mixed-refs
Decide references on a per partition basis
(default disabled)
Allows each 8x8 or 16x8 partition to
independently select a reference frame, as
opposed to only one ref per macroblock.
(default disabled)
--sout-x264-chroma-me, --no-sout-x264-chroma-me
Ignore chroma in motion estimation (default
enabled)
Chroma ME for subpel and mode decision in
P-frames. (default enabled)
--sout-x264-bime, --no-sout-x264-bime
Jointly optimize both MVs in B-frames
(default disabled)
Joint bidirectional motion refinement.
(default disabled)
--sout-x264-8x8dct, --no-sout-x264-8x8dct
Adaptive spatial transform size (default
disabled)
SATD-based decision for 8x8 transform in
inter-MBs. (default disabled)
--sout-x264-trellis <integer>
Trellis RD quantization (0,1,2). Requires
CABAC
Trellis RD quantization:
- 0: disabled
-
1: enabled only on the final encode of a MB

- 2: enabled on all mode decisions

--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-nr <integer> Noise reduction
Dct-domain noise reduction. Adaptive
pseudo-deadzone.
--sout-x264-asm, --no-sout-x264-asm
CPU optimizations (default enabled)
CPU optimizations. (default enabled)
--sout-x264-psnr, --no-sout-x264-psnr
PSNR calculation (default disabled)
This has no effect on actual encoding
quality, it just prevents the stats from
being calculated (for speed). (default
disabled)
--sout-x264-verbose, --no-sout-x264-verbose
Print stats for each frame (default disabled)
Print stats for each frame. (default disabled)

DirectShow input
--dshow-vdev {,none} Video device name
You can specify the 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
You can specify the 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
You can specify the 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.
</nowiki>

==See also==
*[[Mac OS X]] for special notes on using the command line on Mac OS X