Sean McIntyre · designing technology to create art

Stream a slideshow of images with VLC 1.1.x

A task I've found myself having to complete over and over again is streaming a slideshow of images over a LAN. Today, I've found yet another solution to do this using the VLC server.

The VLC approach

The basic idea of this is to host a streaming media server to send encoded video of the slideshow images to whomever requests it using their computer's media player.

The VLC project includes a handy streaming server that makes this magic happen. (At first I researched ffserver, but was pointed to VLC by this post.)

We use the VLC fake module to have the streaming server reload a specified image once a second and encode it into an H264 video stream.

This is the script I used to launch my VLC streaming server. e.jpg is my specified file.



# option --fake-fps will not work with value less than 4

    vlc -vv  --sout "#transcode{vcodec=h264,vb=$bitrate}:standard{access=http,mux=ts,dst=$host:$port}"  fake:// --fake-file=$file --fake-file-reload 1 --fake-fps 4 -I dummy

Instead of making e.jpg a real file, I made it a symlink that I'm constantly changing. The following script looks inside the present working directory and cycles e.jpg through all the images in the directory.


while [[ 1 ]]; do
  for i in *.jpg; do
    ln -fs $i e.jpg
    sleep 1

Every time VLC reloads e.jpg, the stream produces another image. The stream can be opened up by a client video player to see the slideshow. Voila!

Pros and cons

Advantages to using VLC for this are:

Disadvantage of using this approach:


Let it be known what my computer setup looks like.

$ cat /etc/lsb-release 
$ vlc --verison
VLC media player 1.1.9 The Luggage (revision exported)

This trick may not work with VLC 2.x because they moved away from the fake module to the image demuxer*.

My original (inferior) approach

I would use bash scripts to automatically resize images using imagemagick and rsync files across the LAN to the slideshow host computer. I hacked a Processing application to play a slideshow of the images, and reload the file list.

This approach was cumbersome due to juggling configurations on multiple computers, the need to install Processing on the slideshow host computer, and the jankiness of my Processing app because of memoryleaks (crashing occasionally) and the inconsistency of fullscreen.

I don't blame Processing for all of the problems, the "easy solution" is just not as straightforward as it appears.

comments powered by Disqus