Magic Video Wall logo

Magic Video Wall

Configure a full video wall by just taking one picture

Have a look at the demo video to get an idea of what this video wall package is capable of:

Configure the screens

After you imported this package into your account you'll first have to create a setup based on it. A setup allows you to create a video wall from a collection of screens. If you want to create multiple video walls, just create multiple setup. In the setup you'll first have to click on the Assigned devices tab and add all the screens you want to use. Then click back to the Configuration tab. You should see the screens you've just assigned. The first thing you'll have to do now is click on the Save button. This will instruct all assigned devices to show a configuration tag. Each screen should now show something like this:

A configuration tag

The next step is to take a picture of all your screens from the position of your future viewers. For example stand directly in front of all your screens and take a picture. Make sure all tags are visible.

Click on Upload/Capture Mapping Picture and select the picture you just created. Certain browsers, especially on mobile devices, also allow you to directly take a picture instead of selecting an existing picture.

If your browser supports webcam access you can instead use the webcam capture mode. Just click on the Camera Capture button. Your browser might ask for permission to access the webcam. Allow this access (Due to how the info-beamer configuration interface works, the live video stream //never// leaves your browser: All computation is done on your machine and is never shared with or any other site), then point the webcam to your video wall screens and click on either the live stream panel or on the Camera Capture button again.

After you've selected or taken a picture it might take a moment to automatically detect all the tags in the picture. If everything was successful, all screens items in the configuration interface should turn green. Just click on Save again and you're ready to show content on your video wall.

If your snapshot didn't detect all tags or some tags are covered, you can create more mapping pictures to configure your wall. Be sure to capture any additional snapshot from the same position you took the initial snapshot. Otherwise your mapping won't work. Additional snapshots allows you to create setups that include partially occluded screens: First create a snapshot with all the screens in the "bottom layer". Then, while keeping the camera in the same position, add more screens on top and create more snapshots to complete your setup.

Changing the mapping

If you're not satisfied with your configuration, just click on Reset mapping. This will remove the previous mapping configuration and allows you to create a new one. Make sure you click on Save so all screens show the configuration tags again.


You can have screens in any orientation. They can be rotated in almost any direction as long as the tag is still detectable by the configuration system. Be aware that a wierd arrangement might only look good from the position you took the mapping picture.

If you want to create a video wall that works from any angle, be sure that all screen surfaces are planar.

Make sure you get as close to your screens as possible as the video/image you show on your screens will be scaled according to the mapping picture you took. The further you're away from the screen, the less of the content you'll see on them later.

I'd suggest you just play around with them a bit to get a feeling of how the mapping system works.

Right now the package is limited to 32 screens. This isn't a hard limit and exists because only the first 32 tag images used to detect orientations are included with the package. If you want to use more than 32 screens, get in contact and the package can be updated.

Set a playlist

Click on the node labeled Playlist Configuration on the left side of the configuration screen.

You can add images and video assets to your playlist. If you make changes to a playlist and click on Save, your devices will go black for a short moment until they are all back in sync. Therefore it is recommended to make all changes to a playlist and save only once.


This package as experimental support for live streaming. Just enter a stream url and your device will play that stream instead of the configured playlist.

Since there is no communication across devices running a video wall setup, synchronization is tricky. Right now streaming really only works if you configure a RTP multicast stream. You can use the "Multicast Video Streamer" to generate such a stream from a connected camera module. Learn more about the package:

Multicast Video Streamer

by Florian Wesch <>

Receives video from various sources and multicasts it to the local network as RTP stream

Learn more..

Release history

Version 'pi4'

Now compatible with the Pi4. In addition the way the "Camera Capture" feature is implemented has been updated and should work with recent browser versions again.

Version 'incremental'

The package now allows incremental mapping. This allows you to configure partically occluded screens by taking multiple configuration pictures from the same location.

Version 'stream'

Added experimental streaming support

Version 'webcam'

Added webcam support to the configuration interface.

Version 'preview'

This is the first public release. While it works, there might be problems. If you find anything, please open an issue on github.

Want to run Magic Video Wall on your Raspberry Pi?

This package is ready to run on your Raspberry Pi using hosted. Easily manage unlimited number of Raspberry Pi devices and centrally configure and run visualizations like this on them. is a prepaid service. You only pay for the resources you are using. No long term commitment, no hidden fees. Learn more...

Compatible devices

pi-0 pi-1 pi-2 pi-3 pi-4 pi-cm1 pi-cm3

Source code for this package shows you the full source code of this package so you can freely modify it if you want.