VideoLAN Wiki - User contributions [en]

VLC HowTo/Make thumbnails

2011-07-20T00:06:30Z

Ajmas: /* Creating a contact sheet */

{{howto|make a thumbnail}}
==How to create a thumbnail from a video==

For all those people wanting a thumbnail from a video, use the following command (Windows):

<pre>vlc -V image --start-time 0 --stop-time 1 --image-out-format jpg --image-out-ratio 24 --image-out-prefix snap test.mpg vlc://quit</pre>

The following syntax is for Windows (NEWS.txt: Image video output has been rewritten into a video-filter named 'scene'. The old image video output has been removed.)

<pre>vlc C:\video\to\process.mp4 --rate=1 --video-filter=scene --vout=dummy --start-time=10 --stop-time=11 --scene-format=png --scene-ratio=24 --scene-prefix=snap --scene-path=C:\path\for\snapshots\ vlc://quit</pre>

If you want to get rid of the sound you can add "--aout=dummy" next to "--vout=dummy".

===What it does:===

When {{VLC}} runs it 'plays' the video for one second without actually showing the video on screen, and then quits, leaving us with a file named 'snap000000.jpg', containing an image of the first frame of the video.

===How it works:===

First select the image output with: '''-V image''' or '''--vout image'''.

Next set the interval (in seconds) you want an image from with: '''--start-time 0 --stop-time 1'''
In my example the first second of the video. In that case you could omit the parameter --start-time. If you want an image from the 5th second fill in: '''--start-time 5 --stop-time 6'''

The image format will be .jpg because i provided: '''--image-out-format jpg'''. You could specify '''--image-out-format png''' to get a .png-image instead.

'''--image-out-ratio 24''' specifies we want one image out of 24. In my case the video contains 24 images per second so this is the right value. If your video has more images per seconds you should increase this value to prevend you get more images as one. If the number is too high (for example 500) it still produces only one image, so the actual value is not so important as long as it is higher then the images per second.

'''--image-out-prefix snap''' specifies the filename must start with 'snap'. You can prefix with a path, for example c:\snap and resulting images will be created there.

You can specify '''--image-out-replace'''. In that case Vlc produces the file 'snap.jpg'. This will prevent VLC from creating multiple images.

'''test.mpg''' specifies the video to play and finally '''vlc://quit''' forces vlc to quit when ready.

===Creating a contact sheet===

