Documentation:Modules/gather

Module: gather
Type	Stream output
First VLC version	-
Last VLC version	-
Operating system(s)	all
Description	Recyle video and audio elementary streams when possible
Shortcut(s)	-

Makes it possible to stream a playlist without any noticeable interruption on input change on the client side. The audio and video streams must all have the same characteristics (codecs, bitrate, dimensions, etc.).

Example

% vlc playlist.m3u --sout "#gather:std{access=http,mux=asfh,dst=:8080}" --sout-keep

If your playlist items use different codecs or have different sizes, it is advised to transcode. For example:

% vlc playlist.m3u --sout "#transcode{vcodec=DIV3,vb=512,width=640,height=480,acodec=mp3,ab=128,samplerate=44100,channels=2}:gather:std{access=http,mux=asfh,dst=:8080}" --sout-keep

or another like it

% "PATH_TO_VLC" -vvv FILE1.EXT FILE2.EXT FILE3.EXT ETC.ETC --sout-keep --sout=#gather{} --sout=#transcode{vcodec=h264,vb=1024,scale=1,acodec=mp4a,ab=192,channels=6}:standard{access=file,mux=ts,dst=out.mpg} --sout-all

no transcoding is necessary if all streams match

% vlc go.ps.1 go.ps.2 go.ps.3 --sout "#gather:std{access=file,mux=ts,dst=out.ts}" --sout-keep

It is unclear whether using --sout-keep automatically sets gather automatically or not http://forum.videolan.org/viewtopic.php?f=14&t=80695

See also How_to_Merge_and_Transcode_Multiple_Videos

This page is part of official VLC media player Documentation (User Guide • Streaming HowTo • Hacker Guide • Modules)
Please read the Documentation Editing Guidelines before you edit the documentation

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.