VideoLAN Wiki - User contributions [en]

Template:VLC:latest version

2019-06-09T08:58:29Z

DoesItReallyMatter: 3.0.7

3.0.7<noinclude>

[[Category:Templates]]
</noinclude>

Template:GSoC

2019-06-09T08:34:08Z

DoesItReallyMatter: Style edit

{{Navbox|title=[[VideoLAN]] [[Google Summer of Code]] (GSoC/SoC) mentoring projects|list1=[[SoC 2007|2007]] • [[SoC 2008|2008]] • [[SoC 2009|2009]] • [[SoC 2010|2010]] • [[SoC 2011|2011]] <small>([[GCodeIn 2011|GCi 2011]] • [[SOCIS x264 2011]])</small> • <s>[[SoC 2012|2012]]</s> • <s>[[SoC 2013|2013]]</s> • [[SoC 2016|2016]] • [[SoC 2017|2017]] • [[SoC 2018|2018]] • [[SoC 2019|2019]]}}<noinclude>
Navigational template for GSoC projects

[[Category:Footer templates]]
[[Category:Navigation templates]]
[[Category:SoC|*]]
</noinclude>

Template:Navbox

2019-06-09T08:32:11Z

DoesItReallyMatter: Manual revert of revision 60185, adapted: a wikitable will match the appearance of other templates

{| class="widebox center" style="background:#e0e8f8; font-size:90%; text-align:center;"
|'''{{{title}}}'''
|-
{{#if:{{{list1|}}}|{{!}} style="margin:auto 0.25em;" {{!}} {{#if:{{{group1|}}}|'''{{{group1}}}:'''}} {{{list1}}}
{{!}}- }}
{{#if:{{{list2|}}}|{{!}} style="margin:auto 0.25em;" {{!}} {{#if:{{{group2|}}}|'''{{{group2}}}:'''}} {{{list2}}}
{{!}}- }}
{{#if:{{{list3|}}}|{{!}} style="margin:auto 0.25em;" {{!}} {{#if:{{{group3|}}}|'''{{{group3}}}:'''}} {{{list3}}}
{{!}}- }}
|} 
<noinclude>
Navigational template for use in general

Format: title = title, groupX = heading of group X(optional), listX = list of links for group X
[[Category:Navigation templates]]
</noinclude>

Template:GSoC

2019-06-09T08:21:23Z

DoesItReallyMatter: Remove insignificant wikicode (no effect on layout)

{{Navbox|title=[[VideoLAN]] [[Google Summer of Code]] (GSoC/SoC) mentoring projects|list1=[[SoC 2007|2007]] • [[SoC 2008|2008]] • [[SoC 2009|2009]] • [[SoC 2010|2010]] • [[SoC 2011|2011]] • [[GCodeIn 2011|GCi 2011]] • [[SOCIS x264 2011]] • <s>[[SoC 2012|2012]]</s> • <s>[[SoC 2013|2013]]</s> • [[SoC 2016|2016]] • [[SoC 2017|2017]] • [[SoC 2018|2018]] • [[SoC 2019|2019]]}}<noinclude>
Navigational template for GSoC projects

[[Category:Footer templates]]
[[Category:Navigation templates]]
[[Category:SoC|*]]
</noinclude>

MediaWiki:Common.css

2019-06-09T08:10:51Z

DoesItReallyMatter: Add CSS comment: classes "hiddenStructure" and "if" should not be used

/* Styling links to www.VideoLan.org */
/*#bodyContent a.external, #bodyContent a[href^="http://www.videolan.org/"] {
-moz-background-clip:border;
-moz-background-inline-policy:continuous;
-moz-background-origin:padding;
background:transparent url(//www.videolan.org/favicon.ico) no-repeat scroll right center;
padding-right:13px;
}*/
/* Shows [[File:Folder icon.gif]] 2 pixels to the right of element for [[Template:VLCSourceFolder]].
To replace existing link icons use this with class plainlinks. */
.folder-icon {
background: transparent no-repeat url('https://wiki.videolan.org/images/Folder_icon.gif') center right;
padding-right: 18px;
}

/* Don't use these classes. See https://en.wikipedia.org/wiki/Wikipedia:HiddenStructure */
.hiddenStructure,
.if {display: none}

/* wikitable/prettytable class for skinning normal tables */
/* wikitable is already defined in load.php -- this adds 1em right margin */
table.wikitable,
table.prettytable {
margin: 1em 1em 1em 0;
background: #f9f9f9;
border: 1px solid #aaa;
border-collapse: collapse;
}

/* table.wikitable already defined in load.php, skipping */
table.prettytable th, table.prettytable td {
border: 1px solid #aaa;
padding: 0.2em;
}

/* table.wikitable already defined in load.php, skipping */
table.prettytable th {
background: #f2f2f2;
text-align: center;
}

/* pad table elements -- cellpadding is obsolete */
table.cellpadding-1px th, table.cellpadding-1px td,
table.wikitable.cellpadding-1px th, table.wikitable.cellpadding-1px td,
table.prettytable.cellpadding-1px th, table.prettytable.cellpadding-1px td { padding: 1px; }
table.cellpadding-2px th, table.cellpadding-2px td,
table.wikitable.cellpadding-2px th, table.wikitable.cellpadding-2px td
table.prettytable.cellpadding-2px th, table.prettytable.cellpadding-2px td { padding: 2px; }
table.cellpadding-3px th, table.cellpadding-3px td,
table.wikitable.cellpadding-3px th, table.wikitable.cellpadding-3px td,
table.prettytable.cellpadding-3px th, table.prettytable.cellpadding-3px td { padding: 3px; }
table.cellpadding-1em th, table.cellpadding-1em td,
table.wikitable.cellpadding-1em th, table.wikitable.cellpadding-1em td,
table.prettytable.cellpadding-1em th, table.prettytable.cellpadding-1em td { padding: 1em; }

/* [[Template:Module]] style */
table.wikitable.template-module {
width: 325px;
float: right;
clear: right;
margin: 0.5em;
padding: 0.2em;
font-size: 95%;
}
table.wikitable.template-module > * > tr > td {
color: black;
background: #eee;
}

/* Infobox template style */

.infobox {
border: 1px solid #aaa;
color: black;
background-color: #f9f9f9;
margin-bottom: 0.5em;
margin-left: 1em;
padding: 0.2em;
float: right;
clear: right;
}
.infobox td,
.infobox th {
vertical-align: top;
}
.infobox caption {
font-size: larger;
}

/* For [[Template:Side box]]. Renamed from .infobox.sisterproject */
.infobox.sidebox {
width: 250px;
font-size: 90%;
padding: 4px;
}

/* For [[Template:Side box]]. Counter MediaWiki CSS shifting bulleted items right by 1.5em */
.infobox-singleitem {
text-align: start;
margin-left: 4.0em;
}
.infobox-multipleitem {
text-align: start;
margin-left: 2.5em;
}
/* For [[Template:Documentation streaming howto toc]], [[Template:Documentation toc]] and [[Template:Documentation TOC]] */
.tocsidebar {
font-size: 80%;
border: 1px solid #aaa;
padding: 5px;
}

.widebox {
width: 80%;
border: 1px solid #999;
background: #f8f8f8;
clear: both;
padding: 2px;
margin-left: auto;
margin-right: auto;
}
.nowrap {
white-space: nowrap;
}
.hatnote {
font-style: italic;
margin-left: 1.5em;
}
/* pre tags do not clip content */
#bodyContent pre {
white-space: pre-wrap;
word-break: break-all;
}
/* For [[VLC Features Formats]] and others */
.codec-table {
font-size: small;
text-align: center;
width: 100%;
margin: 1em auto;
border-width: 1px;
}
/* For [[Template:Banner]]:
Styling for the block element or table cell that holds banner-title and banner-subtitle */
.banner-text {
width: 56%;
background: none;
}
/* For [[Template:Banner]] */
.banner-title {
font-size: 162%;
margin: 0;
padding: .1em;
}
/* For [[Template:Banner]] */
.banner-subtitle {
top: +0.2em;
font-size: 95%;
}
/* For [[Template:Banner]] */
.banner {
width: 100%;
margin: 0 auto 10px;
color: black;
background-color: #fcfcfc;
border: 1px solid #ccc;
}
/* For [[Template:Banner]] */
.banner-links-col1 {
width: 11%;
font-size: 95%;
}
/* For [[Template:Banner]] */
.banner-links-col2 {
width: 14%;
font-size: 95%;
}
/* For [[Template:Banner]] */
.banner-links-col3 {
width: 18%;
font-size: 95%;
}
[class|=banner-links] {
vertical-align: top;
}
/* General use */
div.plainlist ul > li {
list-style: none none;
}
/* Creates two columns */
div.col2 {
-webkit-column-count: 2;
-moz-column-count: 2;
-o-column-count: 2;
column-count: 2;
}
/* Creates three columns */
div.col3 {
-webkit-column-count: 3;
-moz-column-count: 3;
-o-column-count: 3;
column-count: 3;
}
/* Creates four columns */
div.col4 {
-webkit-column-count: 4;
-moz-column-count: 4;
-o-column-count: 4;
column-count: 4;
}
/* Creates five columns */
div.col5 {
-webkit-column-count: 5;
-moz-column-count: 5;
-o-column-count: 5;
column-count: 5;
}
/* Creates six columns */
div.col6 {
-webkit-column-count: 6;
-moz-column-count: 6;
-o-column-count: 6;
column-count: 6;
}
/* Creates seven columns */
div.col7 {
-webkit-column-count: 7;
-moz-column-count: 7;
-o-column-count: 7;
column-count: 7;
}

VLC HowTo/Integrate with Google Web Toolkit

2019-06-09T08:04:27Z

DoesItReallyMatter: Layout, markup

{{howto|integrate with Google Web Toolkit}}
{{Example code}}
__FORCETOC__
VLC can be integrated in Google Web Toolkit (GWT) web applications. The easiest way is to embed the VLC browser plugin in your web application. This also ensures that no question arises whether your web application is derivative work or not, as a clean separation between the web application and VLC exists. Alternatively, a build of VLC can be integrated in a web app, using applicable bindings. This article discusses integration based on the VLC plugin. There are two levels of integration:
* Static integration in the main HTML file (MyProject.html as generated by GWT/applicationCreator)
* Dynamic integration in HTML code, which is generated at web application runtime
(In any case, remember that VLC treats the browser plugin for Firefox/Mozilla only as an installation option. You might have to go back and install this option and also point out in your documentation that this option needs to be installed if users run your web application with Mozilla/Firefox.)