Although VLC does not provide an option for creating a contact sheet, one possible solution is to use the [http://www.imagemagick.org ImageMagick] 'montage' tool. Taking the images generated by VLC, run the following command:

montage --tile *.jpg montage.jpg

For more on the tool you can check the associated [http://www.imagemagick.org/Usage/montage/ montage help page].

VLC HowTo/Make thumbnails

2011-07-20T00:06:09Z

Ajmas: /* How it works: */

{{howto|make a thumbnail}}
==How to create a thumbnail from a video==

For all those people wanting a thumbnail from a video, use the following command (Windows):

<pre>vlc -V image --start-time 0 --stop-time 1 --image-out-format jpg --image-out-ratio 24 --image-out-prefix snap test.mpg vlc://quit</pre>

The following syntax is for Windows (NEWS.txt: Image video output has been rewritten into a video-filter named 'scene'. The old image video output has been removed.)

<pre>vlc C:\video\to\process.mp4 --rate=1 --video-filter=scene --vout=dummy --start-time=10 --stop-time=11 --scene-format=png --scene-ratio=24 --scene-prefix=snap --scene-path=C:\path\for\snapshots\ vlc://quit</pre>

If you want to get rid of the sound you can add "--aout=dummy" next to "--vout=dummy".

===What it does:===

When {{VLC}} runs it 'plays' the video for one second without actually showing the video on screen, and then quits, leaving us with a file named 'snap000000.jpg', containing an image of the first frame of the video.

===How it works:===

First select the image output with: '''-V image''' or '''--vout image'''.

Next set the interval (in seconds) you want an image from with: '''--start-time 0 --stop-time 1'''
In my example the first second of the video. In that case you could omit the parameter --start-time. If you want an image from the 5th second fill in: '''--start-time 5 --stop-time 6'''

The image format will be .jpg because i provided: '''--image-out-format jpg'''. You could specify '''--image-out-format png''' to get a .png-image instead.

'''--image-out-ratio 24''' specifies we want one image out of 24. In my case the video contains 24 images per second so this is the right value. If your video has more images per seconds you should increase this value to prevend you get more images as one. If the number is too high (for example 500) it still produces only one image, so the actual value is not so important as long as it is higher then the images per second.

'''--image-out-prefix snap''' specifies the filename must start with 'snap'. You can prefix with a path, for example c:\snap and resulting images will be created there.

You can specify '''--image-out-replace'''. In that case Vlc produces the file 'snap.jpg'. This will prevent VLC from creating multiple images.

'''test.mpg''' specifies the video to play and finally '''vlc://quit''' forces vlc to quit when ready.

===Creating a contact sheet===

Although VLC does not provide an option for creating a contact sheet, one possible solution is to use [http://www.imagemagick.org ImageMagick]'s 'montage' tool. Taking the images generated by VLC, run the following command:

montage --tile *.jpg montage.jpg

For more on the tool you can check the associated [http://www.imagemagick.org/Usage/montage/ montage help page].

3D

2010-09-26T04:10:10Z

Ajmas: /* Related Pages */

The intention of this page is to describe how to use VLC to watch 3D video. Please add to it if you can.

==3D Display Technologies==

Generally there are three widely use 3D display technologies, all based on the principles of stereoscopic projection:

* [http://en.wikipedia.org/wiki/Anaglyph_image Anaglyph] - red/green or red/blue images with glasses filtering out one colour or the other
* Polarisation - technique used in cinemas, with two images projected with different polarisations, a silvered screen and polarised glasses
* [http://en.wikipedia.org/wiki/Liquid_crystal_shutter_glasses Shutter Glasses] - technique used by the new 3D televisions, where each alternating frame represent the left or right views.

==Video formats supporting 3D==

to do

==How to view 3D videos in VLC==

to do

==Related Pages==

* [http://en.wikipedia.org/wiki/Multiview_Video_Coding Multiview Video Coding]
* [http://en.wikipedia.org/wiki/Stereoscopy Stereoscopy]
* [http://netblender.ning.com/forum/topics/bluray-3d-sample-disc-encoded Blu-ray 3D sample disc encoded and authored with DoStudio]
* [http://www.avsforum.com/avs-vb/showthread.php?t=1176599 BD 3D details start to trickle out...] - forum posting
* [http://www.youtube.com/watch?v=5ANcspdYh_U YouTube in 3D]
{{stub}}

3D

2010-09-26T04:02:41Z

Ajmas: /* Related Pages */

3D

2010-09-25T16:29:05Z

Ajmas: /* Related Pages */

3D

2010-09-25T16:20:16Z

Ajmas: /* 3D Display Technologies */

3D

2010-09-25T16:19:28Z

Ajmas: /* Related Pages */

The intention of this page is to describe how to use VLC to watch 3D video. Please add to it if you can.

==3D Display Technologies==

Generally there are three widely use 3D display technologies:
* [http://en.wikipedia.org/wiki/Anaglyph_image Anaglyph] - red/green or red/blue images with glasses filtering out one colour or the other
* Polarisation - technique used in cinemas, with two images projected with different polarisations, a silvered screen and polarised glasses
* [http://en.wikipedia.org/wiki/Liquid_crystal_shutter_glasses Shutter Glasses] - technique used by the new 3D televisions, where each alternating frame represent the left or right views.

==Video formats supporting 3D==

to do

==How to view 3D videos in VLC==

to do

==Related Pages==

* [http://en.wikipedia.org/wiki/Multiview_Video_Coding Multiview Video Coding]
* [http://en.wikipedia.org/wiki/Stereoscopy Stereoscopy]

{{stub}}

3D

2010-09-25T16:18:37Z

Ajmas: /* Related Pages */

The intention of this page is to describe how to use VLC to watch 3D video. Please add to it if you can.

==3D Display Technologies==

Generally there are three widely use 3D display technologies:
* [http://en.wikipedia.org/wiki/Anaglyph_image Anaglyph] - red/green or red/blue images with glasses filtering out one colour or the other
* Polarisation - technique used in cinemas, with two images projected with different polarisations, a silvered screen and polarised glasses
* [http://en.wikipedia.org/wiki/Liquid_crystal_shutter_glasses Shutter Glasses] - technique used by the new 3D televisions, where each alternating frame represent the left or right views.

==Video formats supporting 3D==

to do

==How to view 3D videos in VLC==

to do

==Related Pages==

* [http://en.wikipedia.org/wiki/Multiview_Video_Coding Multiview Video Coding]

{{stub}}

3D

2010-09-25T16:16:25Z

Ajmas:

The intention of this page is to describe how to use VLC to watch 3D video. Please add to it if you can.

==3D Display Technologies==

Generally there are three widely use 3D display technologies:
* [http://en.wikipedia.org/wiki/Anaglyph_image Anaglyph] - red/green or red/blue images with glasses filtering out one colour or the other
* Polarisation - technique used in cinemas, with two images projected with different polarisations, a silvered screen and polarised glasses
* [http://en.wikipedia.org/wiki/Liquid_crystal_shutter_glasses Shutter Glasses] - technique used by the new 3D televisions, where each alternating frame represent the left or right views.

==Video formats supporting 3D==

to do

==How to view 3D videos in VLC==

to do

==Related Pages==

{{stub}}

3D

2010-09-25T16:13:39Z

Ajmas:

The intention of this page is to describe how to use VLC to watch 3D video. Please add to it if you can.

==3D Display Technologies==

Generally there are three widely use 3D display technologies:
* [http://en.wikipedia.org/wiki/Anaglyph_image Anaglyph] - red/green or red/blue images with glasses filtering out one colour or the other
* Polarisation - technique used in cinemas, with two images projected with different polarisations, a silvered screen and polarised glasses
* [http://en.wikipedia.org/wiki/Liquid_crystal_shutter_glasses Shutter Glasses] - technique used by the new 3D televisions, where each alternating frame represent the left or right views.

{{stub}}

3D

2010-09-25T16:05:10Z

Ajmas: Created page with '{{stub}}'

Jvlc

2010-01-15T18:28:06Z

Ajmas:

{{stub}}

JVLC are Java bindings for VLC.

There is also [[VLCJ]] which aims to solve the same problem.

Jvlc

2010-01-06T15:58:06Z

Ajmas: Created page with '{{stub}} JVLC are Java bindings for VLC. It is managed as an external project at: http://code.google.com/p/vlcj/ There is an active thread on the subject at: http://forum.video...'

{{stub}}

JVLC are Java bindings for VLC. It is managed as an external project at: http://code.google.com/p/vlcj/

There is an active thread on the subject at: http://forum.videolan.org/viewtopic.php?f=32&t=56939&start=15

Talk:MacOSCompile

2009-12-24T18:46:45Z

Ajmas:

(comments withdrawn)

: First of all, this wiki isn't the correct place to discuss this kind of questions. vlc-devel at videolan is a far better place. Anyway, it's correct that you can use the 10.4u SDK as well. In fact, VLC obviously automatically does so on Intel-based Macs. Concerning your 2nd comment: no further tool beside the default installation to /usr/local is required to build VLC (excepting svn/subversion in rare cases). Any other 3rd party library, which would usually end up in that directory is built and installed inside VLC's code base, in extras/contrib to be precise. That's clearly stated on this HOWTO page. Please mail the mailing list mentioned above for further feedback. Additionally, when complaining about VLC in general or particularly documentation, keep in mind that we're doing this in our spare time and that we aren't required to answer your requests, especially when strangers to this project get demanding and impolite. [[User:Fkuehne|feepk]] 01:27, 1 February 2007 (CET)

== Git from other Sources ==

If you don't have git, then it can also be installed using MacPorts:

sudo port install git-core

== With latest changes to build for x86_64... --[[User:Pdherbemont|Pdherbemont]]==
I think we need --host=x86_64-apple-darwin10 (and --build=x86_64-apple-darwin10 is not mandatory)

== Change how the build intruction are shown --[[User:Pdherbemont|Pdherbemont]] 20:34, 31 May 2007 (CEST) ==
I would suggest we put the build command in some form easier to read, like :

* Build the third party libraries
cd vlc/extras/contrib
./bootstrap
make
* Now build vlc
./bootstrap
./configure
make

(By the way, the current instruction to use make src doesn't work. make alone is sufficient and necessary. --[[User:Chjones|Chjones]] 00:59, 18 June 2008 (CEST))

== Please don't link to subversion --[[User:Pdherbemont|Pdherbemont]] 12:15, 2 May 2008 (CEST) ==

= Compiling VLC on Mac OS X (draft) =
Compiling {{VLC}} on Mac OS X is different from normal compilation on Linux and Mac OS X. We do not use Xcode, nor a simple <code>./configure</code> and <code>make</code>. Below you will find instructions for how to compile VLC on Mac OS X - remember to check the prerequisites before taking the plunge.

If you wish to develop or test please join the vlc-devel mailinglist.

Please do not publish any of the non-released test binaries or svn-compiles on software sites or on user-forums. We have had bad experiences with this before and we do not appreciate it.

== Prerequisites ==
* Mac OS X 10.4.x (Tiger) or 10.5.x (Leopard)
* Xcode 2.4.x or Xcode 2.5

Optional:
* Subversion

Mac OS X 10.4 (Universal) SDK (a part of Xcode) is required to build the external libraries of VLC.

Your GCC version should be set to 4 (the default setting).

Xcode can be found online or on the Developer Tools disc, which accompanied Mac OS X.

Compiling with earlier releases of Mac OS X and/or Xcode will not work.

''If building {{VLC}} on Mac OS X 10.5 Leopard, be sure to read the paragraph on this specific version below, before proceeding.''

=== Mac OS X 10.5 Leopard ===
Note, that only VLC's current development trunk can be compiled on Mac OS X 10.5 Leopard. While the 0.8.6 series, when compiled on Tiger, works on Leopard (as expected), no current stable branch compiles on Mac OS X 10.5 Leopard.

As widely published, this version of Mac OS X includes a new release of Xcode, called Xcode 3, which includes many cool new features, but unfortunately, it is incompatible with VLC. You need Xcode 2.5 to compile VLC on Leopard, which can easily be installed in addition to your Xcode 3 tools. However, you need to edit your PATH variable before doing anything with VLC's source. In case that you installed to to the default location (<code>/Xcode2.5</code>) and you are using the default shell (<code>bash</code>), this is pretty simple:

<code>export PATH=/Xcode2.5/bin:/Xcode2.5/sbin:/Xcode2.5/usr/bin:/Xcode2.5/usr/sbin:$PATH</code>

Note that you need to repeat this PATH edit every time you relaunch the shell. You can avoid this by editing your bashrc file. Once Apple releases a fixed linker for Mac OS X Leopard, this work-around will not be necessary anymore and you can use Xcode 3 as expected.

Starting with Leopard, Xcode may be installed to a custom location on the administrator's choice. While this is non-problematic for ordinary Xcode projects, VLC needs a little help. You have to place extra symbolic links in /Developer pointing to your custom location for these folders:

<code>usr, Headers, Private, SDKs, Tools, Makefiles</code>

You can easily create these links by executing the following command for each folder (whereas theFolder is one of these six):

<code>ln -s /full/path/to/Developer/theFolder /Developer/theFolder</code>

=== Regarding Fink ===
If you have Fink installed, then you will need to disable it. {{VLC}} has it's own form of Fink (in the extras/contrib subdir) and it can conflict with Fink. We use this system to generate a reliable, consistent and known amount of packages that {{VLC}} requires.

''To disable Fink comment the line: #source /sw/bin/init.csh in your .cshrc file or . /sw/bin/init.csh in your .bashrc file in your home-directory.''

== Steps ==

Please follow these steps for compiling:

=== Get the source ===
Download the {{VLC}} [[GetTheSource|source code]] using [[subversion]] (as described on the [[GetTheSource| "Get the source"]] page) or get a recent source tarball. Note that the 3rd party libraries will probably break a few months after the release's publication.

These instructions below are always for the currently unstable, non-released code.

If you compile from [[Subversion]] then please remember that this code can often be in an unstable state.

=== Build external libs ===

We now need to build the [[Contrib_Status| 3rd party libs]]. For that, you will need to:
* cd to the source directory with your Terminal application.
* cd to the extras/contrib subdir of VLC and execute <code>./bootstrap</code>
* Now execute <code>make src</code>. This will download and compile all the required external libraries and programs. You will only have to do this once. (You can do it again if required libraries are added or updated by the team.)
''If bootstrap exits with an error message on Mac OS X Leopard, check the paragraph on this version above.''

=== Prepare the VLC build ===
Now we return to VLC itself. Go back to the top level VLC source directory. If you use Subversion (which you really should), then run <code>./bootstrap</code>.

This will create configure and Makefiles for {{VLC}} (snapshots and releases already include this).

=== Configure the VLC build ===

The next step is to configure, in the top level VLC source directory.

In current trunk revisions, you can simply run <code>./configure --enable-debug --with-macosx-sdk</code> to get VLC in its default configuration. If do not want to use VLC's default configuration for Mac, be sure to add <code>--disable-macosx-defaults</code> to your custom set.

When compiling earlier revisions or the 0.8.6 branch, you need to give a wide variety of configure flags to achieve a useful build. We used to use this set:
<code> ./configure --enable-debug --disable-x11 --disable-xvideo --disable-glx --enable-sdl --enable-mad --enable-libdvbpsi --enable-a52 --disable-dvdplay --enable-dvdnav --enable-dvdread --enable-ffmpeg --enable-faad --enable-flac --enable-vorbis --enable-speex --enable-theora --enable-ogg --enable-shout --enable-cddb --disable-cddax --enable-vcdx --disable-skins --disable-skins2 --disable-wxwidgets --enable-freetype --enable-fribidi --enable-caca --enable-live555 --enable-dca --enable-goom --enable-modplug --enable-gnutls --enable-daap --enable-ncurses --enable-libtwolame --enable-x264 --enable-png --enable-realrtsp --enable-lua --disable-libtool</code>

You can add <code>--with-mozilla-sdk-path=./extras/contrib/gecko-sdk --enable-mozilla</code> to the configure-line to enable the compilation of VLC's Safari/Firefox plugin.

=== Build VLC ===
After configure is finished, we can finally build {{VLC}}. A simple <code>make</code> will do the trick. If you want to use the resulting application package on a different Mac or a different account on the same Mac, run <code>make VLC-release.app</code> afterwards. Use the resulting ''VLC-release.app'' for these purposes.

== History ==
Written by Jean-Alexis Montignies, [[User:Fkuehne|Felix Paul Kühne]] and Derk-Jan Hartman, for the VideoLAN Team.
Adapted to the Wiki by [[User:j-b|Jean-Baptiste Kempf]]. Edited by Jesper Stemann Andersen.

[[Category:Building]]
[[Category:Coding]]

== regarding "How to disable Fink" ==

On 10.5.6 with current fink I found the fink initialization in .profile as
<code>test -r /sw/bin/init.sh && . /sw/bin/init.sh</code>

Suggested new wording:

''To disable Fink comment the line: ''<code>#source /sw/bin/init.csh</code>'' in your .cshrc file or ''<code> . /sw/bin/init.csh</code>'' in your .bashrc file or ''<code> test -r /sw/bin/init.sh && . /sw/bin/init.sh</code>'' in your .profile file in your home-directory.''

== Proper way to initialize the environment ==

On my point of view its not a good idea to skip

<code>
export CFLAGS="-arch *"

export CXXFLAGS="-arch *"

export LDFLAGS="-arch *"

export OBJCFLAGS="-arch *"
</code>

Without, my system will get confused and secondary its the most proper way to initialize the environment.

Greets

Talk:Frequently Asked Questions

2008-01-05T03:59:55Z

Ajmas: New page: Consider adding something on ffmpeg: '''Question:''' The version of ffmpeg that comes with vlc doesn't do x, but the latest release of ffmpeg can, when will ffmpeg be updated? '''Answer:...

Consider adding something on ffmpeg:

'''Question:''' The version of ffmpeg that comes with vlc doesn't do x, but the latest release of ffmpeg can, when will ffmpeg be updated?

'''Answer:''' ffmpeg is updated when ever there is a minor version updated. For example 0.8.9 to 0.9.0 (major.minor.debug)

Also something about why Mac version is missing feature x when Windows and Linux have it.--[[User:Ajmas|Ajmas]] 04:59, 5 January 2008 (CET)