== Static integration in MyProject.html ==
Static integration is straightforward and based on methods described in two separate articles:
* Mozilla/Firefox plug-in: [[Documentation:Play HowTo/Advanced Use of VLC#Use the Mozilla plugin]]
* ActiveX Control: [[ActiveX/HTML]]
Following the description in the [[ActiveX/HTML]] article, you can include some code based on the following snippet in your main HTML file (MyProject.html):
<syntaxhighlight lang="html4strict">
<OBJECT classid="clsid:9BE31822-FDAD-461B-AD51-BE1D1C159921"
codebase="http://downloads.videolan.org/pub/videolan/vlc/latest/win32/axvlc.cab"
width="320"
height="240"
id="vlc" events="True">
<param name="Src" value="$mri" />
<param name="ShowDisplay" value="True" />
<param name="AutoLoop" value="False" />
<param name="AutoPlay" value="True" />
<EMBED pluginspage="http://www.videolan.org"
type="application/x-vlc-plugin" progid="VideoLAN.VLCPlugin.2"
width="320"
height="240"
autoplay="yes"
loop="no"
target="$mri"
name="vlc">
</EMBED>
</OBJECT>
</syntaxhighlight>
Internet Explorer (IE6) responds to the code in the {{Tag|OBJECT}} tag, while Mozilla/Firefox uses the settings inside the {{Tag|EMBED}} tag.
Replace parameters as appropriate, e.g. $mri with the [[Media resource locator|Multimedia Resource Identifier]] of your incoming stream.

== Embedding in dynamically generated HTML code ==
It is possible to integrate the VLC plugin in dynamically generated HTML code, based on the GWT classes HTML, HTMLPanel and HTMLTable.

The integration of the VLC plugin in dynamically generated HTML code is based on DOM calls and some JavaScript as opposed to GWT API calls. For some reason(s), the GWT API calls do not support the integration of the VLC plugin, although other plugin's might work just fine. <code>Panel.add()</code> for example is a key method which does not hook the plugin into the DOM as expected by the VLC plugin. This is not necessarily a fault of the VLC plugin, but rather browser-specific differences in Javascript implementation, and how GWT works. Below a snippet which should contain all the necessary DOM calls and JavaScript code which worked for me for Mozilla/Firefox ''and'' IE6:
<syntaxhighlight lang="javascript">
{
{

streamerCode = ".............."; // Use example code above as a starting point

// IE6: Wrap VLC plugin in an HTML block element. Needed to work around known "quirk" in IE6's implementation of innerHTML
// Does not hurt Mozilla/Firefox
// http://support.microsoft.com/kb/276228
com.google.gwt.user.client.Element newdiv = DOM.createElement("div");
DOM.setInnerHTML(newdiv, streamerCode);

// Append div block on DOM level. Needed for all browsers; GWT Panel.add() does not work for VLC
// Mozilla Firefox is OK with appendChild() to any GWT Panel; IE6 works only if appended to RootPanel
DOM.appendChild(RootPanel.get("browserElementInHTMLCode").getElement(), newdiv);

// Set width and height in VLC's style. Needed and has effect for IE6. Alternatively, this could probably be accomplised through setting the style of the VLC plugin as well.
// Solution found here: http://forum.videolan.org/viewtopic.php?f=16&t=33736&p=104306&hilit=innerHTML#p104306
// Bindings for different browsers explained here: http://www.permadi.com/tutorial/flashGetObject/
vlcSetWidth("vlc", "320");
vlcSetHeight("vlc", "160");
}

/**
* set width of VLC plugin
*
* @param width
*/
native static void vlcSetWidth(String targetId, String width) /*-{
$doc[targetId].style.width=width;
}-*/;

/**
* set height of VLC plugin
*
* @param height
*/
native static void vlcSetHeight(String targetId, String height) /*-{
$doc[targetId].style.height=height;
}-*/;

}
</syntaxhighlight>

It does not make a difference whether the VLC lugin is integrated on the static or dynamic level; a handle to the VLC plugin is obtained through the RootPanel method RootPanel get(java.lang.String id) which returns the browser element that embeds the VLC plugin. Code must be added to the HTML code to create a browser element with an ID which can be captured by the RootPanel mathod get(java.lang.String id), e.g. as follows:
<syntaxhighlight lang="html5">
<table><tr><td id="browserElementInHTMLCode">

</td></tr></table>
</syntaxhighlight>

== User interaction ==
The VLC plugin has a Javascript API which allows the implementation of user interactions like Play or Pause on the web application level. The plug-in can be called through Javascript as described in the [[ActiveX/HTML]] article. GWT/Java wrappers for these calls are not available (yet). Below a couple of examples.
<syntaxhighlight lang="javascript">
/**
* stop VLC plugin
*/
native static void vlcStop(String targetId) /*-{
$doc[targetId].playlist.stop();
}-*/;

/**
* play VLC plugin
*/
native static void vlcPlay(String targetId) /*-{
$doc[targetId].playlist.play();
}-*/;
</syntaxhighlight>

VLC HowTo/Integrate with Google Web Toolkit

2019-06-09T07:59:29Z

DoesItReallyMatter: Show Template:Howto, +{{Example code}}

{{howto|integrate with Google Web Toolkit}}
{{Example code}}
== GWT ==
VLC can be integrated in Google Web Toolkit (GWT) web applications. The easiest way is to embed the VLC browser plugin in your web application. This also ensures that no question arises whether your web application is derivative work or not, as a clean separation between the web application and VLC exists. Alternatively, a build of VLC can be integrated in a web app, using applicable bindings. This article discusses integration based on the VLC plugin. There are two levels of integration:
* Static integration in the main HTML file (MyProject.html as generated by GWT/applicationCreator)
* Dynamic integration in HTML code, which is generated at web application runtime
(In any case, remember that VLC treats the browser plugin for Firefox/Mozilla only as an installation option. You might have to go back and install this option and also point out in your documentation that this option needs to be installed if users run your web application with Mozilla/Firefox.)

=== Static integration in MyProject.html ===
Static integration is straightforward and based on methods described in two separate articles:
* Mozilla/Firefox plug-in: [[Documentation:Play HowTo/Advanced Use of VLC#Use the Mozilla plugin]]
* ActiveX Control: [[ActiveX/HTML]]
Following the description in the [[ActiveX/HTML]] article, you can include some code based on the following snippet in your main HTML file (MyProject.html):
<big><big><syntaxhighlight lang="html4strict">
<OBJECT classid="clsid:9BE31822-FDAD-461B-AD51-BE1D1C159921"
codebase="http://downloads.videolan.org/pub/videolan/vlc/latest/win32/axvlc.cab"
width="320"
height="240"
id="vlc" events="True">
<param name="Src" value="$mri" />
<param name="ShowDisplay" value="True" />
<param name="AutoLoop" value="False" />
<param name="AutoPlay" value="True" />
<EMBED pluginspage="http://www.videolan.org"
type="application/x-vlc-plugin" progid="VideoLAN.VLCPlugin.2"
width="320"
height="240"
autoplay="yes"
loop="no"
target="$mri"
name="vlc">
</EMBED>
</OBJECT>
</syntaxhighlight></big></big>
Internet Explorer (IE6) responds to the code in the <OBJECT> tag, while Mozilla/Firefox uses the settings inside the <EMBED> tag.
Replace parameters as appropriate, e.g. $mri with the [[Media resource locator|Multimedia Resource Identifier]] of your incoming stream.

=== Embedding in dynamically generated HTML code ===
It is possible to integrate the VLC plugin in dynamically generated HTML code, based on the GWT classes HTML, HTMLPanel and HTMLTable.

The integration of the VLC plugin in dynamically generated HTML code is based on DOM calls and some JavaScript as opposed to GWT API calls. For some reason(s), the GWT API calls do not support the integration of the VLC plugin, although other plugin's might work just fine. Panel.add() for example is a key method which does not hook the plugin into the DOM as expected by the VLC plugin. This is not necessarily a fault of the VLC plugin, but rather browser-specific differences in Javascript implementation, and how GWT works. Below a snippet which should contain all the necessary DOM calls and JavaScript code which worked for me for Mozilla/Firefox ''and'' IE6:
<big><big><syntaxhighlight lang="javascript">
{
{

streamerCode = ".............."; // Use example code above as a starting point

// IE6: Wrap VLC plugin in an HTML block element. Needed to work around known "quirk" in IE6's implementation of innerHTML
// Does not hurt Mozilla/Firefox
// http://support.microsoft.com/kb/276228
com.google.gwt.user.client.Element newdiv = DOM.createElement("div");
DOM.setInnerHTML(newdiv, streamerCode);

// Append div block on DOM level. Needed for all browsers; GWT Panel.add() does not work for VLC
// Mozilla Firefox is OK with appendChild() to any GWT Panel; IE6 works only if appended to RootPanel
DOM.appendChild(RootPanel.get("browserElementInHTMLCode").getElement(), newdiv);

// Set width and height in VLC's style. Needed and has effect for IE6. Alternatively, this could probably be accomplised through setting the style of the VLC plugin as well.
// Solution found here: http://forum.videolan.org/viewtopic.php?f=16&t=33736&p=104306&hilit=innerHTML#p104306
// Bindings for different browsers explained here: http://www.permadi.com/tutorial/flashGetObject/
vlcSetWidth("vlc", "320");
vlcSetHeight("vlc", "160");
}

/**
* set width of VLC plugin
*
* @param width
*/
native static void vlcSetWidth(String targetId, String width) /*-{
$doc[targetId].style.width=width;
}-*/;

/**
* set height of VLC plugin
*
* @param height
*/
native static void vlcSetHeight(String targetId, String height) /*-{
$doc[targetId].style.height=height;
}-*/;

}
</syntaxhighlight></big></big>

It does not make a difference whether the VLC lugin is integrated on the static or dynamic level; a handle to the VLC plugin is obtained through the RootPanel method RootPanel get(java.lang.String id) which returns the browser element that embeds the VLC plugin. Code must be added to the HTML code to create a browser element with an ID which can be captured by the RootPanel mathod get(java.lang.String id), e.g. as follows:
<big><big><syntaxhighlight lang="html5">
<table><tr><td id="browserElementInHTMLCode">

</td></tr></table>
</syntaxhighlight></big></big>

=== User interaction ===
The VLC plugin has a Javascript API which allows the implementation of user interactions like Play or Pause on the web application level. The plug-in can be called through Javascript as described in the [[ActiveX/HTML]] article. GWT/Java wrappers for these calls are not available (yet). Below a couple of examples.
<big><big><syntaxhighlight lang="javascript">
/**
* stop VLC plugin
*/
native static void vlcStop(String targetId) /*-{
$doc[targetId].playlist.stop();
}-*/;

/**
* play VLC plugin
*/
native static void vlcPlay(String targetId) /*-{
$doc[targetId].playlist.play();
}-*/;
</syntaxhighlight></big></big>

VLC HowTo/Extract audio

2019-06-09T07:58:06Z

DoesItReallyMatter: Show Template:Howto

{{Howto|extract audio}}
VLC can '''extract audio''' from any of the many input sources it supports, and write this audio to an audio-file in a variety of formats. In other words, it discards any video content from the input source, and it converts the audio content to the desired format.

You can invoke audio extraction from the VLC graphical user interface, or from the VLC command line. When using the VLC command line, you can select options that let you monitor the audio (and/or video, actually) as the extraction happens. Or, you can select options to hide VLC's visual interfaces, leaving it to extract and convert the audio data as fast as the computer allows -- which might take a fraction of the time. You can also script the VLC command line invocations, letting you do many extraction tasks without manual effort.

==Planning==

Identify the source from which you want to extract the audio signal. You will open this source from VLC using the same GUI operations or command-line options as you would for any other VLC usage.

Is the source an audio-only file? If so, then this operation is a simple [[transcode|transcoding]] of audio content from one format to another. Be aware that, while VLC has certain facility for this task, other tools may be even more powerful, faster, or more reliable for the task. For instance, the [http://flac.sourceforge.net/documentation_tools_flac.html FLAC tools] include a command-line utility which can convert [[WAV]] files into [[FLAC]] files with excellent speed and reliability. Where VLC really shines is for sources which combine video and audio content.

Is the source a [[DVD]], or other container with internal structure, such as multiple "Titles", and multiple "Chapters" in each Title? If so, then you need to identify which Title and Chapters include the audio content you want, and which are irrelevant. For instance, a DVD may have a menu in Title 1, an advertisement in Title 2, the main content in Title 3, and a trailer in Title 3. The main content in Title 3 may be divided into dozens of chapters, like the tracks in a CD. In a case like this, you probably want only the audio content from Title 3, not from the other Titles. You may want to extract a single audio file with the content of all of Title 3, or you may want a separate audio output file for each Chapter.

The VLC GUI provides a somewhat clumsy but workable way to explore the structure of a DVD or corresponding video file. Here is how (as of Windows version 1.1.11):
# Run the VLC app.
# Put the DVD into the computer's DVD reader.
# From '''Media''' menu, select '''Open Disc...''' (Ctl-D). The '''Open Media''' dialog appears.
# Select the '''Disc''' tab. In the '''Disc''' tab's "Disk Selection" section, select the "DVD" radio button . From the "Disc device" menu, select the menu entry corresponding to the computer's DVD reader. For example, it might be "F:\ - Wedding Movie". Click the '''Play''' button at the bottom of the dialog. The '''Open Media''' dialog disappears. The DVD now appears as an entry in the playlist, e.g. "DVD://F".
# Double-click on the DVD entry in the playlist. The DVD starts playing. If necessary, select entries in the DVD's menu to start the DVD playing the content from which you want to extract audio.
# From the '''Playback''' menu, hover over '''Title >'''. A second menu appears, with entries like "DVD Menu", "Title 1", "Title 2", "Title 3". These are the Title choices you have to pull from. A check mark will be next to one of the entries. This is the Title with your content.
# On the '''Playback''' menu, move down to hover over '''Chapter >'''. A second menu appears, with entries like "Chapter 1", "Chapter 2", etc. A check mark will be next to one of the entries. This is the Chapter with your content.
# Note the last entry in the '''Chapter >''' submenu. This tells how many chapters there are in total in that title.
# Note the Title and Chapter number of the start of the content from which you want to extract audio. Also note the final Title and Chapter number of the content.

==Using the VLC graphical user interface (GUI)==

See [http://www.wikihow.com/Rip-DVD-Audio-to-MP3-Using-VLC-Media-Player How to Rip DVD Audio to MP3 Using VLC Media Player], Edited by AudioDude and 2 others, WikiHow.com

Note that VLC's GUI lets you specify the Title and Chapter from which it will start, but VLC will continue extracting until the end of the Title. It doesn't let you extract a single Chapter at a time. To do that, you will need to use the VLC command line.

==Using the VLC command line==

This section gives examples of how to extract audio using VLC's command line invocation.

===The VLC command invocation===
The start of the command line is the VLC invocation. On Windows this looks like:
"c:\Program Files\VideoLAN\VLC\vlc.exe"

On macOS it looks like:
/Applications/VLC.app/Contents/MacOS/VLC

On Linux, if the vlc executable is on your path, it looks like:
vlc

===General options===
The command line will have a sequence of general options. These are the same for all platforms.
-I dummy --no-sout-video --sout-audio --no-sout-rtp-sap --no-sout-standard-sap --ttl=1 --sout-keep

Here's what those options mean:
;-I dummy:VLC should run with no GUI, typing error messages and asking for input in the command line window. This is better for scripting and for faster completion. Leave this option off if you want the GUI to appear.
;--no-sout-video:VLC will not pass on a video component to the streaming output
;--sout-audio:VLC will, however, pass on an audio component to the streaming output
;--no-sout-rtp-sap --no-sout-standard-sap:VLC will not deliver streaming output in [[RTP]]-[[SAP]] or [[SAP|Standard SAP]] forms.
;--ttl=1:A parameter for RTP and SAP; innocuous here.
;--sout-keep:Keep a copy of the streaming output; innocuous here.

===The sout string===
An option string, marked by '''--sout''', tells VLC how to transcode the content and in what format to write it. See below for fully detailed examples. However, here is one sout string, specifying to transcode to a WAV audio format.
--sout "#transcode{acodec=s16l,channels=2}:std{access=file,mux=wav,dst=C:\User\Admin\Desktop\yourAudio.wav}"

===The source MRL===
The '''[[Media Resource Locator]]''' ([[MRL]]) is a string which tells VLC where to find the source content, e.g. the DVD or source file. For more on the MRL syntax, see [[VLC command-line help]].

The MRL for a DVD, selecting only Title 3, Chapter 38, in Windows looks like:
dvdsimple:///F:\#3:38-3:38

A similar MRL for macOS looks like:
dvdsimple:///dev/rdisk2/@3:38-3:38

An MRL could also be a filename, directory name, or a path to a file or directory name.
Video.TS///C:\Users\Admin\Desktop\yourVideo.mp4\#1:33-16:38

At the every end of the command line, put this special second MRL. It tells VLC to end its run without looking for another MRL to transcode.
vlc://quit

===Specifying output format===

====Extracting audio in original format====

If you want the extracted audio in the same format as it is stored in the input, then VLC can provide it to you with no loss of quality, because there is no re-encoding of the content.

The way to do this for AC3 format audio from a DVD video is (on Linux):

vlc --no-sout-video dvdsimple:///dev/scd0@1:1 :sout='#std{access=file,mux=raw,dst=./file.ac3}'

Note: <tt>:sout</tt> means that the option ''sout'' applies only to the preceding stream, not to the whole command line. See ''[[VLC command-line help]]''.

====Extracting audio in FLAC format====

This is an example of a Windows command line which extracts the audio content of an arbitrary file, to a FLAC audio file. "C:\User\Admin\Desktop\yourAudio.wav" is the destination of your file, and "C:\User\Admin\Desktop\yourVideo.mp4\#0:01-3:38" is the location of your original video, followed by arbitrary starting and ending times.

The example has line breaks for clarity, but your command should all be on one line:

"c:\Program Files\VideoLAN\VLC\vlc.exe" -I dummy --no-sout-video --sout-audio
--no-sout-rtp-sap --no-sout-standard-sap --ttl=1 --sout-keep
--sout "#transcode{acodec=flac}:std{mux=raw,dst=C:\User\Admin\Desktop\yourAudio.flac}"
Video.TS:///C:\User\Admin\Desktop\yourVideo.mp4\#0:01-3:38 vlc://quit

Notice the changes:
;acodec=flac:tells VLC to convert audio content using the [[FLAC]] [[codec]]
;mux=raw:uses a raw file structure instead of the WAV file structure
;File extension .flac:The file extension is FLAC for FLAC-format content.

====Extracting audio in MP3 format====

'''TODO!'''

====Extracting audio in WAV format====

This is an example of a Windows command line which extracts the audio content of an arbitrary file, to a WAV audio file. "C:\User\Admin\Desktop\yourAudio.wav" is the destination of your file, and "C:\User\Admin\Desktop\yourVideo.mp4\#0:01-3:38" is the location of your original video, followed by arbitrary starting and ending times.

The example has line breaks for clarity, but your command should all be on one line:

"c:\Program Files\VideoLAN\VLC\vlc.exe" -I dummy --no-sout-video --sout-audio
--no-sout-rtp-sap --no-sout-standard-sap --ttl=1 --sout-keep
--sout "#transcode{acodec=s16l,channels=2}:std{access=file,mux=wav,dst=C:\User\Admin\Desktop\yourAudio.wav}"
Video.TS:///C:\User\Admin\Desktop\yourVideo.mp4\#0:01-3:38 vlc://quit

The parameter '''acodec=s16l''' tells VLC to use convert the audio content using the [[s16l]] [[codec]], which is the codec for [[WAV]] format audio. Parameter '''mux=wav''' tells VLC to write the s16l audio data into a file with the WAV structure. The file path starts with "\\\\", because each pair "\\" is converted to a single "\" by the command line environment, giving a server path of <tt>\\Server\Qmultimedia</tt>. The file extension is ".wav" for WAV format files.

===Scripting extraction of multiple chapters using a batch file===
The above example command lines caused VLC to extract audio for a single Chapter of a single Title into a single audio file. It is possible on Windows, macOS, and Linux command lines to write a script that loops through the Chapters of a Title and calls VLC for each one. Such a script can run unnattended for the tens of minutes it might take to extract a couple of hours of audio content, in dozens of tracks.

Here is a windows batch file which scripts VLC to extract all Chapters from a Title to a set of files in a directory on a Windows server. The first five lines, each beginning '''set''', define parameters. The final line, beginning '''for /L''', performs the loop and invokes VLC. The Windows batch file processor replaces parameter names surrounded by percent characters, e.g. %DestPrefix%, by their values.
<pre>
set DVDDrive=F:
set DestPrefix=\\\\Server\Qmultimedia\Music\wav_files\audio
set Title=3
set FirstChapter=1
set LastChapter=38

rem the following has line breaks for legibility. Remove them so it's all on one line.
for /L %%i in (%FirstChapter%,1,%LastChapter%) do "c:\Program Files\VideoLAN\VLC\vlc.exe"
-I dummy --no-sout-video --sout-audio --no-sout-rtp-sap --no-sout-standard-sap --ttl=1
--sout-keep --sout "#transcode{acodec=s16l,channels=2}:std{access=file,mux=wav,dst=%DestPrefix%_c%%i.wav}"
dvdsimple:///%DVDDrive%\#%Title%:%%i-%Title%:%%i vlc://quit
</pre>

To use this script, copy its contents into a file, say with a name '''riploop.bat'''. Be sure the final line, beginning with '''for /L'' and ending with '''vlc://quit''', is all on a single line; remove the line breaks which were inserted for legibility on this page. Then type in a Windows command line window, connect to the directory with the script file, and type '''riploop.bat''' to run it. VLC will pop up a new command line window for each invocation of VLC.

== See Also ==
* [http://www.wikihow.com/Rip-DVD-Audio-to-MP3-Using-VLC-Media-Player How to Rip DVD Audio to MP3 Using VLC Media Player], Edited by AudioDude and 2 others, WikiHow.com
* article ''[[Extract audio from a file]]''

VLC HowTo/Transcode multiple videos

2019-06-09T07:56:07Z

DoesItReallyMatter: Copy-edit prose (light), remove insignificant code indentation (relative code indentation has been retained), remove <big>...</big> for code, misc.

{{Howto|batch transcode or encode}}
{{Example code|l=GPL}}

== Idea ==
The idea is to use VLC to do some batch work to encode or [[transcode]] multiple files one after each other, without having to care about it.

You may want to transcode all your videotheque to another format to play them on an [[iPod]], a [[Play on Zune|Zune]], a PS3 or an [[Play on Xbox|Xbox]].

== Codecs / Muxers ==
You have to choose the correct [[codec]]s for the device you want to transcode for.

We choose here [[H.264]] with [[AAC]] in a [[MPEG-TS|MPEG-2/TS]] muxer as an example.

== GUI ==
Batch convert is supported via the {{GUI}} in VLC 3.0.0

Otherwise, use command-line batch transcoding below.

== Command Lines ==
=== Windows ===
For example, to transcode a batch of m4a files (potentially in multiple subdirectories of a single common root directory) to mp3 files (512kb/s encoding with 44100 sampling frequency) you could use the following code in a Windows XP command prompt:
<syntaxhighlight lang="dos">
for %%a in (*.VOB) do "C:\Program Files\VideoLAN\VLC\vlc" -I dummy -vvv %%a --sout=#transcode{vcodec=h264,vb=1024,acodec=mp4a,ab=192,channels=2,deinterlace}:standard{access=file,mux=ts,dst=%%a.mpg} vlc://quit

@ECHO OFF
REM ########################################################################
REM # A Windows XP cmd.com script to batch convert m4a files to mp3. #
REM # #
REM # Copyright (C) 2008 Andrew Boden #
REM # (boden@graduate.uwa.edu.au) #
REM # #
REM # This program is free software: you can redistribute it and/or modify #
REM # it under the terms of the GNU General Public License as published by #
REM # the Free Software Foundation, either version 3 of the License, or #
REM # (at your option) any later version. #
REM # #
REM # This program is distributed in the hope that it will be useful, #
REM # but WITHOUT ANY WARRANTY; without even the implied warranty of #
REM # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the #
REM # GNU General Public License for more details. #
REM # #
REM # You should have received a copy of the GNU General Public License #
REM # along with this program. If not, see <http://www.gnu.org/licenses/>.#
REM # #
REM # Version 1.0 (June 27th 2008) #
REM # Uses VideoLAN VLC 0.8.6h (www.videolan.org) #
REM # Gracefully handles commas and apostrophes in file names. #
REM # Not aware of any other characters needing graceful handling. #
REM # 512kbps encoding with 44100 sampling. #
REM ########################################################################

FOR /R %%G IN (*.m4a) DO (CALL :SUB_VLC "%%G")
FOR /R %%G IN (*.m4a.mp*) DO (CALL :SUB_RENAME "%%G")
GOTO :eof

:SUB_VLC
SET _firstbit=%1
SET _qt="
CALL SET _newnm=%%_firstbit:%_qt%=%%
SET _commanm=%_newnm:,=_COMMA_%
REM echo %_commanm%
CALL "C:\Program Files\VideoLAN\VLC\vlc" -I dummy -vvv %1 --sout=#transcode{acodec="mpga",ab="512","channels=2",samplerate="44100"}:standard{access="file",mux="mpeg1",dst="%_commanm%.mp3"} vlc://quit
GOTO :eof

:SUB_RENAME
SET _origfnm=%1
SET _endbit=%_origfnm:*.m4a=%
CALL SET _newfilenm=%%_origfnm:.m4a%_endbit%=.mp3%%
SET _newfilenm=%_newfilenm:_COMMA_=,%
COPY %1 %_newfilenm%
DEL %1
GOTO :eof

:eof
</syntaxhighlight>

The same as above, for vlc >= 0.9:
<syntaxhighlight lang="dos">
@ECHO OFF
FOR /R %%G IN (*.m4a) DO (CALL :SUB_VLC "%%G")
FOR /R %%G IN (*.m4a.mp*) DO (CALL :SUB_RENAME "%%G")
GOTO :eof

:SUB_VLC
SET _firstbit=%1
SET _qt="
CALL SET _newnm=%%_firstbit:%_qt%=%%
SET _commanm=%_newnm:,=_COMMA_%
REM echo %_commanm%
CALL "C:\Program Files\VideoLAN\VLC\vlc" -I dummy -vvv %1 --sout=#transcode{acodec="mpga",ab="512","channels=2"}:standard{access="file",mux="raw",dst="%_commanm%.mp3"} vlc://quit
GOTO :eof

:SUB_RENAME
SET _origfnm=%1
SET _endbit=%_origfnm:*.m4a=%
CALL SET _newfilenm=%%_origfnm:.m4a%_endbit%=.mp3%%
SET _newfilenm=%_newfilenm:_COMMA_=,%
COPY %1 %_newfilenm%
DEL %1
GOTO :eof

:eof
</syntaxhighlight>

=== Windows 7 SendTo ===
This batch file allows to use the Windows SendTo context menu in Explorer.<br />
Copy the content in a file named MOV_to_MPG_Converter.bat and copy it to your SendTo directory (CMD SHELL:sendto)
<syntaxhighlight lang="dos">

@ECHO OFF
rem ***********************************************************************
rem * MOV to MPG batch converter. (2014-09-29 Sinx) *
rem * *
rem * For installation just copy batch file to SendTo directory. *
rem * On Win8 execute "SHELL:sendto" to go to Sendto folder. *
rem * *
rem * I got quite good compression rations with these parameters: *
rem * vcodec=h264 codec used *
rem * vb=10000 video bandwidth *
rem * deinterlace=1 rebuild full pictures from keyframes and diffs. *
rem * acodec=mp3 audio codec *
rem * ab=128 128kbps mp3 quality *
rem * channels=2 stereo *
rem * *
rem * for parameters see *
rem * http://www.videolan.org/doc/vlc-user-guide/de/ch04.html *
rem ***********************************************************************
echo **********************************************************************
echo MOV to MPG VLC batch converter called: %0 %1 %2 %3 %4 %5 %6 %7 %8
echo **********************************************************************
echo.
echo For installation, just copy batch file to SendTo folder..
echo.

SET _new_extention=mpg

:start
if "%~1"=="" (call goto :the_end)
CALL :SUB_CONVERT %1
SHIFT
goto :start

:SUB_CONVERT
SET _orig_path=%~1
rem SET _orig_extention=%_orig_filename:*.=%
echo %_orig_path%
SET _orig_extention=%_orig_path:*.=%
CALL SET _new_path=%%_orig_path%:.%_orig_extention%=.%_new_extention%%%
set _new_path="%_new_path%"
echo.
echo Converting %1 ======TO===== %_new_path% ...
echo.

if exist "%ProgramFiles%\VideoLAN\VLC\vlc.exe" (
SET _vlc_path="%ProgramFiles%\VideoLAN\VLC\vlc"
) else (
SET _vlc_path="%ProgramFiles(x86)%\VideoLAN\VLC\vlc"
)

CALL %_vlc_path% -I dummy -vvv %1 --sout=#transcode{vcodec=h264,vb=10000,deinterlace=1,acodec=mp3,ab=128,channels=2,samplerate=44100}:standard{access=file,mux=ts,dst=%_new_path%} vlc://quit
GOTO :eof

:the_end
echo **********************************************************************
echo * FINISHED *
echo **********************************************************************
pause
</syntaxhighlight>

=== Powershell ===
<syntaxhighlight lang="powershell">
$outputExtension = ".mp3"
$bitrate = 160
$channels = 2

foreach($inputFile in get-childitem -recurse -Filter *.wav)
{
$outputFileName = [System.IO.Path]::GetFileNameWithoutExtension($inputFile.FullName) + $outputExtension;
$outputFileName = [System.IO.Path]::Combine($inputFile.DirectoryName, $outputFileName);

$programFiles = ${env:ProgramFiles(x86)};
if($programFiles -eq $null) { $programFiles = $env:ProgramFiles; }

$processName = $programFiles + "\VideoLAN\VLC\vlc.exe"
$processArgs = "-I dummy -vvv `"$($inputFile.FullName)`" --sout=#transcode{acodec=`"mp3`",ab=`"$bitrate`",`"channels=$channels`"}:standard{access=`"file`",mux=`"wav`",dst=`"$outputFileName`"} vlc://quit"

start-process $processName $processArgs -wait
}
</syntaxhighlight>

=== Unix / Linux ===
Transcodes all files in current directory (except hidden files), saving with suffix <code>.transcoded</code>.

<syntaxhighlight lang="bash">
#!/bin/sh
######################## Transcode the files using ... ########################
vcodec="mp4v"
acodec="mp4a"
vb="1024"
ab="128"
mux="mp4"
###############################################################################

# Store path to VLC in $vlc
if command -pv vlc >/dev/null 2>&1; then
# Linux should find "vlc" when searching PATH
vlc="vlc"
else
# macOS seems to need an alias
vlc="/Applications/Utilities/VLC.app/Contents/MacOS/VLC"
fi
# Sanity check
if ! command -pv "$vlc" >/dev/null 2>&1; then
printf '%s\n' "Cannot find path to VLC. Abort." >&2
exit 1
fi

for filename in *; do
printf '%s\n' "=> Transcoding '$filename'... "
"$vlc" -I dummy -q "$filename" \
--sout '#transcode{vcodec="$vcodec",vb="$vb",acodec="$acodec",ab="$ab"}:standard{mux="$mux",dst="$filename.transcoded",access=file}' \
vlc://quit
ls -lh "$filename" "$filename.transcoded"
printf '\n'
done
</syntaxhighlight>

The wildcard <code>*.transcoded</code> will select all of the transcoded files for group operations.

To move files:
<syntaxhighlight lang="bash">
mv *.transcoded <directory>
</syntaxhighlight>
To remove all filename extensions (including <code>.transcoded</code>):
<syntaxhighlight lang="bash">
for filename in *.transcoded; do mv "$filename" "${filename%%.*}"; done
</syntaxhighlight>
To remove all filename extensions and replace with another (e.g. <code>.mp3</code>):
<syntaxhighlight lang="bash">
for filename in *.transcoded; do mv "$filename" "${filename%%.*}.mp3"; done
</syntaxhighlight>

VLC HowTo/Transcode multiple videos

2019-06-09T07:38:11Z

DoesItReallyMatter: /* Unix / Linux */ Works better, clearer

{{Howto|batch transcode or encode}}
{{Example code|l=GPL}}

== Idea ==
The idea is to use VLC to do some batch work to encode or transcode multiple files one after each other, without having to care about it.

You may want to transcode all your videotheque to another format to play them on an [[IPod]], a [[Play on Zune|Zune]], a PS3 or a [[Play on Xbox|Xbox]].

== Codecs / Muxers ==
You have to choose the correct codecs for the device you want to transcode for.

We choose here [[H.264]] with [[AAC]] in a [[MPEG-2#TS|MPEG-2/TS]] muxer as an example.

== GUI ==
Batch convert is supported via the {{GUI}} in VLC 3.0.0

If you cannot wait, download a nightly build. Otherwise, use command-line batch transcoding below.

== Command Lines ==
=== Windows ===
For example, to transcode a batch of m4a files (potentially in multiple subdirectories of a single common root directory) to mp3 files (512kb/s encoding with 44100 sampling frequency) you could use the following code in a Windows XP command prompt:
<big><big><syntaxhighlight lang="dos">
for %%a in (*.VOB) do "C:\Program Files\VideoLAN\VLC\vlc" -I dummy -vvv %%a --sout=#transcode{vcodec=h264,vb=1024,acodec=mp4a,ab=192,channels=2,deinterlace}:standard{access=file,mux=ts,dst=%%a.mpg} vlc://quit

@ECHO OFF
REM ########################################################################
REM # A Windows XP cmd.com script to batch convert m4a files to mp3. #
REM # #
REM # Copyright (C) 2008 Andrew Boden #
REM # (boden@graduate.uwa.edu.au) #
REM # #
REM # This program is free software: you can redistribute it and/or modify #
REM # it under the terms of the GNU General Public License as published by #
REM # the Free Software Foundation, either version 3 of the License, or #
REM # (at your option) any later version. #
REM # #
REM # This program is distributed in the hope that it will be useful, #
REM # but WITHOUT ANY WARRANTY; without even the implied warranty of #
REM # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the #
REM # GNU General Public License for more details. #
REM # #
REM # You should have received a copy of the GNU General Public License #
REM # along with this program. If not, see <http://www.gnu.org/licenses/>.#
REM # #
REM # Version 1.0 (June 27th 2008) #
REM # Uses VideoLAN VLC 0.8.6h (www.videolan.org) #
REM # Gracefully handles commas and apostrophes in file names. #
REM # Not aware of any other characters needing graceful handling. #
REM # 512kbps encoding with 44100 sampling. #
REM ########################################################################

FOR /R %%G IN (*.m4a) DO (CALL :SUB_VLC "%%G")
FOR /R %%G IN (*.m4a.mp*) DO (CALL :SUB_RENAME "%%G")
GOTO :eof

:SUB_VLC
SET _firstbit=%1
SET _qt="
CALL SET _newnm=%%_firstbit:%_qt%=%%
SET _commanm=%_newnm:,=_COMMA_%
REM echo %_commanm%
CALL "C:\Program Files\VideoLAN\VLC\vlc" -I dummy -vvv %1 --sout=#transcode{acodec="mpga",ab="512","channels=2",samplerate="44100"}:standard{access="file",mux="mpeg1",dst="%_commanm%.mp3"} vlc://quit
GOTO :eof

:SUB_RENAME
SET _origfnm=%1
SET _endbit=%_origfnm:*.m4a=%
CALL SET _newfilenm=%%_origfnm:.m4a%_endbit%=.mp3%%
SET _newfilenm=%_newfilenm:_COMMA_=,%
COPY %1 %_newfilenm%
DEL %1
GOTO :eof

:eof
</syntaxhighlight></big></big>

The same as above, for vlc >= 0.9:
<big><big><syntaxhighlight lang="dos">
@ECHO OFF
FOR /R %%G IN (*.m4a) DO (CALL :SUB_VLC "%%G")
FOR /R %%G IN (*.m4a.mp*) DO (CALL :SUB_RENAME "%%G")
GOTO :eof

:SUB_VLC
SET _firstbit=%1
SET _qt="
CALL SET _newnm=%%_firstbit:%_qt%=%%
SET _commanm=%_newnm:,=_COMMA_%
REM echo %_commanm%
CALL "C:\Program Files\VideoLAN\VLC\vlc" -I dummy -vvv %1 --sout=#transcode{acodec="mpga",ab="512","channels=2"}:standard{access="file",mux="raw",dst="%_commanm%.mp3"} vlc://quit
GOTO :eof

:SUB_RENAME
SET _origfnm=%1
SET _endbit=%_origfnm:*.m4a=%
CALL SET _newfilenm=%%_origfnm:.m4a%_endbit%=.mp3%%
SET _newfilenm=%_newfilenm:_COMMA_=,%
COPY %1 %_newfilenm%
DEL %1
GOTO :eof

:eof
</syntaxhighlight></big></big>

=== Windows 7 SendTo ===
This batch file allows to use the Windows SendTo context menue in Exlorer.
Copy the content in a file named MOV_to_MPG_Converter.bat and copy it to your SendTo directory (CMD SHELL:sendto)
<big><big><syntaxhighlight lang="dos">

@ECHO OFF
rem ***********************************************************************
rem * MOV to MPG batch converter. (2014-09-29 Sinx) *
rem * *
rem * For installation just copy batch file to SendTo directory. *
rem * On Win8 execute "SHELL:sendto" to go to Sendto folder. *
rem * *
rem * I got quite good compression rations with these parameters: *
rem * vcodec=h264 codec used *
rem * vb=10000 video bandwidth *
rem * deinterlace=1 rebuild full pictures from keyframes and diffs. *
rem * acodec=mp3 audio codec *
rem * ab=128 128kbps mp3 quality *
rem * channels=2 stereo *
rem * *
rem * for parameters see *
rem * http://www.videolan.org/doc/vlc-user-guide/de/ch04.html *
rem ***********************************************************************
echo **********************************************************************
echo MOV to MPG VLC batch converter called: %0 %1 %2 %3 %4 %5 %6 %7 %8
echo **********************************************************************
echo.
echo For installation, just copy batch file to SendTo folder..
echo.

SET _new_extention=mpg

:start
if "%~1"=="" (call goto :the_end)
CALL :SUB_CONVERT %1
SHIFT
goto :start

:SUB_CONVERT
SET _orig_path=%~1
rem SET _orig_extention=%_orig_filename:*.=%
echo %_orig_path%
SET _orig_extention=%_orig_path:*.=%
CALL SET _new_path=%%_orig_path%:.%_orig_extention%=.%_new_extention%%%
set _new_path="%_new_path%"
echo.
echo Converting %1 ======TO===== %_new_path% ...
echo.

if exist "%ProgramFiles%\VideoLAN\VLC\vlc.exe" (
SET _vlc_path="%ProgramFiles%\VideoLAN\VLC\vlc"
) else (
SET _vlc_path="%ProgramFiles(x86)%\VideoLAN\VLC\vlc"
)

CALL %_vlc_path% -I dummy -vvv %1 --sout=#transcode{vcodec=h264,vb=10000,deinterlace=1,acodec=mp3,ab=128,channels=2,samplerate=44100}:standard{access=file,mux=ts,dst=%_new_path%} vlc://quit
GOTO :eof

:the_end
echo **********************************************************************
echo * FINISHED *
echo **********************************************************************
pause
</syntaxhighlight></big></big>

=== Powershell ===
<big><big><syntaxhighlight lang="powershell">
$outputExtension = ".mp3"
$bitrate = 160
$channels = 2

foreach($inputFile in get-childitem -recurse -Filter *.wav)
{
$outputFileName = [System.IO.Path]::GetFileNameWithoutExtension($inputFile.FullName) + $outputExtension;
$outputFileName = [System.IO.Path]::Combine($inputFile.DirectoryName, $outputFileName);

$programFiles = ${env:ProgramFiles(x86)};
if($programFiles -eq $null) { $programFiles = $env:ProgramFiles; }

$processName = $programFiles + "\VideoLAN\VLC\vlc.exe"
$processArgs = "-I dummy -vvv `"$($inputFile.FullName)`" --sout=#transcode{acodec=`"mp3`",ab=`"$bitrate`",`"channels=$channels`"}:standard{access=`"file`",mux=`"wav`",dst=`"$outputFileName`"} vlc://quit"

start-process $processName $processArgs -wait
}
</syntaxhighlight></big></big>

=== Unix / Linux ===
Transcodes all files in current directory (except hidden files), saving with suffix <code>.transcoded</code>.

<syntaxhighlight lang="bash">
#!/bin/sh
######################## Transcode the files using ... ########################
vcodec="mp4v"
acodec="mp4a"
vb="1024"
ab="128"
mux="mp4"
###############################################################################

# Store path to VLC in $vlc
if command -pv vlc >/dev/null 2>&1; then
# Linux should find "vlc" when searching PATH
vlc="vlc"
else
# macOS seems to need an alias
vlc="/Applications/Utilities/VLC.app/Contents/MacOS/VLC"
fi
# Sanity check
if ! command -pv "$vlc" >/dev/null 2>&1; then
printf '%s\n' "Cannot find path to VLC. Abort." >&2
exit 1
fi

for filename in *; do
printf '%s\n' "=> Transcoding '$filename'... "
"$vlc" -I dummy -q "$filename" \
--sout '#transcode{vcodec="$vcodec",vb="$vb",acodec="$acodec",ab="$ab"}:standard{mux="$mux",dst="$filename.transcoded",access=file}' \
vlc://quit
ls -lh "$filename" "$filename.transcoded"
printf '\n'
done
</syntaxhighlight>

The wildcard <code>*.transcoded</code> will select all of the transcoded files for group operations.

To move files:
<syntaxhighlight lang="bash">
mv *.transcoded <directory>
</syntaxhighlight>
To remove all filename extensions (including <code>.transcoded</code>):
<syntaxhighlight lang="bash">
for filename in *.transcoded; do mv "$filename" "${filename%%.*}"; done
</syntaxhighlight>
To remove all filename extensions and replace with another (e.g. <code>.mp3</code>):
<syntaxhighlight lang="bash">
for filename in *.transcoded; do mv "$filename" "${filename%%.*}.mp3"; done
</syntaxhighlight>

VLC HowTo/Transcode multiple videos

2019-06-09T06:04:57Z

DoesItReallyMatter: /* Unix / Linux */ Simplify. Extensions are not used on Linux by convention, and can be done easily after transcoding

{{Howto|batch transcode or encode}}
{{Example code|l=GPL}}

== Idea ==
The idea is to use VLC to do some batch work to encode or transcode multiple files one after each other, without having to care about it.

You may want to transcode all your videotheque to another format to play them on an [[IPod]], a [[Play on Zune|Zune]], a PS3 or a [[Play on Xbox|Xbox]].

== Codecs / Muxers ==
You have to choose the correct codecs for the device you want to transcode for.

We choose here [[H.264]] with [[AAC]] in a [[MPEG-2#TS|MPEG-2/TS]] muxer as an example.

== GUI ==
Batch convert is supported via the {{GUI}} in VLC 3.0.0

If you cannot wait, download a nightly build. Otherwise, use command-line batch transcoding below.

== Command Lines ==
=== Windows ===
For example, to transcode a batch of m4a files (potentially in multiple subdirectories of a single common root directory) to mp3 files (512kb/s encoding with 44100 sampling frequency) you could use the following code in a Windows XP command prompt:
<big><big><syntaxhighlight lang="dos">
for %%a in (*.VOB) do "C:\Program Files\VideoLAN\VLC\vlc" -I dummy -vvv %%a --sout=#transcode{vcodec=h264,vb=1024,acodec=mp4a,ab=192,channels=2,deinterlace}:standard{access=file,mux=ts,dst=%%a.mpg} vlc://quit

@ECHO OFF
REM ########################################################################
REM # A Windows XP cmd.com script to batch convert m4a files to mp3. #
REM # #
REM # Copyright (C) 2008 Andrew Boden #
REM # (boden@graduate.uwa.edu.au) #
REM # #
REM # This program is free software: you can redistribute it and/or modify #
REM # it under the terms of the GNU General Public License as published by #
REM # the Free Software Foundation, either version 3 of the License, or #
REM # (at your option) any later version. #
REM # #
REM # This program is distributed in the hope that it will be useful, #
REM # but WITHOUT ANY WARRANTY; without even the implied warranty of #
REM # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the #
REM # GNU General Public License for more details. #
REM # #
REM # You should have received a copy of the GNU General Public License #
REM # along with this program. If not, see <http://www.gnu.org/licenses/>.#
REM # #
REM # Version 1.0 (June 27th 2008) #
REM # Uses VideoLAN VLC 0.8.6h (www.videolan.org) #
REM # Gracefully handles commas and apostrophes in file names. #
REM # Not aware of any other characters needing graceful handling. #
REM # 512kbps encoding with 44100 sampling. #
REM ########################################################################

FOR /R %%G IN (*.m4a) DO (CALL :SUB_VLC "%%G")
FOR /R %%G IN (*.m4a.mp*) DO (CALL :SUB_RENAME "%%G")
GOTO :eof

:SUB_VLC
SET _firstbit=%1
SET _qt="
CALL SET _newnm=%%_firstbit:%_qt%=%%
SET _commanm=%_newnm:,=_COMMA_%
REM echo %_commanm%
CALL "C:\Program Files\VideoLAN\VLC\vlc" -I dummy -vvv %1 --sout=#transcode{acodec="mpga",ab="512","channels=2",samplerate="44100"}:standard{access="file",mux="mpeg1",dst="%_commanm%.mp3"} vlc://quit
GOTO :eof

:SUB_RENAME
SET _origfnm=%1
SET _endbit=%_origfnm:*.m4a=%
CALL SET _newfilenm=%%_origfnm:.m4a%_endbit%=.mp3%%
SET _newfilenm=%_newfilenm:_COMMA_=,%
COPY %1 %_newfilenm%
DEL %1
GOTO :eof

:eof
</syntaxhighlight></big></big>

The same as above, for vlc >= 0.9:
<big><big><syntaxhighlight lang="dos">
@ECHO OFF
FOR /R %%G IN (*.m4a) DO (CALL :SUB_VLC "%%G")
FOR /R %%G IN (*.m4a.mp*) DO (CALL :SUB_RENAME "%%G")
GOTO :eof

:SUB_VLC
SET _firstbit=%1
SET _qt="
CALL SET _newnm=%%_firstbit:%_qt%=%%
SET _commanm=%_newnm:,=_COMMA_%
REM echo %_commanm%
CALL "C:\Program Files\VideoLAN\VLC\vlc" -I dummy -vvv %1 --sout=#transcode{acodec="mpga",ab="512","channels=2"}:standard{access="file",mux="raw",dst="%_commanm%.mp3"} vlc://quit
GOTO :eof

:SUB_RENAME
SET _origfnm=%1
SET _endbit=%_origfnm:*.m4a=%
CALL SET _newfilenm=%%_origfnm:.m4a%_endbit%=.mp3%%
SET _newfilenm=%_newfilenm:_COMMA_=,%
COPY %1 %_newfilenm%
DEL %1
GOTO :eof

:eof
</syntaxhighlight></big></big>

=== Windows 7 SendTo ===
This batch file allows to use the Windows SendTo context menue in Exlorer.
Copy the content in a file named MOV_to_MPG_Converter.bat and copy it to your SendTo directory (CMD SHELL:sendto)
<big><big><syntaxhighlight lang="dos">

@ECHO OFF
rem ***********************************************************************
rem * MOV to MPG batch converter. (2014-09-29 Sinx) *
rem * *
rem * For installation just copy batch file to SendTo directory. *
rem * On Win8 execute "SHELL:sendto" to go to Sendto folder. *
rem * *
rem * I got quite good compression rations with these parameters: *
rem * vcodec=h264 codec used *
rem * vb=10000 video bandwidth *
rem * deinterlace=1 rebuild full pictures from keyframes and diffs. *
rem * acodec=mp3 audio codec *
rem * ab=128 128kbps mp3 quality *
rem * channels=2 stereo *
rem * *
rem * for parameters see *
rem * http://www.videolan.org/doc/vlc-user-guide/de/ch04.html *
rem ***********************************************************************
echo **********************************************************************
echo MOV to MPG VLC batch converter called: %0 %1 %2 %3 %4 %5 %6 %7 %8
echo **********************************************************************
echo.
echo For installation, just copy batch file to SendTo folder..
echo.

SET _new_extention=mpg

:start
if "%~1"=="" (call goto :the_end)
CALL :SUB_CONVERT %1
SHIFT
goto :start

:SUB_CONVERT
SET _orig_path=%~1
rem SET _orig_extention=%_orig_filename:*.=%
echo %_orig_path%
SET _orig_extention=%_orig_path:*.=%
CALL SET _new_path=%%_orig_path%:.%_orig_extention%=.%_new_extention%%%
set _new_path="%_new_path%"
echo.
echo Converting %1 ======TO===== %_new_path% ...
echo.

if exist "%ProgramFiles%\VideoLAN\VLC\vlc.exe" (
SET _vlc_path="%ProgramFiles%\VideoLAN\VLC\vlc"
) else (
SET _vlc_path="%ProgramFiles(x86)%\VideoLAN\VLC\vlc"
)

CALL %_vlc_path% -I dummy -vvv %1 --sout=#transcode{vcodec=h264,vb=10000,deinterlace=1,acodec=mp3,ab=128,channels=2,samplerate=44100}:standard{access=file,mux=ts,dst=%_new_path%} vlc://quit
GOTO :eof

:the_end
echo **********************************************************************
echo * FINISHED *
echo **********************************************************************
pause
</syntaxhighlight></big></big>

=== Powershell ===
<big><big><syntaxhighlight lang="powershell">
$outputExtension = ".mp3"
$bitrate = 160
$channels = 2

foreach($inputFile in get-childitem -recurse -Filter *.wav)
{
$outputFileName = [System.IO.Path]::GetFileNameWithoutExtension($inputFile.FullName) + $outputExtension;
$outputFileName = [System.IO.Path]::Combine($inputFile.DirectoryName, $outputFileName);

$programFiles = ${env:ProgramFiles(x86)};
if($programFiles -eq $null) { $programFiles = $env:ProgramFiles; }

$processName = $programFiles + "\VideoLAN\VLC\vlc.exe"
$processArgs = "-I dummy -vvv `"$($inputFile.FullName)`" --sout=#transcode{acodec=`"mp3`",ab=`"$bitrate`",`"channels=$channels`"}:standard{access=`"file`",mux=`"wav`",dst=`"$outputFileName`"} vlc://quit"

start-process $processName $processArgs -wait
}
</syntaxhighlight></big></big>

=== Unix / Linux ===
This can take one file (file.flv), or a wildcard (*.flv). Also supports path with spaces.

<big><big><syntaxhighlight lang="bash">
#!/bin/sh

vcodec="mp4v"
acodec="mp4a"
bitrate="1024"
arate="128"
mux="mp4"

# For Linux
vlc="/usr/bin/vlc"
# For OSX
#vlc="/Applications/Utilities/VLC.app/Contents/MacOS/VLC"

if [ ! -e "$vlc" ]; then
printf '%s\n' "Command '$vlc' does not exist" >&2
exit 1
fi

for filename in "$@"; do
printf '%s\n' "=> Transcoding '$filename'... "

"$vlc" -I dummy -q "$filename" \
--sout '#transcode{vcodec=mp4v,vb=1024,acodec=mp4a,ab=128}:standard{mux=mp4,dst="$filename.transcoded",access=file}' \
vlc://quit
ls -lh "$filename" "$filename.transcoded"
printf '\n'
done
</syntaxhighlight></big></big>

To convert filename extensions after (e.g. from <code>.old</code> to <code>.new</code>):
<syntaxhighlight lang="bash">
for filename in *.old; do mv "$filename" "${filename%.old}.new"; done
</syntaxhighlight>

VLC HowTo/Transcode multiple videos

2019-06-09T04:43:03Z

DoesItReallyMatter: /* Unix / Linux */ Edit example code for security/efficiency: "file" is reserved, use "$(...)" over `...`, quotes, stderr, printf over echo. Feel free to proof me

{{Howto|batch transcode or encode}}
{{Example code|l=GPL}}

== Idea ==
The idea is to use VLC to do some batch work to encode or transcode multiple files one after each other, without having to care about it.

You may want to transcode all your videotheque to another format to play them on an [[IPod]], a [[Play on Zune|Zune]], a PS3 or a [[Play on Xbox|Xbox]].

== Codecs / Muxers ==
You have to choose the correct codecs for the device you want to transcode for.

We choose here [[H.264]] with [[AAC]] in a [[MPEG-2#TS|MPEG-2/TS]] muxer as an example.

== GUI ==
Batch convert is supported via the {{GUI}} in VLC 3.0.0

If you cannot wait, download a nightly build. Otherwise, use command-line batch transcoding below.

== Command Lines ==
=== Windows ===
For example, to transcode a batch of m4a files (potentially in multiple subdirectories of a single common root directory) to mp3 files (512kb/s encoding with 44100 sampling frequency) you could use the following code in a Windows XP command prompt:
<big><big><syntaxhighlight lang="dos">
for %%a in (*.VOB) do "C:\Program Files\VideoLAN\VLC\vlc" -I dummy -vvv %%a --sout=#transcode{vcodec=h264,vb=1024,acodec=mp4a,ab=192,channels=2,deinterlace}:standard{access=file,mux=ts,dst=%%a.mpg} vlc://quit

@ECHO OFF
REM ########################################################################
REM # A Windows XP cmd.com script to batch convert m4a files to mp3. #
REM # #
REM # Copyright (C) 2008 Andrew Boden #
REM # (boden@graduate.uwa.edu.au) #
REM # #
REM # This program is free software: you can redistribute it and/or modify #
REM # it under the terms of the GNU General Public License as published by #
REM # the Free Software Foundation, either version 3 of the License, or #
REM # (at your option) any later version. #
REM # #
REM # This program is distributed in the hope that it will be useful, #
REM # but WITHOUT ANY WARRANTY; without even the implied warranty of #
REM # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the #
REM # GNU General Public License for more details. #
REM # #
REM # You should have received a copy of the GNU General Public License #
REM # along with this program. If not, see <http://www.gnu.org/licenses/>.#
REM # #
REM # Version 1.0 (June 27th 2008) #
REM # Uses VideoLAN VLC 0.8.6h (www.videolan.org) #
REM # Gracefully handles commas and apostrophes in file names. #
REM # Not aware of any other characters needing graceful handling. #
REM # 512kbps encoding with 44100 sampling. #
REM ########################################################################

FOR /R %%G IN (*.m4a) DO (CALL :SUB_VLC "%%G")
FOR /R %%G IN (*.m4a.mp*) DO (CALL :SUB_RENAME "%%G")
GOTO :eof

:SUB_VLC
SET _firstbit=%1
SET _qt="
CALL SET _newnm=%%_firstbit:%_qt%=%%
SET _commanm=%_newnm:,=_COMMA_%
REM echo %_commanm%
CALL "C:\Program Files\VideoLAN\VLC\vlc" -I dummy -vvv %1 --sout=#transcode{acodec="mpga",ab="512","channels=2",samplerate="44100"}:standard{access="file",mux="mpeg1",dst="%_commanm%.mp3"} vlc://quit
GOTO :eof

:SUB_RENAME
SET _origfnm=%1
SET _endbit=%_origfnm:*.m4a=%
CALL SET _newfilenm=%%_origfnm:.m4a%_endbit%=.mp3%%
SET _newfilenm=%_newfilenm:_COMMA_=,%
COPY %1 %_newfilenm%
DEL %1
GOTO :eof

:eof
</syntaxhighlight></big></big>

The same as above, for vlc >= 0.9:
<big><big><syntaxhighlight lang="dos">
@ECHO OFF
FOR /R %%G IN (*.m4a) DO (CALL :SUB_VLC "%%G")
FOR /R %%G IN (*.m4a.mp*) DO (CALL :SUB_RENAME "%%G")
GOTO :eof

:SUB_VLC
SET _firstbit=%1
SET _qt="
CALL SET _newnm=%%_firstbit:%_qt%=%%
SET _commanm=%_newnm:,=_COMMA_%
REM echo %_commanm%
CALL "C:\Program Files\VideoLAN\VLC\vlc" -I dummy -vvv %1 --sout=#transcode{acodec="mpga",ab="512","channels=2"}:standard{access="file",mux="raw",dst="%_commanm%.mp3"} vlc://quit
GOTO :eof

:SUB_RENAME
SET _origfnm=%1
SET _endbit=%_origfnm:*.m4a=%
CALL SET _newfilenm=%%_origfnm:.m4a%_endbit%=.mp3%%
SET _newfilenm=%_newfilenm:_COMMA_=,%
COPY %1 %_newfilenm%
DEL %1
GOTO :eof

:eof
</syntaxhighlight></big></big>

=== Windows 7 SendTo ===
This batch file allows to use the Windows SendTo context menue in Exlorer.
Copy the content in a file named MOV_to_MPG_Converter.bat and copy it to your SendTo directory (CMD SHELL:sendto)
<big><big><syntaxhighlight lang="dos">

@ECHO OFF
rem ***********************************************************************
rem * MOV to MPG batch converter. (2014-09-29 Sinx) *
rem * *
rem * For installation just copy batch file to SendTo directory. *
rem * On Win8 execute "SHELL:sendto" to go to Sendto folder. *
rem * *
rem * I got quite good compression rations with these parameters: *
rem * vcodec=h264 codec used *
rem * vb=10000 video bandwidth *
rem * deinterlace=1 rebuild full pictures from keyframes and diffs. *
rem * acodec=mp3 audio codec *
rem * ab=128 128kbps mp3 quality *
rem * channels=2 stereo *
rem * *
rem * for parameters see *
rem * http://www.videolan.org/doc/vlc-user-guide/de/ch04.html *
rem ***********************************************************************
echo **********************************************************************
echo MOV to MPG VLC batch converter called: %0 %1 %2 %3 %4 %5 %6 %7 %8
echo **********************************************************************
echo.
echo For installation, just copy batch file to SendTo folder..
echo.

SET _new_extention=mpg

:start
if "%~1"=="" (call goto :the_end)
CALL :SUB_CONVERT %1
SHIFT
goto :start

:SUB_CONVERT
SET _orig_path=%~1
rem SET _orig_extention=%_orig_filename:*.=%
echo %_orig_path%
SET _orig_extention=%_orig_path:*.=%
CALL SET _new_path=%%_orig_path%:.%_orig_extention%=.%_new_extention%%%
set _new_path="%_new_path%"
echo.
echo Converting %1 ======TO===== %_new_path% ...
echo.

if exist "%ProgramFiles%\VideoLAN\VLC\vlc.exe" (
SET _vlc_path="%ProgramFiles%\VideoLAN\VLC\vlc"
) else (
SET _vlc_path="%ProgramFiles(x86)%\VideoLAN\VLC\vlc"
)

CALL %_vlc_path% -I dummy -vvv %1 --sout=#transcode{vcodec=h264,vb=10000,deinterlace=1,acodec=mp3,ab=128,channels=2,samplerate=44100}:standard{access=file,mux=ts,dst=%_new_path%} vlc://quit
GOTO :eof

:the_end
echo **********************************************************************
echo * FINISHED *
echo **********************************************************************
pause
</syntaxhighlight></big></big>

=== Powershell ===
<big><big><syntaxhighlight lang="powershell">
$outputExtension = ".mp3"
$bitrate = 160
$channels = 2

foreach($inputFile in get-childitem -recurse -Filter *.wav)
{
$outputFileName = [System.IO.Path]::GetFileNameWithoutExtension($inputFile.FullName) + $outputExtension;
$outputFileName = [System.IO.Path]::Combine($inputFile.DirectoryName, $outputFileName);

$programFiles = ${env:ProgramFiles(x86)};
if($programFiles -eq $null) { $programFiles = $env:ProgramFiles; }

$processName = $programFiles + "\VideoLAN\VLC\vlc.exe"
$processArgs = "-I dummy -vvv `"$($inputFile.FullName)`" --sout=#transcode{acodec=`"mp3`",ab=`"$bitrate`",`"channels=$channels`"}:standard{access=`"file`",mux=`"wav`",dst=`"$outputFileName`"} vlc://quit"

start-process $processName $processArgs -wait
}
</syntaxhighlight></big></big>

=== Unix / Linux ===
This can take one file (file.flv), or a wildcard (*.flv). Also supports path with spaces.

<big><big><syntaxhighlight lang="bash">
#!/bin/sh

vcodec="mp4v"
acodec="mp4a"
bitrate="1024"
arate="128"
mux="mp4"

# For Linux
vlc="/usr/bin/vlc"
# For OSX
#vlc="/Applications/Utilities/VLC.app/Contents/MacOS/VLC"

if [ ! -e "$vlc" ]; then
printf '%s\n' "Command '$vlc' does not exist" >&2
exit 1
fi

for filename in "$@"; do
printf '%s\n' "=> Transcoding '$filename'... "

dst="$(dirname "$filename")"
new="$(basename "$filename" | sed 's@\.[a-z][a-z][a-z]$@@').$mux"

"$vlc" -I dummy -q "$filename" \
--sout "#transcode{vcodec=mp4v,vb=1024,acodec=mp4a,ab=128}:standard{mux=mp4,dst=\"$dst/$new\",access=file}" \
vlc://quit
ls -lh "$filename" "$dst/$new"
printf '\n'
done
</syntaxhighlight></big></big>

VLC HowTo/Transcode multiple videos

2019-06-09T04:28:01Z

DoesItReallyMatter: Move prose out of source code

{{Howto|batch transcode or encode}}
{{Example code|l=GPL}}

== Idea ==
The idea is to use VLC to do some batch work to encode or transcode multiple files one after each other, without having to care about it.

You may want to transcode all your videotheque to another format to play them on an [[IPod]], a [[Play on Zune|Zune]], a PS3 or a [[Play on Xbox|Xbox]].

== Codecs / Muxers ==
You have to choose the correct codecs for the device you want to transcode for.

We choose here [[H.264]] with [[AAC]] in a [[MPEG-2#TS|MPEG-2/TS]] muxer as an example.

== GUI ==
Batch convert is supported via the {{GUI}} in VLC 3.0.0

If you cannot wait, download a nightly build. Otherwise, use command-line batch transcoding below.

== Command Lines ==
=== Windows ===
For example, to transcode a batch of m4a files (potentially in multiple subdirectories of a single common root directory) to mp3 files (512kb/s encoding with 44100 sampling frequency) you could use the following code in a Windows XP command prompt:
<big><big><syntaxhighlight lang="dos">
for %%a in (*.VOB) do "C:\Program Files\VideoLAN\VLC\vlc" -I dummy -vvv %%a --sout=#transcode{vcodec=h264,vb=1024,acodec=mp4a,ab=192,channels=2,deinterlace}:standard{access=file,mux=ts,dst=%%a.mpg} vlc://quit

@ECHO OFF
REM ########################################################################
REM # A Windows XP cmd.com script to batch convert m4a files to mp3. #
REM # #
REM # Copyright (C) 2008 Andrew Boden #
REM # (boden@graduate.uwa.edu.au) #
REM # #
REM # This program is free software: you can redistribute it and/or modify #
REM # it under the terms of the GNU General Public License as published by #
REM # the Free Software Foundation, either version 3 of the License, or #
REM # (at your option) any later version. #
REM # #
REM # This program is distributed in the hope that it will be useful, #
REM # but WITHOUT ANY WARRANTY; without even the implied warranty of #
REM # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the #
REM # GNU General Public License for more details. #
REM # #
REM # You should have received a copy of the GNU General Public License #
REM # along with this program. If not, see <http://www.gnu.org/licenses/>.#
REM # #
REM # Version 1.0 (June 27th 2008) #
REM # Uses VideoLAN VLC 0.8.6h (www.videolan.org) #
REM # Gracefully handles commas and apostrophes in file names. #
REM # Not aware of any other characters needing graceful handling. #
REM # 512kbps encoding with 44100 sampling. #
REM ########################################################################

FOR /R %%G IN (*.m4a) DO (CALL :SUB_VLC "%%G")
FOR /R %%G IN (*.m4a.mp*) DO (CALL :SUB_RENAME "%%G")
GOTO :eof

:SUB_VLC
SET _firstbit=%1
SET _qt="
CALL SET _newnm=%%_firstbit:%_qt%=%%
SET _commanm=%_newnm:,=_COMMA_%
REM echo %_commanm%
CALL "C:\Program Files\VideoLAN\VLC\vlc" -I dummy -vvv %1 --sout=#transcode{acodec="mpga",ab="512","channels=2",samplerate="44100"}:standard{access="file",mux="mpeg1",dst="%_commanm%.mp3"} vlc://quit
GOTO :eof

:SUB_RENAME
SET _origfnm=%1
SET _endbit=%_origfnm:*.m4a=%
CALL SET _newfilenm=%%_origfnm:.m4a%_endbit%=.mp3%%
SET _newfilenm=%_newfilenm:_COMMA_=,%
COPY %1 %_newfilenm%
DEL %1
GOTO :eof

:eof
</syntaxhighlight></big></big>

The same as above, for vlc >= 0.9:
<big><big><syntaxhighlight lang="dos">
@ECHO OFF
FOR /R %%G IN (*.m4a) DO (CALL :SUB_VLC "%%G")
FOR /R %%G IN (*.m4a.mp*) DO (CALL :SUB_RENAME "%%G")
GOTO :eof

:SUB_VLC
SET _firstbit=%1
SET _qt="
CALL SET _newnm=%%_firstbit:%_qt%=%%
SET _commanm=%_newnm:,=_COMMA_%
REM echo %_commanm%
CALL "C:\Program Files\VideoLAN\VLC\vlc" -I dummy -vvv %1 --sout=#transcode{acodec="mpga",ab="512","channels=2"}:standard{access="file",mux="raw",dst="%_commanm%.mp3"} vlc://quit
GOTO :eof

:SUB_RENAME
SET _origfnm=%1
SET _endbit=%_origfnm:*.m4a=%
CALL SET _newfilenm=%%_origfnm:.m4a%_endbit%=.mp3%%
SET _newfilenm=%_newfilenm:_COMMA_=,%
COPY %1 %_newfilenm%
DEL %1
GOTO :eof

:eof
</syntaxhighlight></big></big>

=== Windows 7 SendTo ===
This batch file allows to use the Windows SendTo context menue in Exlorer.
Copy the content in a file named MOV_to_MPG_Converter.bat and copy it to your SendTo directory (CMD SHELL:sendto)
<big><big><syntaxhighlight lang="dos">

@ECHO OFF
rem ***********************************************************************
rem * MOV to MPG batch converter. (2014-09-29 Sinx) *
rem * *
rem * For installation just copy batch file to SendTo directory. *
rem * On Win8 execute "SHELL:sendto" to go to Sendto folder. *
rem * *
rem * I got quite good compression rations with these parameters: *
rem * vcodec=h264 codec used *
rem * vb=10000 video bandwidth *
rem * deinterlace=1 rebuild full pictures from keyframes and diffs. *
rem * acodec=mp3 audio codec *
rem * ab=128 128kbps mp3 quality *
rem * channels=2 stereo *
rem * *
rem * for parameters see *
rem * http://www.videolan.org/doc/vlc-user-guide/de/ch04.html *
rem ***********************************************************************
echo **********************************************************************
echo MOV to MPG VLC batch converter called: %0 %1 %2 %3 %4 %5 %6 %7 %8
echo **********************************************************************
echo.
echo For installation, just copy batch file to SendTo folder..
echo.

SET _new_extention=mpg

:start
if "%~1"=="" (call goto :the_end)
CALL :SUB_CONVERT %1
SHIFT
goto :start

:SUB_CONVERT
SET _orig_path=%~1
rem SET _orig_extention=%_orig_filename:*.=%
echo %_orig_path%
SET _orig_extention=%_orig_path:*.=%
CALL SET _new_path=%%_orig_path%:.%_orig_extention%=.%_new_extention%%%
set _new_path="%_new_path%"
echo.
echo Converting %1 ======TO===== %_new_path% ...
echo.

if exist "%ProgramFiles%\VideoLAN\VLC\vlc.exe" (
SET _vlc_path="%ProgramFiles%\VideoLAN\VLC\vlc"
) else (
SET _vlc_path="%ProgramFiles(x86)%\VideoLAN\VLC\vlc"
)

CALL %_vlc_path% -I dummy -vvv %1 --sout=#transcode{vcodec=h264,vb=10000,deinterlace=1,acodec=mp3,ab=128,channels=2,samplerate=44100}:standard{access=file,mux=ts,dst=%_new_path%} vlc://quit
GOTO :eof

:the_end
echo **********************************************************************
echo * FINISHED *
echo **********************************************************************
pause
</syntaxhighlight></big></big>

=== Powershell ===
<big><big><syntaxhighlight lang="powershell">
$outputExtension = ".mp3"
$bitrate = 160
$channels = 2

foreach($inputFile in get-childitem -recurse -Filter *.wav)
{
$outputFileName = [System.IO.Path]::GetFileNameWithoutExtension($inputFile.FullName) + $outputExtension;
$outputFileName = [System.IO.Path]::Combine($inputFile.DirectoryName, $outputFileName);

$programFiles = ${env:ProgramFiles(x86)};
if($programFiles -eq $null) { $programFiles = $env:ProgramFiles; }

$processName = $programFiles + "\VideoLAN\VLC\vlc.exe"
$processArgs = "-I dummy -vvv `"$($inputFile.FullName)`" --sout=#transcode{acodec=`"mp3`",ab=`"$bitrate`",`"channels=$channels`"}:standard{access=`"file`",mux=`"wav`",dst=`"$outputFileName`"} vlc://quit"

start-process $processName $processArgs -wait
}
</syntaxhighlight></big></big>

=== Unix / Linux ===
This can take one file (file.flv), or a wildcard (*.flv). Also supports path with spaces.

<big><big><syntaxhighlight lang="bash">
#!/bin/sh

vcodec="mp4v"
acodec="mp4a"
bitrate="1024"
arate="128"
mux="mp4"

# For Linux
vlc="/usr/bin/vlc"
# For OSX
#vlc="/Applications/Utilities/VLC.app/Contents/MacOS/VLC"

if [ ! -e "$vlc" ]; then
echo "Command '$vlc' does not exist"
exit 1
fi

for file in "$@"; do
echo "=> Transcoding '$file'... "

dst=`dirname "$file"`
new=`basename "$file" | sed 's@\.[a-z][a-z][a-z]$@@'`.$mux

$vlc -I dummy -q "$file" \
--sout "#transcode{vcodec=mp4v,vb=1024,acodec=mp4a,ab=128}:standard{mux=mp4,dst=\"$dst/$new\",access=file}" \
vlc://quit
ls -lh "$file" "$dst/$new"
echo
done
</syntaxhighlight></big></big>

VLC HowTo/Extract audio from a file

2019-06-09T04:24:38Z

DoesItReallyMatter: Add wikilink VLC HowTo/Transcode multiple videos

{{Howto|extract audio from a video}}
The following example shows how to extract audio (<code>file.mp3</code>) from a working video file (<code>file.ts</code>) via [[command-line]]:
vlc file.ts --no-sout-video --sout '#std{mux=raw,dst=file.mp3}'

The following example will prevent the GUI from appearing and converts the audio to .wav:

vlc -I dummy --sout "#transcode{acodec=s16l,channels=2}:std{access=file,mux=wav,dst=OUTFILE.wav}" INFILE.mp4 vlc://quit

With this, you can [[VLC HowTo/Transcode multiple videos|build scripts to mass-convert multiple files]], for example in Bash (Linux, Mac OS X) to convert all files ending in lowercase "mp4" you would use:

for i in *mp4; do vlc -I dummy --sout "#transcode{acodec=s16l,channels=2}:std{access=file,mux=wav,dst=$i.wav}" "$i" vlc://quit; done

==See also==
* article ''[[Extract audio]]''

VLC HowTo/Extract audio from a file

2019-06-09T04:20:50Z

DoesItReallyMatter: Fix Bash example: unquoted variables fail when filenames include spaces

{{Howto|extract audio from a video}}
The following example shows how to extract audio (<code>file.mp3</code>) from a working video file (<code>file.ts</code>) via [[command-line]]:
vlc file.ts --no-sout-video --sout '#std{mux=raw,dst=file.mp3}'

The following example will prevent the GUI from appearing and converts the audio to .wav:

vlc -I dummy --sout "#transcode{acodec=s16l,channels=2}:std{access=file,mux=wav,dst=OUTFILE.wav}" INFILE.mp4 vlc://quit

With this, you can build scripts to mass-convert multiple files, for example in Bash (Linux, Mac OS X) to convert all files ending in lowercase "mp4" you would use:

for i in *mp4; do vlc -I dummy --sout "#transcode{acodec=s16l,channels=2}:std{access=file,mux=wav,dst=$i.wav}" "$i" vlc://quit; done

==See also==
* article ''[[Extract audio]]''

VLC HowTo/Extract audio from a file

2019-06-09T04:16:53Z

DoesItReallyMatter: Show Template:Howto, c/e lead

{{Howto|extract audio from a video}}
The following example shows how to extract audio (<code>file.mp3</code>) from a working video file (<code>file.ts</code>) via [[command-line]]:
vlc file.ts --no-sout-video --sout '#std{mux=raw,dst=file.mp3}'

The following example will prevent the GUI from appearing and converts the audio to .wav:

vlc -I dummy --sout "#transcode{acodec=s16l,channels=2}:std{access=file,mux=wav,dst=OUTFILE.wav}" INFILE.mp4 vlc://quit

With this, you can build scripts to mass-convert multiple files, for example in Bash (Linux, Mac OS X) to convert all files ending in lowercase "mp4" you would use:

for i in *mp4; do vlc -I dummy --sout "#transcode{acodec=s16l,channels=2}:std{access=file,mux=wav,dst=$i.wav}" $i vlc://quit; done

==See also==
* article ''[[Extract audio]]''

VLC HowTo/Hardware acceleration

2019-06-09T04:09:41Z

DoesItReallyMatter: Show Template:Howto, c/e lead

{{howto|adjust [[hardware acceleration]] settings}}
This is a simpler guide than the page [[VLC GPU Decoding]], with fewer steps.

From the menu toolbar select '''Tools''' → '''Preferences''' → '''Input & Codecs''' → '''Codecs''' → '''Hardware-accelerated decoding'''. To disable, select '''Disable'''. To re-enable, select '''Automatic''' (unless a particular hardware acceleration method is desired).

Remember to press '''Save''' to save VLC settings and restart VLC after that to make sure changes are enabled.

{{VSG}}

Template:Howto

2019-06-09T04:03:02Z

DoesItReallyMatter: Copy-edit, humour

{{#if:{{{1<includeonly>|</includeonly>}}}
| {{{!}} class="widebox center cellpadding-3px" style="border-spacing:2px;"
{{!}}style="text-align: left;"{{!}}This page describes ''how to {{lcfirst:{{{1<noinclude>|do something</noinclude>}}}}}''.
{{!}}class="nowrap" style="text-align: right;"{{!}}[[VLC HowTo{{!}}Other "how to" pages]]
{{!}}}
}}
{{#switch:{{{nosort}}}|yes|y = |#default = <includeonly>{{DEFAULTSORT:{{#titleparts:{{FULLPAGENAME}}|1|2}}|noerror}}</includeonly>}}
{{#switch:{{{nocat}}}|yes|y = |#default = [[Category:How To]]}}<noinclude>
== Usage ==
Calling the template currently:
# Adds page to [[:Category:How To]]
# Sorts page under correct title, rather than <code>V</code> for <del>Vendetta</del> <code>VLC HowTo</code>
# Displays a message '''(optional)'''
#* <code>{{{{PAGENAME}}<nowiki>}}</nowiki></code> no banner
#* <code>{{{{PAGENAME}}<nowiki>|play music with VLC}}</nowiki></code> banner: <samp>This page describes ''how to play music with VLC''.</samp>

[[Category:How To|*]]
[[Category:Templates]]
</noinclude>

Template:Howto

2019-06-09T03:52:01Z

DoesItReallyMatter: Removed feature: {{Howto|silent=yes}} no longer works (should be handled entirely with first unnamed parameter). Manual revert of revision 31711, adapted

{{#if:{{{1<includeonly>|</includeonly>}}}
| {{{!}} class="widebox center cellpadding-3px" style="border-spacing:2px;"
{{!}}style="text-align: left;"{{!}}This page describes ''how to {{lcfirst:{{{1<noinclude>|do something</noinclude>}}}}}''.
{{!}}class="nowrap" style="text-align: right;"{{!}}[[VLC HowTo{{!}}Other "how to" pages]]
{{!}}}
}}
{{#switch:{{{nosort}}}|yes|y = |#default = <includeonly>{{DEFAULTSORT:{{#titleparts:{{FULLPAGENAME}}|1|2}}|noerror}}</includeonly>}}
{{#switch:{{{nocat}}}|yes|y = |#default = [[Category:How To]]}}<noinclude>
== Usage ==
Calling the template currently:
# Auto-categorises pages to be members of [[:Category:How To]]
# Corrects the sortkey: telling the system that [[VLC HowTo/Adjust audio delay]] ought to be filed as "'''A'''djust audio delay" (A) and not "'''V'''LC HowTo/Adjust audio delay" (V).
# Displays a message '''(optional)'''
#* {{<nowiki />howto|play music with VLC}}) will show <samp>This page describes ''how to play music with VLC''</samp>.
#* {{<nowiki />howto}} will suppress the message altogether—however, the template still auto-categorises and auto-sorts.

[[Category:How To|*]]
[[Category:Templates]]
</noinclude>

Template:Howto

2019-06-09T03:30:23Z

DoesItReallyMatter: Code-correct (see Wikipedia:HiddenStructure) but ugly

{{#switch:{{{silent}}}
|yes
|y =
|#default =
{{{!}} class="widebox center cellpadding-3px" style="border-spacing:2px;"
{{!}}style="text-align: left;"{{!}}This page describes ''how to {{lcfirst:{{{1}}}}}''.
{{!}}class="nowrap" style="text-align: right;"{{!}}[[VLC HowTo{{!}}Other "how to" pages]]
{{!}}}
}}
{{#switch:{{{nosort}}}|yes|y = |#default = <includeonly>{{DEFAULTSORT:{{#titleparts:{{FULLPAGENAME}}|1|2}}|noerror}}</includeonly>}}
{{#switch:{{{nocat}}}|yes|y = |#default = [[Category:How To]]}}<noinclude>
== Usage ==
Calling the template currently:
# Auto-categorises pages to be members of [[:Category:How To]]
# Corrects the sortkey: telling the system that [[VLC HowTo/Adjust audio delay]] ought to be filed as "'''A'''djust audio delay" (A) and not "'''V'''LC HowTo/Adjust audio delay" (V).
# Displays a message '''(optional)'''
#* {{<nowiki />howto|do something}}) will show a message will be shown similar to the above.
#* {{<nowiki />howto|silent=yes}} will suppress the message altogether—however, the template still auto-categorises and auto-sorts.

[[Category:How To|*]]
[[Category:Templates]]
</noinclude>

Template:Howto

2019-06-09T03:19:14Z

DoesItReallyMatter: Simplify CSS

{| class="widebox {{#switch:{{{silent}}}|yes|y = hiddenStructure}} center cellpadding-3px" style="border-spacing:2px;"
|style="text-align: left;"|This page describes ''how to {{lcfirst:{{{1}}}}}''.
|class="nowrap" style="text-align: right;"|[[VLC HowTo|Other "how to" pages]]
|}
{{#switch:{{{nosort}}}|yes|y = |#default = <includeonly>{{DEFAULTSORT:{{#titleparts:{{FULLPAGENAME}}|1|2}}|noerror}}</includeonly>}}
{{#switch:{{{nocat}}}|yes|y = |#default = [[Category:How To]]}}<noinclude>
== Usage ==
Calling the template currently:
# Auto-categorises pages to be members of [[:Category:How To]]
# Corrects the sortkey: telling the system that [[VLC HowTo/Adjust audio delay]] ought to be filed as "'''A'''djust audio delay" (A) and not "'''V'''LC HowTo/Adjust audio delay" (V).
# Displays a message '''(optional)'''
#* {{<nowiki />howto|do something}}) will show a message will be shown similar to the above.
#* {{<nowiki />howto|silent=yes}} will suppress the message altogether—however, the template still auto-categorises and auto-sorts.

[[Category:How To|*]]
[[Category:Templates]]
</noinclude>

Template:GSoC

2019-06-09T02:49:26Z

DoesItReallyMatter: Add orphaned page: SOCIS x264 2011

{{Navbox|title=[[VideoLAN]] [[Google Summer of Code]] (GSoC/SoC) mentoring projects|-->|list1=[[SoC 2007|2007]] • [[SoC 2008|2008]] • [[SoC 2009|2009]] • [[SoC 2010|2010]] • [[SoC 2011|2011]] • [[GCodeIn 2011| GCi 2011]] • [[SOCIS x264 2011]] • <s>[[SoC 2012|2012]]</s> • <s>[[SoC 2013|2013]]</s> • [[SoC 2016|2016]] • [[SoC 2017|2017]] • [[SoC 2018|2018]] • [[SoC 2019|2019]]}}<noinclude>
Navigational template for GSoC projects

[[Category:Footer templates]]
[[Category:Navigation templates]]
[[Category:SoC|*]]
</noinclude>

Documentation:Modules/clone

2019-06-02T09:22:18Z

DoesItReallyMatter: /* Examples */ Fix last

{{Module|name=clone|type=Video output splitter|description=Clone the video output window|sc=clone}}

You can use this module to play the video in more than one window to test different video outputs or display the same video on multiple screens on the same computer.

== Options ==
<onlyinclude>{{Option
|name=clone-count
|value=integer
|default=2
|description=Number of video windows in which to clone the video.
}}
{{Option
|name=clone-vout-list
|value=string
|default=""
|description=You can use specific video output modules for the clones. Use a comma-separated list of modules.
}}</onlyinclude>

== Examples ==
{{$}} vlc --video-splitter=clone --clone-count=2 video.ogv

== Source code ==
* {{VLCSourceFile|modules/video_splitter/clone.c}}

{{Documentation footer}}

Documentation:Modules/clone

2019-06-02T09:21:48Z

DoesItReallyMatter: Update/expand

{{Module|name=clone|type=Video output splitter|description=Clone the video output window|sc=clone}}

You can use this module to play the video in more than one window to test different video outputs or display the same video on multiple screens on the same computer.

== Options ==
<onlyinclude>{{Option
|name=clone-count
|value=integer
|default=2
|description=Number of video windows in which to clone the video.
}}
{{Option
|name=clone-vout-list
|value=string
|default=""
|description=You can use specific video output modules for the clones. Use a comma-separated list of modules.
}}</onlyinclude>

== Examples ==
{{$}} vlc --video-splitter=clone --clone-count=2

== Source code ==
* {{VLCSourceFile|modules/video_splitter/clone.c}}

{{Documentation footer}}

Documentation:Modules/transform

2019-06-02T09:09:06Z

DoesItReallyMatter: Update/expand

{{Module|name=transform|type=Video output filter|description=Rotate or flip the video|sc=transform}}

== Options ==
<onlyinclude>{{Option
|name=transform-type
|value=string
|select={ "90", "180", "270", "hflip", "vflip", "transpose", "antitranspose" }
|default="90"
|description=Transformation type
}}</onlyinclude>
{{Clear}}

== Examples ==
$ vlc --video-filter='transform{type="vflip"}' somevideo.avi

== Source code ==
* {{VLCSourceFile|modules/video_filter/transform.c}}

{{Documentation footer}}

Documentation:Modules/marq

2019-06-02T07:16:41Z

DoesItReallyMatter: Heavy copy-edit. Noted the [34c0fe95c2e6fc7aade6a4950fd2b3c89c1220f3] change allowing for relative offsets of numbered positions

{{Module|name=marq|type=Video sub-filter|first_version=0.8.0|description=Overlays text on the video|sc=marq|sc2=time}}

The marq sub-filter can be used to display text on a video. The {{docmod|time}} filter was merged with this filter in version 0.9.0, adding time [[Documentation:Format String|format string]] recognition.

There are two methods of specifying position: coordinate and [[#marq-position|numbered positions]]. VLC 0.8.6d and prior only permitted well-formed coordinate pairs, falling back to numbered positions.<br />Since {{Commit|34c0fe95c2e6fc7aade6a4950fd2b3c89c1220f3}} the marq module permits zero, one or two coordinates and zero or one numbered positions, allowing these methods to be intermixed. This means it is easier to e.g. provide a 100-pixel margin between a marquee and the bottom right corner.

== Options ==
<onlyinclude>{{Option
|name=marq-marquee
|value=string
|default=VLC
|description=Marquee text to display.
}}
{{Option
|name=marq-file
|value=string
|default=NULL
|description=File to read the marquee text from.
}}<noinclude>
=== Position ===
</noinclude>
{{Option
|name=marq-x
|value=integer
|default=0
|description=X offset, from the left screen edge.
}}
{{Option
|name=marq-y
|value=integer
|default=0
|description=Y offset, down from the top.
}}
{{Option
|name=marq-position<span id="marq-position"></span>
|value=integer
|default=-1
|description=Marquee position: 0=center, 1=left, 2=right, 4=top, 8=bottom, you can also use combinations of these values, eg 6 = top-right.
}}<noinclude>
=== Font ===
</noinclude>{{Option
|name=marq-opacity
|value=integer
|min=0
|max=255
|default=255
|description=Opacity (inverse of transparency) of overlaid text. 0 {{=}} transparent, 255 {{=}} totally opaque.
}}
{{Option
|name=marq-color<span id="marq-color"></span>
|value=integer
|select={ 0x000000, 0x808080, 0xC0C0C0, 0xFFFFFF, 0x800000, 0xFF0000, 0xFF00FF, 0xFFFF00, 0x808000, 0x008000, 0x008080, 0x00FF00, 0x800080, 0x000080, 0x0000FF, 0x00FFFF }
|default=0xFFFFFF
|description=Color<noinclude><sup>('''[[#appendix_marq-color|key]]''')</sup></noinclude> 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.
}}
{{Option
|name=marq-size
|value=integer
|min=0
|max=4096
|default=0
|description=Font size, in pixels. 0 uses the default font size.
}}<noinclude>
=== Misc ===
</noinclude>{{Option
|name=marq-timeout
|value=integer
|default=0
|description=Number of milliseconds the marquee must remain displayed. 0 means forever.
}}
{{Option
|name=marq-refresh
|value=integer
|default=1000
|description=Number of milliseconds between string updates. This is mainly useful when using meta data or time [[Documentation:Format String|format string]] sequences.
}}</onlyinclude>

== Examples ==

Example command line use '''(VLC 2.0.0 and newer)''':
{{%}} vlc --sub-source="marq{marquee=test,color=0xFFFF00}" somevideo.avi
This example displays yellow ''test'' text in the top left corner of video

=== VLC 0.9.0 - 1.1.13 ===
{{$}} vlc --sub-filter 'marq{marquee=$t ($P%%),color=0xFFFF00}:marq{marquee=%H:%M:%S,position=6}' somevideo.avi
This command line will show the stream's title (<code>$t</code>) and current position (<code>$P</code>) in the upper left corner and the current time in the upper right corner. The <u>''single''</u> quotes <code>'</code> enclose our <code>$</code> characters to prevent them from being interpreted as Bash variables.<br />
On Windows the command line would be:
{{Prompt|cmd}} {{Path to VLC|windows}} --sub-filter=marq{marquee=$t ($P%%),color=0xFFFF00}:marq{marquee=%H:%m%s,position=6} somevideo.avi

=== VLC 0.8.6d and prior ===
{{%}} vlc --sub-filter=marq --marq-marquee="Obvious Watermark" --marq-position=0 --marq-size=50 --marq-opacity=25 --marq-color=0x008000 somevideo.avi
This command will show centered transparent green text. Text sized too large to fit the video window will not appear, and may crash VLC.

=== time ===
The {{docmod|time}} module has different command-lines than the marq module. This not-functional command snippet overlays a white 12-point time display in the lower left of an input stream or video:

'''time:'''
% vlc input_stream --sub-filter=time --time-format %Y-%m-%d,%H:%M:%S --time-position 9 --time-color 0xFFFFFF --time-size 12

'''marq equivalent:'''
% vlc input_stream '--sub-source=marq{marquee="%Y-%m-%d,%H:%M:%S",position=9,color=0xFFFFFF,size=12}'

'''marq equivalent (long form):'''
% vlc input_stream --sub-source=marq --marq-marquee="%Y-%m-%d,%H:%M:%S" --marq-position=9 --marq-color=0xFFFFFF --marq-size=12

'''additional marq example:'''
% vlc input_stream '--sub-source=marq{marquee="%c (Week %V)",color=0xFF0000,opacity=216,size=16,position=4,timeout=500,refresh=1000}'
This overlays a 25%-transparent flashing red 16-point locale-dependent time representation with week number at the top of the input stream or video.

== Gallery ==
<gallery>
File:Marq demonstration - VLC 3.0.6 Linux.png|Marq can be chained, allowing several marquees to be displayed at the same time.|alt=Marq can be chained, allowing several marquees to be displayed at the same time. Nine positions and text colours are shown against a black background.
</gallery>

== See also ==
* [[Documentation:Format String]]
* [[Documentation:Modules/rss]]

== Source code ==
* {{VLCSourceFile|modules/spu/marq.c}}
* {{VLCSourceFile|p=vlc/vlc-0.8.git|modules/video_filter/marq.c}}

== Appendix ==
<div class="plainlist">
*^ [[#marq-color|--marq-color]]<span id="appendix_marq-color"></span>
</div>
{{Colour mapping}}

{{Documentation footer}}

Documentation:Modules/marq

2019-06-02T05:58:53Z

DoesItReallyMatter: Light copy-edit and correct unbalanced double quote

{{Module|name=marq|type=Video sub-filter|first_version=0.8.0|description=Overlays text on the video|sc=marq}}

The marq sub-filter can be used to display text on a video. The {{docmod|time}} filter was merged with this filter in version 0.9.0.

== Options ==
<onlyinclude>{{Option
|name=marq-marquee
|value=string
|default=VLC
|description=Marquee text to display. Since VLC version 0.9.0 you can use [[Documentation:Format String|format strings]] to display time information
}}
{{Option
|name=marq-file
|value=string
|description=File to read the marquee text from
}}
{{Option
|name=marq-x
|value=integer
|default=0 (0.8.6d and prior: -1)
|description=X offset from upper left corner. (0.8.6d and prior: This is only if both marq-x and marq-y are positive)
}}
{{Option
|name=marq-y
|value=integer
|default=0
|description=Y offset from upper left corner. (0.8.6d and prior: This is only if both marq-x and marq-y are positive)
}}
{{Option
|name=marq-position
|value=integer
|default=-1 (formerly 5)
|description=Marquee position: 0=center, 1=left, 2=right, 4=top, 8=bottom, you can also use combinations of these values, eg 6 = top-right. (0.8.6d and prior: This is only used if marq-x or marq-y are negative)
}}
{{Option
|name=marq-opacity
|value=integer
|min=0
|max=255
|default=255
|description=Marquee opacity. 0 is transparent, 255 is fully opaque
}}
{{Option
|name=marq-color<span id="marq-color"></span>
|value=integer
|default=0xFFFFFF
|description=Color<sup>('''[[#appendix_marq-color|key]]''')</sup> 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. Use the decimal value of the HTML color code.
}}
{{Option
|name=marq-size
|value=integer
|min=0
|max=4096
|default=0 (formerly -1)
|description=Font size in pixels. 0 uses the default font size (formerly represented by -1)
}}
{{Option
|name=marq-timeout
|value=integer
|default=0
|description=Number of milliseconds the marquee must remain displayed. 0 means forever
}}
{{Option
|name=marq-refresh
|value=integer
|default=1000
|description=Number of milliseconds between string updates. This is mainly useful when using meta data or time format string sequences
}}</onlyinclude>

== Examples ==

Example command line use '''(VLC 2.0.0 and newer)''':
{{%}} vlc --sub-source="marq{marquee=test,color=0xFFFF00}" somevideo.avi
This example displays yellow ''test'' text in the top left corner of video

Example command line use '''(VLC 0.9.0 - 1.1.13)''':
{{$}} vlc --sub-filter 'marq{marquee=$t ($P%%),color=16776960}:marq{marquee=%H:%M:%S,position=6}' somevideo.avi
This command line will show the stream's title (<code>$t</code>) and current position (<code>$P</code>) in the upper left corner and the current time in the upper right corner. The <u>''single''</u> quotes <code>'</code> enclose our <code>$</code> characters to prevent them from being interpreted as Bash variables.<br />
On windows the command line would be:
C:\Program Files\VideoLAN\VLC>vlc.exe --sub-filter=marq{marquee=$t ($P%%),color=16776960}:marq{marquee=%H:%m%s,position=6} somevideo.avi

Example command line '''(All versions including VLC 0.8.6d and prior)''':
{{%}} vlc --sub-filter=marq --marq-marquee="Obvious Watermark" --marq-position=0 --marq-size=50 --marq-opacity=25 --marq-color=32768 somevideo.avi
This command will show centered transparent green text. Text sized too large to fit the video window will not appear, and may crash VLC.

=== time ===
The {{docmod|time}} module has different command-lines than the marq module. This not-functional command snippet overlays a white 12-point time display in the lower left of an input stream or video:

'''time:'''
% vlc input_stream --sub-filter=time --time-format %Y-%m-%d,%H:%M:%S --time-position 9 --time-color 16777215 --time-size 12

'''marq equivalent:'''
% vlc input_stream '--sub-source=marq{marquee="%Y-%m-%d,%H:%M:%S",position=9,color=0xFFFFFF,size=12}'

'''marq equivalent (long form):'''
% vlc input_stream --sub-source=marq --marq-marquee="%Y-%m-%d,%H:%M:%S" --marq-position=9 --marq-color=0xFFFFFF --marq-size=12

'''additional marq example:'''
% vlc input_stream '--sub-source=marq{marquee="%c (Week %V)",color=0xFF0000,opacity=216,size=16,position=4,timeout=500,refresh=1000}'
This overlays a 25%-transparent flashing red 16-point locale-dependent time representation with week number at the top of the input stream or video.

== Gallery ==
<gallery>
File:Marq demonstration - VLC 3.0.6 Linux.png|Marq can be chained, allowing several marquees to be displayed at the same time.|alt=Marq can be chained, allowing several marquees to be displayed at the same time. Nine positions and text colours are shown against a black background.
</gallery>

== See also ==
* [[Documentation:Format String]]
* [[Documentation:Modules/rss]]

== Source code ==
* {{VLCSourceFile|modules/spu/marq.c}}

== Appendix ==
<div class="plainlist">
*^ [[#marq-color|--marq-color]]<span id="appendix_marq-color"></span>
</div>
{{Colour mapping}}

{{Documentation footer}}

Documentation:Modules/marq

2019-06-02T05:43:30Z

DoesItReallyMatter: /* Examples */ Single quotes for Bash are simpler and safer

{{Module|name=marq|type=Video sub-filter|first_version=0.8.0|description=Overlays text on the video|sc=marq}}

The marq sub-filter can be used to display text on a video. The {{docmod|time}} filter was merged with this filter in version 0.9.0.

== Options ==
<onlyinclude>{{Option
|name=marq-marquee
|value=string
|default=VLC
|description=Marquee text to display. Since VLC version 0.9.0 you can use [[Documentation:Play_HowTo/Format_String|format strings]] to display time information
}}
{{Option
|name=marq-file
|value=string
|description=File to read the marquee text from
}}
{{Option
|name=marq-x
|value=integer
|default=0 (0.8.6d and prior: -1)
|description=X offset from upper left corner. (0.8.6d and prior: This is only if both marq-x and marq-y are positive)
}}
{{Option
|name=marq-y
|value=integer
|default=0
|description=Y offset from upper left corner. (0.8.6d and prior: This is only if both marq-x and marq-y are positive)
}}
{{Option
|name=marq-position
|value=integer
|default=-1 (formerly 5)
|description=Marquee position: 0=center, 1=left, 2=right, 4=top, 8=bottom, you can also use combinations of these values, eg 6 = top-right. (0.8.6d and prior: This is only used if marq-x or marq-y are negative)
}}
{{Option
|name=marq-opacity
|value=integer
|min=0
|max=255
|default=255
|description=Marquee opacity. 0 is transparent, 255 is fully opaque
}}
{{Option
|name=marq-color<span id="marq-color"></span>
|value=integer
|default=0xFFFFFF
|description=Color<sup>('''[[#appendix_marq-color|key]]''')</sup> 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. Use the decimal value of the HTML color code.
}}
{{Option
|name=marq-size
|value=integer
|min=0
|max=4096
|default=0 (formerly -1)
|description=Font size in pixels. 0 uses the default font size (formerly represented by -1)
}}
{{Option
|name=marq-timeout
|value=integer
|default=0
|description=Number of milliseconds the marquee must remain displayed. 0 means forever
}}
{{Option
|name=marq-refresh
|value=integer
|default=1000
|description=Number of milliseconds between string updates. This is mainly useful when using meta data or time format string sequences
}}</onlyinclude>

== Examples ==

Example command line use '''(VLC 2.0.0 and newer)''':
% '''vlc --sub-source="marq{marquee=test,color=16776960} somevideo.avi'''
:This example displays yellow ''test'' text in the top left corner of video

Example command line use '''(VLC 0.9.0 - 1.1.13)''':
{{$}} '''vlc --sub-filter 'marq{marquee=$t ($P%%),color=16776960}:marq{marquee=%H:%M:%S,position=6}' somevideo.avi'''
This command line will show the stream's title (<code>$t</code>) and current position (<code>$P</code>) in the upper left corner and the current time in the upper right corner. The <u>''single''</u> quotes <code>'</code> enclose our <code>$</code> characters to prevent them from being interpreted as Bash variables.
:On windows the command line would be:
C:\Program Files\VideoLAN\VLC\>'''vlc.exe --sub-filter=marq{marquee=$t ($P%%),color=16776960}:marq{marquee=%H:%m%s,position=6} somevideo.avi'''

Example command line '''(All versions including VLC 0.8.6d and prior)''':
% '''vlc --sub-filter=marq --marq-marquee="Obvious Watermark" --marq-position=0 --marq-size=50 --marq-opacity=25 --marq-color=32768 somevideo.avi'''
:This command will show centered transparent green text. Text sized too large to fit the video window will not appear, and may crash VLC.

=== time ===
The {{docmod|time}} module has different command-lines than the marq module. This not-functional command snippet overlays a white 12-point time display in the lower left of an input stream or video:

'''time:'''
% vlc input_stream --sub-filter=time --time-format %Y-%m-%d,%H:%M:%S --time-position 9 --time-color 16777215 --time-size 12

'''marq equivalent:'''
% vlc input_stream '--sub-source=marq{marquee="%Y-%m-%d,%H:%M:%S",position=9,color=16777215,size=12}'

'''marq equivalent (long form):'''
% vlc input_stream --sub-source=marq --marq-marquee="%Y-%m-%d,%H:%M:%S" --marq-position=9 --marq-color=16777215 --marq-size=12

'''additional marq example:'''
% vlc input_stream '--sub-source=marq{marquee="%c (Week %V)",color=16711680,opacity=216,size=16,position=4,timeout=500,refresh=1000}'
This overlays a 25%-transparent flashing red 16-point locale-dependent time representation with week number at the top of the input stream or video.

== Gallery ==
<gallery>
File:Marq demonstration - VLC 3.0.6 Linux.png|Marq can be chained, allowing several marquees to be displayed at the same time.|alt=Marq can be chained, allowing several marquees to be displayed at the same time. Nine positions and text colours are shown against a black background.
</gallery>

== See also ==
* [[Documentation:Format_String]]
* [[Documentation:Modules/rss]]

== Source code ==
* {{VLCSourceFile|modules/spu/marq.c}}

== Appendix ==
<div class="plainlist">
*^ [[#marq-color|--marq-color]]<span id="appendix_marq-color"></span>
</div>
{{Colour mapping}}

{{Documentation footer}}

Documentation:Format Strings

2019-06-02T05:02:24Z

DoesItReallyMatter: Redirected page to Documentation:Format String

#REDIRECT [[Documentation:Format String]]

Documentation:Modules/marq

2019-06-02T05:00:01Z

DoesItReallyMatter: Use Template:Colour mapping, misc.

{{Module|name=marq|type=Video sub-filter|first_version=0.8.0|description=Overlays text on the video|sc=marq}}

The marq sub-filter can be used to display text on a video. The {{docmod|time}} filter was merged with this filter in version 0.9.0.

== Options ==
<onlyinclude>{{Option
|name=marq-marquee
|value=string
|default=VLC
|description=Marquee text to display. Since VLC version 0.9.0 you can use [[Documentation:Play_HowTo/Format_String|format strings]] to display time information
}}
{{Option
|name=marq-file
|value=string
|description=File to read the marquee text from
}}
{{Option
|name=marq-x
|value=integer
|default=0 (0.8.6d and prior: -1)
|description=X offset from upper left corner. (0.8.6d and prior: This is only if both marq-x and marq-y are positive)
}}
{{Option
|name=marq-y
|value=integer
|default=0
|description=Y offset from upper left corner. (0.8.6d and prior: This is only if both marq-x and marq-y are positive)
}}
{{Option
|name=marq-position
|value=integer
|default=-1 (formerly 5)
|description=Marquee position: 0=center, 1=left, 2=right, 4=top, 8=bottom, you can also use combinations of these values, eg 6 = top-right. (0.8.6d and prior: This is only used if marq-x or marq-y are negative)
}}
{{Option
|name=marq-opacity
|value=integer
|min=0
|max=255
|default=255
|description=Marquee opacity. 0 is transparent, 255 is fully opaque
}}
{{Option
|name=marq-color<span id="marq-color"></span>
|value=integer
|default=0xFFFFFF
|description=Color<sup>('''[[#appendix_marq-color|key]]''')</sup> 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. Use the decimal value of the HTML color code.
}}
{{Option
|name=marq-size
|value=integer
|min=0
|max=4096
|default=0 (formerly -1)
|description=Font size in pixels. 0 uses the default font size (formerly represented by -1)
}}
{{Option
|name=marq-timeout
|value=integer
|default=0
|description=Number of milliseconds the marquee must remain displayed. 0 means forever
}}
{{Option
|name=marq-refresh
|value=integer
|default=1000
|description=Number of milliseconds between string updates. This is mainly useful when using meta data or time format string sequences
}}</onlyinclude>

== Examples ==

Example command line use '''(VLC 2.0.0 and newer)''':
% '''vlc --sub-source="marq{marquee=test,color=16776960} somevideo.avi'''
:This example displays yellow ''test'' text in the top left corner of video

Example command line use '''(VLC 0.9.0 - 1.1.13)''':
% '''vlc --sub-filter "marq{marquee=\$t (\$P%%),color=16776960}:marq{marquee=%H:%M:%S,position=6}" somevideo.avi'''
% '''vlc --sub-filter 'marq{marquee=$t ($P%%),color=16776960}:marq{marquee=%H:%M:%S,position=6}' somevideo.avi'''
:This command line will show the stream's title ($t) and current position ($P) in the upper left corner and the current time in the upper right corner. Note that we have to escape $ characters when running this from command line in UNIX shells (this is why we use \$ instead of $). The second line uses single quotes to delimit the string so we don't need to escape the $ character.
:On windows the command line would be:
C:\Program Files\VideoLAN\VLC\>'''vlc.exe --sub-filter=marq{marquee=$t ($P%%),color=16776960}:marq{marquee=%H:%m%s,position=6} somevideo.avi'''

Example command line '''(All versions including VLC 0.8.6d and prior)''':
% '''vlc --sub-filter=marq --marq-marquee="Obvious Watermark" --marq-position=0 --marq-size=50 --marq-opacity=25 --marq-color=32768 somevideo.avi'''
:This command will show centered transparent green text. Text sized too large to fit the video window will not appear, and may crash VLC.

=== time ===
The {{docmod|time}} module has different command-lines than the marq module. This not-functional command snippet overlays a white 12-point time display in the lower left of an input stream or video:

'''time:'''
% vlc input_stream --sub-filter=time --time-format %Y-%m-%d,%H:%M:%S --time-position 9 --time-color 16777215 --time-size 12

'''marq equivalent:'''
% vlc input_stream '--sub-source=marq{marquee="%Y-%m-%d,%H:%M:%S",position=9,color=16777215,size=12}'

'''marq equivalent (long form):'''
% vlc input_stream --sub-source=marq --marq-marquee="%Y-%m-%d,%H:%M:%S" --marq-position=9 --marq-color=16777215 --marq-size=12

'''additional marq example:'''
% vlc input_stream '--sub-source=marq{marquee="%c (Week %V)",color=16711680,opacity=216,size=16,position=4,timeout=500,refresh=1000}'
This overlays a 25%-transparent flashing red 16-point locale-dependent time representation with week number at the top of the input stream or video.

== Gallery ==
<gallery>
File:Marq demonstration - VLC 3.0.6 Linux.png|Marq can be chained, allowing several marquees to be displayed at the same time.|alt=Marq can be chained, allowing several marquees to be displayed at the same time. Nine positions and text colours are shown against a black background.
</gallery>

== See also ==
* [[Documentation:Format_String]]
* [[Documentation:Modules/rss]]

== Source code ==
* {{VLCSourceFile|modules/spu/marq.c}}

== Appendix ==
<div class="plainlist">
*^ [[#marq-color|--marq-color]]<span id="appendix_marq-color"></span>
</div>
{{Colour mapping}}

{{Documentation footer}}

Template:Alignment mapping

2019-06-02T04:27:37Z

DoesItReallyMatter: Show table side-by-side with other tables

{| class="mw-datatable sortable" style="display: inline-table;"
|+ Integer alignment mapping
! scope="col" | Integer !! scope="col" | Alignment !! scope="col" | Comment
|- style="font-weight:bold;"
| 0 || Center ||
|- style="font-weight:bold;"
| 1 || Left ||
|- style="font-weight:bold;"
| 2 || Right ||
|- style="font-weight:bold;"
| 4 || Top ||
|- style="font-weight:bold;"
| 8 || Bottom ||
|-
| 5 || Top-Left || 4 + 1
|-
| 6 || Top-Right || 4 + 2
|-
| 9 || Bottom-Left || 8 + 1
|-
| 10 || Bottom-Right || 8 + 2
|-
| 3 || {{n/a}} || contradictory
|-
| 7 || {{n/a}} || contradictory
|}<noinclude>

[[Category:Templates]]
</noinclude>

Documentation:Modules/dvbsub

2019-06-02T04:26:34Z

DoesItReallyMatter: Misc.

{{Module|name=dvbsub|type=Subtitles|first_version=0.8.0|description=[[DVB subtitles]] decoder/encoder}}
{{Clear}}

There are notes in the source code:
<syntaxhighlight lang="c">
/*****************************************************************************
* Preamble
*
* FIXME:
* DVB subtitles coded as strings of characters are not handled correctly.
* The character codes in the string should actually be indexes referring to a
* character table identified in the subtitle descriptor.
*
* The spec is quite vague in this area, but what is meant is perhaps that it
* refers to the character index in the codepage belonging to the language
* specified in the subtitle descriptor. Potentially it's designed for widechar
* (but not for UTF-*) codepages.
*****************************************************************************/
</syntaxhighlight>
and
<syntaxhighlight lang="c">
/*****************************************************************************
* Notes on DDS (Display Definition Segment)
* -----------------------------------------
* DDS (Display Definition Segment) tells the decoder how the subtitle image
* relates to the video image.
* For SD, the subtitle image is always considered to be for display at
* 720x576 (although it's assumed that for NTSC, this is 720x480, this
* is not documented well) Also, for SD, the subtitle image is drawn 'on
* the glass' (i.e. after video scaling, letterbox, etc.)
* For 'HD' (subs marked type 0x14/0x24 in PSI), a DDS must be present,
* and the subs area is drawn onto the video area (scales if necessary).
* The DDS tells the decoder what resolution the subtitle images were
* intended for, and hence how to scale the subtitle images for a
* particular video size
* i.e. if HD video is presented as letterbox, the subs will be in the
* same place on the video as if the video was presented on an HD set
* indeed, if the HD video was pillarboxed by the decoder, the subs may
* be cut off as well as the video. The intent here is that the subs can
* be placed accurately on the video - something which was missed in the
* original spec.
*
* A DDS may also specify a window - this is where the subs images are moved so that the (0,0)
* origin of decode is offset.
********************************************************************************************/
</syntaxhighlight>

== Options ==
{{Option
|name=dvbsub-position<span id="dvbsub-position"></span>
|value=integer
|select={ 0, 1, 2, 4, 8, 5, 6, 9, 10 }
|description=Subpicture position<sup>('''[[#appendix_dvbsub-position|key]]''')</sup>
}}
{{Option
|name=dvbsub-x
|value=integer
|default=-1
|description=X coordinate of the rendered subtitle
}}
{{Option
|name=dvbsub-y
|value=integer
|default=-1
|description=Y coordinate of the rendered subtitle
}}

=== Encoder ===
{{Option
|name=sout-dvbsub-x
|value=integer
|default=-1
|description=X coordinate of the encoded subtitle
}}
{{Option
|name=sout-dvbsub-y
|value=integer
|default=-1
|description=Y coordinate of the encoded subtitle
}}
{{Clear}}

== Appendix ==
<div class="plainlist">
*^ [[#dvbsub-position|--dvbsub-position]]<span id="appendix_dvbsub-position"></span>
</div>
{{Alignment mapping}}

== Source code ==
* {{VLCSourceFile|modules/codec/dvbsub.c}}

{{Documentation footer}}

Documentation:Modules/rss

2019-06-02T04:24:15Z

DoesItReallyMatter: Use Template:Colour mapping, misc.

{{Module|name=rss|type=Video sub-filter|first_version=0.8.4|description=Overlays [[wikipedia:RSS|RSS]] and [[wikipedia:Atom (Web standard)|Atom]] feeds on the video|sc=rss|sc2=atom}}

== Options ==
{{Option
|name=rss-urls
|value=string
|default=NULL
|description=Pipe <code>'''{{!}}'''</code> separated list of [[wikipedia:RSS|RSS]] and/or [[wikipedia:Atom (Web standard)|Atom]] feed URLs
}}

=== Position ===
{{Option
|name=rss-x
|value=integer
|default=0
|description=X offset, from the left screen edge
}}
{{Option
|name=rss-y
|value=integer
|default=0
|description=Y offset, down from the top
}}
{{Option
|name=rss-position<span id="rss-position"></span>
|value=integer
|select=[[#appendix_rss-position|{0, 1, 2, 4, 8, 5, 6, 9, 10}]]
|default=-1
|description=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 ===
{{Option
|name=rss-opacity
|value=integer
|min=0
|default=255
|max=255
|description=Opacity (inverse of transparency) of overlay text. 0 = transparent, 255 = totally opaque
}}
{{Option
|name=rss-color<span id="rss-color"></span>
|value=integer
|select={ 0x000000, 0x808080, 0xC0C0C0, 0xFFFFFF, 0x800000, 0xFF0000, 0xFF00FF, 0xFFFF00, 0x808000, 0x008000, 0x008080, 0x00FF00, 0x800080, 0x000080, 0x0000FF, 0x00FFFF }
|default=0xFFFFFF
|description=Color<sup>('''[[#appendix_rss-color|key]]''')</sup> 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
}}
{{Option
|name=rss-size
|value=integer
|min=0
|default=0
|max=4096
|description=Font size, in pixels. Default is 0 (use default font size)
}}

=== Misc ===
{{Option
|name=rss-speed
|value=integer
|default=100000
|description=Speed of the RSS/Atom feeds in [[wiktionary:µs|µs]] (bigger is slower)
}}
{{Option
|name=rss-length
|value=integer
|default=60
|description=Maximum number of characters displayed on the screen
}}
{{Option
|name=rss-ttl
|value=integer
|default=1800
|description=Time in seconds between each feed refresh of the feeds. 0 means that the feeds are never updated. 1800 seconds is 30 minutes
}}
{{Option
|name=rss-images
|value=boolean
|default=enabled
|description=Display feed images if available
}}
{{Option
|name=rss-title
|value=integer
|select={<var>default_title</var>, <var>hide_title</var>, <var>prepend_title</var>, <var>scroll_title</var>}
|default=<var>default_title</var>
|description=Title display mode. 0 is hidden if the feed has an image and feed images are enabled, 1 is always visible, 2 is scroll with feed
}}

== Examples ==
Example command line use '''(VLC 0.9.0 and above)''': (untested with 3.x.x)
% '''vlc somevideo.avi --sub-filter=rss --rss-urls="http://news.google.com/news?ned=us&topic=h&output=rss"'''

== Source code ==
* {{VLCSourceFile|modules/spu/rss.c}}

== See also ==
* [[Documentation:Modules/marq]]

== Appendix ==
<div class="plainlist">
*^ [[#rss-color|--rss-color]]<span id="appendix_rss-color"></span>
*^ [[#rss-position|--rss-position]]<span id="appendix_rss-position"></span>
</div>
{{Colour mapping}}
{{Alignment mapping}}

{{Documentation footer}}

Documentation:Modules/logo

2019-06-02T04:22:03Z

DoesItReallyMatter: Tweaks

{{See also|Documentation:Modules/erase|VLC HowTo/Add a logo}}

The logo filter can be used to add a logo on the video. This logo can be a static image or series of images which will be displayed alternatively. When used as a video output filter, you can move the logo with the mouse.

== Video sub-filter ==
{{Module|name=logo|type=Video sub-filter|description=Logo sub source|sc=logo}}
<onlyinclude>{{Option
|name=logo-file
|value=string
|description=Image to display. The full format is <code><nowiki><image>[,<delay in ms>[,<alpha>]][;<image>[,<delay>[,<alpha>]]][;...]</nowiki></code>.
}}
{{Option
|name=logo-x
|value=integer
|default=0
|description=X offset from upper left corner.
}}
{{Option
|name=logo-y
|value=integer
|default=0
|description=Y offset from upper left corner.
}}
{{Option
|name=logo-position<span id="logo-position"></span>
|value=integer
|select=[[#appendix_logo-position|{ 0, 1, 2, 4, 8, 5, 6, 9, 10 }]]
|default=5
|description=Logo position.
}}
{{Option
|name=logo-opacity
|value=integer
|default=255
|min=0
|max=255
|description=Logo opacity. 0 is transparent, 255 is fully opaque.
}}
{{Option
|name=logo-delay
|value=integer
|default=1000
|description=Global delay in [[wiktionary:ms#Translingual|ms]]. Sets the duration each image will be displayed for in a loop iteration unless specified otherwise in the <code>--logo-file</code> option.
}}
{{Option
|name=logo-repeat
|value=integer
|default=-1
|description=Number of loops for the logo animation. -1 for continuous, 0 to disable.
}}</onlyinclude>
{{Clear}}

== Video output filter ==
{{Module|name=logo|type=Video output filter|description=Logo video filter|sc=logo}}
{{Clear}}

== Examples ==
{{%}} '''vlc --video-filter "logo{file=cone.png,opacity=128}" somevideo.avi'''
: This command will display image cone.png in the video's upper right corner with 50% transparency.

{{%}} '''vlc --video-filter "logo{file='cone1.png,2000,128;cone2.png,3000'}" somevideo.avi'''
: This command will display image cone1.png for 2 seconds with 50% transparency followed by image cone2.png for 3 seconds at default transparency and loop.

== Source code ==
* {{VLCSourceFile|modules/spu/logo.c}}

== Appendix ==
<div class="plainlist">
*^ [[#logo-position|--logo-position]]<span id="appendix_logo-position"></span>
</div>
{{Alignment mapping}}

{{Documentation footer}}

Documentation:Modules/mosaic

2019-06-02T04:21:00Z

DoesItReallyMatter: /* Appendix */ Tweaks

{{Mosaic framework}}
{{Module|name=mosaic|type=Video subfilter|first_version=0.8.2|description=Mosaic video sub source}}

Use this filter to blend videos on top of another video. This can be used to create TV channels mosaics, setup a weather channel-like stream (with the {{docmod|bluescreen}} video filter) and lots of other fun stuff.

Since VLC 0.8.6, you can also use the [[Documentation:Modules/http intf|HTTP interface]]'s mosaic wizard to configure a mosaic easily.
__TOC__
{{Clear}}

== Options ==
{{Option
|name=mosaic-alpha
|value=integer
|min=0
|max=255
|default=255
|description=Alpha blending (transparency) of the mosaic foreground pictures. 0 means transparent, 255 opaque.
}}
{{Option
|name=mosaic-height
|value=integer
|min=0
|max=<var>INT_MAX</var>
|default=100
|description=Total height of the mosaic, in pixels.
}}
{{Option
|name=mosaic-width
|value=integer
|min=0
|max=<var>INT_MAX</var>
|default=100
|description=Total width of the mosaic, in pixels.
}}
{{Option
|name=mosaic-align<span id="select_mosaic-align"></span>
|value=integer
|select=[[#appendix_select_mosaic-align|{ 0, 1, 2, 4, 8, 5, 6, 9, 10 }]]
|default=5
|description=You can enforce the mosaic alignment on the parent video.
}}
{{Option
|name=mosaic-xoffset
|value=integer
|min=0
|max=<var>INT_MAX</var>
|default=0
|description=X Coordinate of the top-left corner of the mosaic.
}}
{{Option
|name=mosaic-yoffset
|value=integer
|min=0
|max=<var>INT_MAX</var>
|default=0
|description=Y Coordinate of the top-left corner of the mosaic.
}}
{{Option
|name=mosaic-borderw
|value=integer
|min=0
|max=<var>INT_MAX</var>
|default=0
|description=Border width between mosaic elements, in pixels.
}}
{{Option
|name=mosaic-borderh
|value=integer
|min=0
|max=<var>INT_MAX</var>
|default=0
|description=Border height between mosaic elements, in pixels.
}}
{{Option
|name=mosaic-position<span id="mosaic-position"></span>
|value=integer
|select={ 0, 1, 2 }
|default=0
|description=Positioning method of the mosaic elements. Use <kbd>0</kbd> to position the elements automatically on the grid, <kbd>1</kbd> to position the elements in fixed positions on the grid (see mosaic-order) and <kbd>2</kbd> to use grid-independent offsets (see [[#mosaic-offsets|mosaic-offsets]]).
}}
{{Option
|name=mosaic-rows
|value=integer
|min=1
|max=<var>INT_MAX</var>
|default=2
|description=Number of image rows in the mosaic (only used if [[#mosaic-position|positioning method]] is set to "fixed").
}}
{{Option
|name=mosaic-cols
|value=integer
|min=1
|max=<var>INT_MAX</var>
|default=2
|description=Number of image columns in the mosaic (only used if [[#mosaic-position|positioning method]] is set to "fixed").
}}
{{Option
|name=mosaic-keep-aspect-ratio
|value=boolean
|default=disabled
|description=Keep the original [[aspect ratio]] when resizing mosaic elements.
}}
{{Option
|name=mosaic-keep-picture
|value=boolean
|default=disabled
|description=Do not resize or do any other transformation on the mosaic pictures. Should be enabled when using the {{docmod|mosaic-bridge}}'s resizing options.
}}
{{Option
|name=mosaic-order
|value=string
|default=""
|description=You can enforce the order of the elements on the mosaic. You must give a comma-separated list of picture ID(s) (For example: <kbd>tf1,fr2,fr3,m6</kbd>). These IDs are assigned in the {{docmod|mosaic-bridge}} module.
}}
{{Option
|name=mosaic-offsets<span id="mosaic-offsets"></span>
|value=string
|default=""
|description=You can enforce the <code>(x,y)</code> offsets of the elements on the mosaic (only used if [[#mosaic-position|positioning method]] is set to "offsets"). You must give a comma-separated list of coordinates. For example: <kbd>10,10,150,10</kbd> if you want to position the first picture at coordinates <code>(10,10)</code> and the second one at coordinates <code>(150,10)</code>.
}}
{{Option
|name=mosaic-delay
|value=integer
|default=0
|description=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.
}}

== Source code ==
* {{VLCSourceFile|modules/spu/mosaic.c}}

== Appendix ==
<div class="plainlist">
*^ [[#select_mosaic-align|--mosaic-align]]<span id="appendix_select_mosaic-align"></span>
</div>
{{Alignment mapping}}

{{Documentation footer}}

Documentation:Modules/time

2019-06-02T04:15:30Z

DoesItReallyMatter: Tweaks, change 268435456 to -268435456

{{Historical|This filter has been merged with the [[Documentation:Modules/marq|marq]] filter in version 0.9.0.}}
{{Module|name=time|type=Video sub-filter|first_version=0.8.0|last_version=0.8.6|description=Overlays date and time on the video|sc=time}}
Allows overlaying date and time information on the video.

== Options ==
The option for the time picture subfilter in version 0.8.6 are the following:
{{Option|name=time-format|value=string|default="%Y-%m-%d %H:%M:%S"|description=[[Special:PermanentLink/5790#Time|Time format string]] (%Y%m%d %H%M%S)}}
{{Option|name=time-x|value=integer|default=-1|description=X offset}}
{{Option|name=time-y|value=integer|default=0|description=Y offset}}
{{Option|name=time-position<span id="time-position"></span>|value=integer|default=9|select=[[#appendix_time-position|{ 0, 1, 2, 4, 8, 5, 6, 9, 10 }]]|description=Position}}
{{Option|name=time-opacity|value=integer|min=0|max=255|default=255|description=Opacity}}
{{Option|name=time-color<span id="time-color"></span>|value=integer|default=16777215|select={ -268435456, 0, 8421504, 12632256, 16777215, 8388608, 16711680, 16711935, 16776960, 8421376, 32768, 32896, 65280, 8388736, 128, 255, 65535 }|description=Colour<sup>('''[[#appendix_time-color|key]]''')</sup>}}
{{Option|name=time-size|value=integer|default=-1|description=Font size, pixels}}

== Usage ==
There are two ways to use the time module: over screen output or display; and over transcoded output.

=== Screen output or display ===
To overlay the current time over vlc screen output or display, use the --time-? options (where ? means "format," "x", "y" etc; i.e. --time-format).

In this example, the time will be displayed in white on the lower right hand corner of the viewable output of a transcoded stream and sent to a multicast IP address with the associated SAP announce.

% '''vlc input_stream --sub-filter=time --time-format %Y-%m-%d,%H:%M:%S --time-position 9 --time-color 16777215 --time-size 12 --sout "#transcode{venc=ffmpeg,vcodec=mp4v}:duplicate{dst=display,dst=rtp{mux=ts,dst=239.255.12.42,sdp=sap,name="TestStream"}}"'''

In this example, the time will be displayed as 2007-6-19,10:09:33. In addition, the time will only be displayed on the visual display of the input_stream. It will not be part of the transcoded output.

=== Transcoded output ===
To overlay the current time over the transcoded output, enable the transcode module subpicture filter or sfilter option.

In this example, the time will be displayed in white on the lower right only in the transcoded output.

% '''vlc input_stream --time-format %Y-%m-%d,%H:%M:%S --time-position 9 --time-color 16777215 --time-size 12 --sout "#transcode{venc=ffmpeg,vcodec=mp4v,sfilter=time}:duplicate{dst=display,dst=rtp{mux=ts,dst=239.255.12.42,sdp=sap,name="TestStream"}}"'''

Note that this is accomplished by removing the --sub-filter=time command line option and adding the sfilter transcode module option. If the --sub-filter=time is included vlc will overlay the time over the overlay transcode time, essentially overlapping it.

Also note that the --time-? command line options are "global;" i.e., they affect the way the time overlays both the display and the transcoded output.

== Source code ==
* {{VLCSourceFile|p=vlc/vlc-0.8.git|modules/video_filter/time.c}}

== Appendix ==
<div class="plainlist">
*^ --[[#time-position|time-position]]<span id="appendix_time-position"></span>
*^ --[[#time-color|time-color]]<span id="appendix_time-color"></span>
</div>
{{Alignment mapping}}
{| class="mw-datatable sortable"
|+ Colour key
! scope="col" | Sample !! scope="col" | Integer code !! scope="col" | Colour
|-
| || <code>-268435456</code> || Default
|-
|style="background-color:black;"| || <code>0</code> || Black
|-
|style="background-color:gray;"| || <code>8421504</code> || Gray
|-
|style="background-color:silver;"| || <code>12632256</code> || Silver
|-
|style="background-color:white;"| || <code>16777215</code> || White
|-
|style="background-color:maroon;"| || <code>8388608</code> || Maroon
|-
|style="background-color:red;"| || <code>16711680</code> || Red
|-
|style="background-color:fuchsia;"| || <code>16711935</code> || Fuchsia
|-
|style="background-color:yellow;"| || <code>16776960</code> || Yellow
|-
|style="background-color:olive;"| || <code>8421376</code> || Olive
|-
|style="background-color:green;"| || <code>32768</code> || Green
|-
|style="background-color:teal;"| || <code>32896</code> || Teal
|-
|style="background-color:lime;"| || <code>65280</code> || Lime
|-
|style="background-color:purple;"| || <code>8388736</code> || Purple
|-
|style="background-color:navy;"| || <code>128</code> || Navy
|-
|style="background-color:blue;"| || <code>255</code> || Blue
|-
|style="background-color:aqua;"| || <code>65535</code> || Aqua
|}

{{Documentation}}

Template:Colour mapping

2019-06-02T04:00:38Z

DoesItReallyMatter: Swap columns for hex code and colour name, remove CSS to allow table collapse

{| class="mw-datatable sortable" style="display: inline-table;"
|+ Colour key
! scope="col" | Sample !! scope="col" | Colour !! scope="col" | Hex code
|-
| style="background-color:black;"| || Black || <code>0x000000</code>
|-
| style="background-color:gray;"| || Gray || <code>0x808080</code>
|-
| style="background-color:silver;"| || Silver || <code>0xC0C0C0</code>
|-
| style="background-color:white;"| || White || <code>0xFFFFFF</code>
|-
| style="background-color:maroon;"| || Maroon || <code>0x800000</code>
|-
| style="background-color:red;"| || Red || <code>0xFF0000</code>
|-
| style="background-color:fuchsia;"| || Fuchsia || <code>0xFF00FF</code>
|-
| style="background-color:yellow;"| || Yellow || <code>0xFFFF00</code>
|-
| style="background-color:olive;"| || Olive || <code>0x808000</code>
|-
| style="background-color:green;"| || Green || <code>0x008000</code>
|-
| style="background-color:teal;"| || Teal || <code>0x008080</code>
|-
| style="background-color:lime;"| || Lime || <code>0x00FF00</code>
|-
| style="background-color:purple;"| || Purple || <code>0x800080</code>
|-
| style="background-color:navy;"| || Navy || <code>0x000080</code>
|-
| style="background-color:blue;"| || Blue || <code>0x0000FF</code>
|-
| style="background-color:aqua;"| || Aqua || <code>0x00FFFF</code>
|}<noinclude>

[[Category:Templates]]
</noinclude>

Template:Colour mapping

2019-06-02T03:40:52Z

DoesItReallyMatter: Create key for number-to-colour mapping in templates (e.g. marq for --marq-color)

{| class="mw-datatable mw-collapsible sortable" style="display: inline-table;"
|+ Colour key
! scope="col" | Sample !! scope="col" | Hex code !! scope="col" | Colour
|-
|style="background-color:black;"| || <code>0x000000</code> || Black
|-
|style="background-color:gray;"| || <code>0x808080</code> || Gray
|-
|style="background-color:silver;"| || <code>0xC0C0C0</code> || Silver
|-
|style="background-color:white;"| || <code>0xFFFFFF</code> || White
|-
|style="background-color:maroon;"| || <code>0x800000</code> || Maroon
|-
|style="background-color:red;"| || <code>0xFF0000</code> || Red
|-
|style="background-color:fuchsia;"| || <code>0xFF00FF</code> || Fuchsia
|-
|style="background-color:yellow;"| || <code>0xFFFF00</code> || Yellow
|-
|style="background-color:olive;"| || <code>0x808000</code> || Olive
|-
|style="background-color:green;"| || <code>0x008000</code> || Green
|-
|style="background-color:teal;"| || <code>0x008080</code> || Teal
|-
|style="background-color:lime;"| || <code>0x00FF00</code> || Lime
|-
|style="background-color:purple;"| || <code>0x800080</code> || Purple
|-
|style="background-color:navy;"| || <code>0x000080</code> || Navy
|-
|style="background-color:blue;"| || <code>0x0000FF</code> || Blue
|-
|style="background-color:aqua;"| || <code>0x00FFFF</code> || Aqua
|}<noinclude>

[[Category:Templates]]
</noinclude>

Documentation:Modules/rss

2019-06-02T02:43:38Z

DoesItReallyMatter: Strip unused leading zeros from --rss-color selection, prepare for template

{{Module|name=rss|type=Video sub-filter|first_version=0.8.4|description=Overlays [[wikipedia:RSS|RSS]] and [[wikipedia:Atom (Web standard)|Atom]] feeds on the video|sc=rss|sc2=atom}}

== Options ==
{{Option
|name=rss-urls
|value=string
|default=NULL
|description=Pipe <code>'''{{!}}'''</code> separated list of [[wikipedia:RSS|RSS]] and/or [[wikipedia:Atom (Web standard)|Atom]] feed URLs
}}

=== Position ===
{{Option
|name=rss-x
|value=integer
|default=0
|description=X offset, from the left screen edge
}}
{{Option
|name=rss-y
|value=integer
|default=0
|description=Y offset, down from the top
}}
{{Option
|name=rss-position<span id="rss-position"></span>
|value=integer
|select=[[#appendix_rss-position|{0, 1, 2, 4, 8, 5, 6, 9, 10}]]
|default=-1
|description=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 ===
{{Option
|name=rss-opacity
|value=integer
|min=0
|default=255
|max=255
|description=Opacity (inverse of transparency) of overlay text. 0 = transparent, 255 = totally opaque
}}
{{Option
|name=rss-color<span id="rss-color"></span>
|value=integer
|select={ 0x000000, 0x808080, 0xC0C0C0, 0xFFFFFF, 0x800000, 0xFF0000, 0xFF00FF, 0xFFFF00, 0x808000, 0x008000, 0x008080, 0x00FF00, 0x800080, 0x000080, 0x0000FF, 0x00FFFF }
|default=0xFFFFFF
|description=Color<sup>('''[[#appendix_rss-color|key]]''')</sup> 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
}}
{{Option
|name=rss-size
|value=integer
|min=0
|default=0
|max=4096
|description=Font size, in pixels. Default is 0 (use default font size)
}}

=== Misc ===
{{Option
|name=rss-speed
|value=integer
|default=100000
|description=Speed of the RSS/Atom feeds in [[wiktionary:µs|µs]] (bigger is slower)
}}
{{Option
|name=rss-length
|value=integer
|default=60
|description=Maximum number of characters displayed on the screen
}}
{{Option
|name=rss-ttl
|value=integer
|default=1800
|description=Time in seconds between each feed refresh of the feeds. 0 means that the feeds are never updated. 1800 seconds is 30 minutes
}}
{{Option
|name=rss-images
|value=boolean
|default=enabled
|description=Display feed images if available
}}
{{Option
|name=rss-title
|value=integer
|select={<var>default_title</var>, <var>hide_title</var>, <var>prepend_title</var>, <var>scroll_title</var>}
|default=<var>default_title</var>
|description=Title display mode. 0 is hidden if the feed has an image and feed images are enabled, 1 is always visible, 2 is scroll with feed
}}

== Examples ==
Example command line use '''(VLC 0.9.0 and above)''': (untested with 3.x.x)
% '''vlc somevideo.avi --sub-filter=rss --rss-urls="http://news.google.com/news?ned=us&topic=h&output=rss"'''

== Source code ==
* {{VLCSourceFile|modules/spu/rss.c}}

== See also ==
* [[Documentation:Modules/marq]]

== Appendix ==
<span id="appendix_rss-color"></span>
For --[[#rss-color|rss-color]]:
{| class="mw-datatable"
|+ Colour key
! scope="col" | Sample !! scope="col" | Hex code !! scope="col" | Colour
|-
|style="background-color:black;"| || <code>0x000000</code> || Black
|-
|style="background-color:gray;"| || <code>0x808080</code> || Gray
|-
|style="background-color:silver;"| || <code>0xC0C0C0</code> || Silver
|-
|style="background-color:white;"| || <code>0xFFFFFF</code> || White
|-
|style="background-color:maroon;"| || <code>0x800000</code> || Maroon
|-
|style="background-color:red;"| || <code>0xFF0000</code> || Red
|-
|style="background-color:fuchsia;"| || <code>0xFF00FF</code> || Fuchsia
|-
|style="background-color:yellow;"| || <code>0xFFFF00</code> || Yellow
|-
|style="background-color:olive;"| || <code>0x808000</code> || Olive
|-
|style="background-color:green;"| || <code>0x008000</code> || Green
|-
|style="background-color:teal;"| || <code>0x008080</code> || Teal
|-
|style="background-color:lime;"| || <code>0x00FF00</code> || Lime
|-
|style="background-color:purple;"| || <code>0x800080</code> || Purple
|-
|style="background-color:navy;"| || <code>0x000080</code> || Navy
|-
|style="background-color:blue;"| || <code>0x0000FF</code> || Blue
|-
|style="background-color:aqua;"| || <code>0x00FFFF</code> || Aqua
|}
<span id="appendix_rss-position"></span>
For --[[#rss-position|rss-position]]:
{{Alignment mapping}}

{{Documentation}}

Documentation:Modules/marq

2019-06-01T10:31:56Z

DoesItReallyMatter: /* Gallery */ New section with :File:Marq demonstration - VLC 3.0.6 Linux.png

{{Module|name=marq|type=Video sub-filter|first_version=0.8.0|description=Overlays text on the video|sc=marq}}

The marq sub-filter can be used to display text on a video. The {{docmod|time}} filter was merged with this filter in version 0.9.0.

== Options ==
<onlyinclude>{{Option
|name=marq-marquee
|value=string
|default=VLC
|description=Marquee text to display. Since VLC version 0.9.0 you can use [[Documentation:Play_HowTo/Format_String|format strings]] to display time information
}}
{{Option
|name=marq-file
|value=string
|description=File to read the marquee text from
}}
{{Option
|name=marq-x
|value=integer
|default=0 (0.8.6d and prior: -1)
|description=X offset from upper left corner. (0.8.6d and prior: This is only if both marq-x and marq-y are positive)
}}
{{Option
|name=marq-y
|value=integer
|default=0
|description=Y offset from upper left corner. (0.8.6d and prior: This is only if both marq-x and marq-y are positive)
}}
{{Option
|name=marq-position
|value=integer
|default=-1 (formerly 5)
|description=Marquee position: 0=center, 1=left, 2=right, 4=top, 8=bottom, you can also use combinations of these values, eg 6 = top-right. (0.8.6d and prior: This is only used if marq-x or marq-y are negative)
}}
{{Option
|name=marq-opacity
|value=integer
|min=0
|max=255
|default=255
|description=Marquee opacity. 0 is transparent, 255 is fully opaque
}}
{{Option
|name=marq-color
|value=integer
|default=-268435456 (formerly 16777215 (0xFFFFFF, white))
|description=Marquee color. Use the decimal value of the HTML color code
}}
{{Option
|name=marq-size
|value=integer
|min=0
|max=4096
|default=0 (formerly -1)
|description=Font size in pixels. 0 uses the default font size (formerly represented by -1)
}}
{{Option
|name=marq-timeout
|value=integer
|default=0
|description=Number of milliseconds the marquee must remain displayed. 0 means forever
}}
{{Option
|name=marq-refresh
|value=integer
|default=1000
|description=Number of milliseconds between string updates. This is mainly useful when using meta data or time format string sequences
}}</onlyinclude>

== Examples ==

Example command line use '''(VLC 2.0.0 and newer)''':
% '''vlc --sub-source="marq{marquee=test,color=16776960} somevideo.avi'''
:This example displays yellow ''test'' text in the top left corner of video

Example command line use '''(VLC 0.9.0 - 1.1.13)''':
% '''vlc --sub-filter "marq{marquee=\$t (\$P%%),color=16776960}:marq{marquee=%H:%M:%S,position=6}" somevideo.avi'''
% '''vlc --sub-filter 'marq{marquee=$t ($P%%),color=16776960}:marq{marquee=%H:%M:%S,position=6}' somevideo.avi'''
:This command line will show the stream's title ($t) and current position ($P) in the upper left corner and the current time in the upper right corner. Note that we have to escape $ characters when running this from command line in UNIX shells (this is why we use \$ instead of $). The second line uses single quotes to delimit the string so we don't need to escape the $ character.
:On windows the command line would be:
C:\Program Files\VideoLAN\VLC\>'''vlc.exe --sub-filter=marq{marquee=$t ($P%%),color=16776960}:marq{marquee=%H:%m%s,position=6} somevideo.avi'''

Example command line '''(All versions including VLC 0.8.6d and prior)''':
% '''vlc --sub-filter=marq --marq-marquee="Obvious Watermark" --marq-position=0 --marq-size=50 --marq-opacity=25 --marq-color=32768 somevideo.avi'''
:This command will show centered transparent green text. Text sized too large to fit the video window will not appear, and may crash VLC.

=== time ===
The {{docmod|time}} module has different command-lines than the marq module. This not-functional command snippet overlays a white 12-point time display in the lower left of an input stream or video:

'''time:'''
% vlc input_stream --sub-filter=time --time-format %Y-%m-%d,%H:%M:%S --time-position 9 --time-color 16777215 --time-size 12

'''marq equivalent:'''
% vlc input_stream '--sub-source=marq{marquee="%Y-%m-%d,%H:%M:%S",position=9,color=16777215,size=12}'

'''marq equivalent (long form):'''
% vlc input_stream --sub-source=marq --marq-marquee="%Y-%m-%d,%H:%M:%S" --marq-position=9 --marq-color=16777215 --marq-size=12

'''additional marq example:'''
% vlc input_stream '--sub-source=marq{marquee="%c (Week %V)",color=16711680,opacity=216,size=16,position=4,timeout=500,refresh=1000}'
This overlays a 25%-transparent flashing red 16-point locale-dependent time representation with week number at the top of the input stream or video.

== Gallery ==
<gallery>
File:Marq demonstration - VLC 3.0.6 Linux.png|Marq can be chained, allowing several marquees to be displayed at the same time.|alt=Marq can be chained, allowing several marquees to be displayed at the same time. Nine positions and text colours are shown against a black background.
</gallery>

== See also ==
* [[Documentation:Format_String]]
* [[Documentation:Modules/rss]]

== Source code ==
* {{VLCSourceFile|modules/spu/marq.c}}

{{Documentation}}

File:Marq demonstration - VLC 3.0.6 Linux.png

2019-06-01T10:20:04Z

DoesItReallyMatter: Provide command-line used in demonstration

== Summary ==
A demonstration of the [[Documentation:Modules/marq|marq]] module for VLC 3.0.6, Linux, GNOME Shell 3.22.2. It shows nine differently-coloured marquees indicating position codes against a simple 512x512 px black background.

This was generated with a single command-line instruction (using chaining):
<syntaxhighlight lang="bash">
vlc Black.png --marq-size=24 "--sub-source=marq{marquee='position 0',position=0,color=0x800000}:marq{marquee='position 1',position=1,color=0xFF0000}:marq{marquee='position 2',position=2,color=0xFF00FF}:marq{marquee='position 4',position=4,color=0xFFFF00}:marq{marquee='position 5',position=5,color=0x808000}:marq{marquee='position 6',position=6,color=0x008000}:marq{marquee='position 8',position=8,color=0x008080}:marq{marquee='position 9',position=9,color=0x00FF00}:marq{marquee='position 10',position=10,color=0x800080}" --width=512 --height=512 --no-video-title-show
</syntaxhighlight>

I took the picture myself, releasing under [https://creativecommons.org/licenses/by/4.0/ CC-BY 4.0] (open to alternate licensure on request).

[[Category:GNU/Linux images]]
[[Category:Qt images]]
[[Category:VLC 3.0.x images]]
__NOINDEX__
== Licensing ==
{{CC-BY-4.0}}

File:Marq demonstration - VLC 3.0.6 Linux.png

2019-06-01T10:03:51Z

DoesItReallyMatter: A demonstration of the marq module for VLC 3.0.6, Linux, GNOME Shell 3.22.2. It shows nine differently-coloured marquees indicating position codes against a simple 512x512 px black background. This was generated with a s...

Documentation:Playback

2019-06-01T08:45:32Z

DoesItReallyMatter: Replace outdated :File:VLC - go to time.png with :File:Go to time - VLC 3.0.6 Linux.png

{{RightMenu|Documentation TOC}}
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.

== 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 video:

# From the ''Playback'' menu select the ''Bookmarks'' option, and the ''Manage Bookmarks''. The ''Edit Bookmarks'' dialog box opens.
# Click ''Create'' to create a bookmark for the current track. The created bookmark appears in the ''Edit Bookmarks'' dialog box.
# To view a scene that is bookmarked, select a bookmark from ''Bookmarks'' in the ''Playback'' menu.

[[File:Basic_playback_bookmarks.png]]

Edit Bookmarks dialog box under Windows in VLC 1.1.5

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

# To open a folder, select ''Open Folder'' from the ''Media'' menu. Locate the folder in which the video files are present and click ''OK''.
# To select a title, click ''Title'' in the ''Playback'' menu. The selected title is then played.

== Chapter ==

A video can also be 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:

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

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

# To customize a title, select the required option from ''DVD Menu'' in the ''Navigation'' menu.
# To view a title, select a ''Title'' under ''Navigation'' in the ''Playback'' menu. The selected title is played.
# To view a chapter in a title, select ''Title''. When you select a title, the chapters in a title are listed. Select a chapter.

Refer to [[#Title]] and [[#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). ''FIXME: Description needs to be improved''

== Specify the time ==

This option is used to go to a specific frame in a media file and listen or view once again.

# To specify time select ''Jump to Specific Time'' from the ''Playback'' menu. The ''Go to Time'' dialog box is displayed.
# Enter the time in ''hh:mm:ss''.
# Click on the ''Go'' button. The control moves the tracker to a specific frame and the media file continues from that specified frame.
# Click ''Cancel'' to exit the dialog box.

Note: Ensure that time limit is within the range of length of the media file.

[[File:Go to time - VLC 3.0.6 Linux.png|The dialogue box as shown in VLC 3.0.6 (Linux)|alt=]]

{{Documentation}}

VLC HowTo/Jump to a certain time

2019-06-01T08:40:47Z

DoesItReallyMatter: Replace outdated :File:Gototime.JPG with framed :File:Go to time - VLC 3.0.6 Linux.png

{{Howto|jump to a certain time in a video}}

== Graphical ==
[[File:Go to time - VLC 3.0.6 Linux.png|framed|right|The dialogue box as shown in VLC 3.0.6 (Linux)|alt=]]

In the menu bar select '''Playback''' → '''Jump to Specific Time'''. Alternatively, press <kbd>Ctrl+T</kbd>. Enter the hours, minutes, and seconds.

== Command-line ==
To seek from the command-line, use <code>--start-time <seconds></code> to skip the beginning or <code>--stop-time <seconds></code> to skip the end. As of VLC version 1.0.0 sub-second values are accepted.
Example:
{{%}} vlc --start-time=83.4 --stop-time=300 BigBuckBunny.ogv
Plays an open-source movie starting at 1 minute 23.4 seconds and ending at 5 minutes.

Advanced users: playback control is documented in <code>vlc --module=core --advanced</code>

{{VSG}}

[[Category:GNU GPL Licensed pages]]

File:Go to time - VLC 3.0.6 Linux.png

2019-06-01T08:36:19Z

DoesItReallyMatter: Casing

== Summary ==
Screenshot of dialogue "Go to time" for VLC 3.0.6, Linux, GNOME Shell 3.22.2. More up-to-date than [[:File:Gototime.JPG]] or [[:File:VLC - go to time.png]]

I took this picture myself, releasing under [https://creativecommons.org/licenses/by/4.0/ CC-BY 4.0] (open to alternate licensure on request).

[[Category:Dialogue boxes]]
[[Category:GNU/Linux images]]
[[Category:Qt images]]
[[Category:VLC 3.0.x images]]
__NOINDEX__
== Licensing ==
{{CC-BY-4.0}}

File:Go to time - VLC 3.0.6 Linux.png

2019-06-01T08:35:59Z

DoesItReallyMatter: DoesItReallyMatter moved page File:Go to Time - VLC 3.0.6 Linux.png to File:Go to time - VLC 3.0.6 Linux.png without leaving a redirect: Casing

== Summary ==
Screenshot of dialogue "Go to Time" for VLC 3.0.6, Linux, GNOME Shell 3.22.2. More up-to-date than [[:File:Gototime.JPG]] or [[:File:VLC - go to time.png]]

I took this picture myself, releasing under [https://creativecommons.org/licenses/by/4.0/ CC-BY 4.0] (open to alternate licensure on request).

[[Category:Dialogue boxes]]
[[Category:GNU/Linux images]]
[[Category:Qt images]]
[[Category:VLC 3.0.x images]]
__NOINDEX__
== Licensing ==
{{CC-BY-4.0}}

File:Go to time - VLC 3.0.6 Linux.png

2019-06-01T08:34:27Z

DoesItReallyMatter: Screenshot of dialogue "Go to Time" for VLC 3.0.6, Linux, GNOME Shell 3.22.2. More up-to-date than :File:Gototime.JPG or :File:VLC - go to time.png I took this picture myself, releasing under [https://creativecommons.org/licenses/by/4.0/ CC-BY...

MediaWiki:Licenses

2019-06-01T07:59:40Z

DoesItReallyMatter: Add Template:CC-BY-4.0 to dropdown

* PD|PD: Public Domain dedication
* LGPL-3.0+|LGPL 3.0+: GNU Lesser General Public License v3.0 or later
* CC-0|CC-0: Creative Commons Universal Public Domain dedication
* CC-BY-3.0|CC-BY 3.0: Creative Commons Attribution 3.0 Unported license
* CC-BY-4.0|CC-BY 4.0: Creative Commons Attribution 4.0 International
* CC-BY-SA-3.0|CC-BY-SA 3.0: Creative Commons Attribution-ShareAlike 3.0 Unported
* CC-BY-SA-4.0|CC-BY-SA 4.0: Creative Commons Attribution-ShareAlike 4.0
* CC-BY-NC-SA-2.0|CC-BY-NC-SA 2.0: Creative Commons Attribution-NonCommercial-ShareAlike 2.0
* GPL|GPL: GNU General Public License (any version)

Template:CC-BY-4.0

2019-06-01T07:53:53Z

DoesItReallyMatter: Wrapper template for CC-BY-4.0 media: calls Template:File copyright

{{File copyright|CC-BY-4.0}}<noinclude>

[[Category:File copyright templates]]
</noinclude>

Template:File copyright

2019-06-01T07:52:29Z

DoesItReallyMatter: Add copyright code "CC-BY-4.0" for Creative Commons Attribution 4.0 International

<div class="widebox center" style="color: initial; background: white;">
{{#switch:{{{1}}}
|CC-0 = This file is provided under the '''[https://creativecommons.org/publicdomain/zero/1.0/ CC0 1.0 Universal Public Domain Dedication]''' license.
|CC-BY-3.0 = This file is under the '''[https://creativecommons.org/licenses/by/3.0/ Creative Commons Attribution 3.0 Unported]''' license.
|CC-BY-4.0 = This file is under the '''[https://creativecommons.org/licenses/by/4.0/ Creative Commons Attribution 4.0 International]''' license.
|CC-BY-NC-SA-2.0 = This file is under the '''[https://creativecommons.org/licenses/by-nc-sa/2.0/ Creative Commons Attribution-NonCommercial-ShareAlike 2.0]''' license.
|CC-BY-SA-3.0 = This file is under the '''[https://creativecommons.org/licenses/by-sa/3.0/ Creative Commons Attribution-ShareAlike 3.0 Unported]''' license.
|CC-BY-SA-4.0 = This file is under the '''[https://creativecommons.org/licenses/by-sa/4.0/ Creative Commons Attribution-ShareAlike 4.0]''' license.
|GPL = This file is under the '''[https://www.gnu.org/licenses/gpl.html GNU General Public License]''' (any version ever published).
|LGPL-3.0+ = This file is under the '''[https://www.gnu.org/licenses/lgpl-3.0.html GNU Lesser General Public License]''' (version 3 or later).
|PD = This file is in the '''Public Domain''' and may be used for any purpose.
|#default = {{{1|Copyright details}}}
}}</div><noinclude>
== Usage ==
<code>{{{{PAGENAME}}|<nowiki><copyright>}}</nowiki></code>

Copyright may be:
* CC-0
* CC-BY-3.0
* CC-BY-4.0
* CC-BY-NC-SA-2.0
* CC-BY-SA-3.0
* CC-BY-SA-4.0
* GPL
* LGPL-3.0+
* PD

Otherwise the information will be displayed as-is (wikimarkup allowed), e.g. <code>{{{{PAGENAME}}|<nowiki>custom}}</nowiki></code> will give <samp>custom</samp>

[[Category:File copyright templates|*]]
</noinclude>