Updated PiWall start up Instructions

Skip to first unread message

Kevin Young

Oct 10, 2018, 1:33:42 PM10/10/18
to PiWall Users


I decided to create a video wall using the Piwall approach outlined by the folks at http://www.piwall.co.uk/.  The UK project was started in 2013 (or so).  There have been lots of changes since.  There are also many places on the web where there is info on how to build a Piwall using the Raspberry Pi.  However, there was much that didn’t work with the current HW/SW.  I have just gone through the rather exhausting process of buying the parts and then getting the system to run.  Many of the online posts about this were helpful, but nowhere did I find an accurate set of instructions that told me how to do everything.  So, this is intended to be a documentation of the steps that were needed to make my Piwall work.

I have a collection of 17 inch VGA monitors that were going to be scrapped.  These instructions detail creating a 3x2 video wall.  Since the Pi has HDMI video out, I used a cheap Amazon HDMI to VGA conversion cable.  Worked fine.

First, I used the current version of Raspbian, named Stretch (as of 1 October, 2018).  I imagine there is a version number associated with it, but I didn’t find that (with a rather cursory check). I also used Raspberry Pi 3 Model B’s.

Much of what follows are instructional posts from other places with corrections (which I imagine were needed because of HW/SW changes).

I am totally new to the Raspberry and to Linux.  So things that are obvious to many were not obvious to me.  I have tried to add some level of help for those as ignorant as me.

Some Linux info

The editor in Raspbian is nano.  So, when you enter ‘nano’ you are opening the editor.  It is followed by a file name which will open the file if it exists in the current directory, or create it if it doesn’t.  To write out the file, enter cntrl o, CR.  To exit nano enter cntrl x.

Some commands require supervisory privileges.  This is provided by typing ‘sudo’ before the command.  So, to edit a file that requires supervisory privilege, you would enter

sudo nano filename

If you are at the command line, the command to shut down is

shutdown –h now

If you running in command line mode (not just as an open window on the desk top) and wish to go back to the Raspbian desktop, the command is


Installing the software

Note 1 You may wish to perform the relevant network configuration steps from the next section for each master and tile Pi as you install the software. Otherwise, you will have to reconnect screens and keyboards. To be clear, I did not do it this way- I laid out all of my Pi’s in front of a TV, plugged into power strips, and constantly switched my keyboard/mouse/HDMI from Pi to Pi each time I wanted to modify one. That worked best for me, but not necessarily everyone.


Note 2 You must have your HDMI source plugged into your Pi when booting it up (you boot the Pi by plugging in it’s power supply.) If you do not plug in your HDMI first, your Pi will not adapt to the resolution of the screen you later plug in to. You can also set the resolution manually once the Pi desktop is displayed.  You also must have a properly formatted card to boot correctly (explained in the following steps.)


If the master is not a Raspberry Pi then install ffmpeg on your Linux machine.


For all of your Pi’s, use the following instructions:


Insert your micro-SD card into a PC and format it to a FAT32 format. If you format to exFat or another format, your Pi will not boot.  NOTE: The SD cards that I bought were already formatted to FAT32, and they worked out of the box.


Download the latest Raspbian image and follow the associated instructions to write the image to the SD card. (Use the NOOBS option, as it’s easier.)  I did this on a Windows base PC.  I downloaded the zip file, extracted it and copied all extracted files and folders to the SD card.


Insert the SD card into the Pi, connect a keyboard and screen, and plug in your power to boot the Pi.


Follow the standard setup process; this will install your operating system and let you connect to your home network (you can connect via WiFi or ethernet) so you can browse the Internet.  Let the system have a user of pi, and no password.  This is important in the autostart function described later.

Open Terminal, and type the following command, then press enter (This string installs the video converter necessary to play your video):

sudo apt-get install libav-tools

Once done with that, update your Pi by entering these additional commands:

            sudo apt-get update

      sudo apt-get install libavcodec-extra-52

sudo apt-get install libgl1-mesa-dev


At this point, for the master, move on to network configuration in the Network Configuration section of this guide.


For each Raspberry Pi tile, perform these actions:

Plug in the peripherals (keyboard/mouse/HDMI) and boot your Pi. Open the stock web browser and navigate to this page to continue following these instructions.

Click here to download the pwlibs package and just "save" it.

From a terminal window, enter:

sudo dpkg -i /home/pi/Downloads/pwlibs1_1.1_armhf.deb

Click here to download the pwomxplayer package and just "save" it.

From a terminal window, enter:

sudo dpkg -i /home/pi/Downloads/pwomxplayer_20130815_armhf.deb

sudo apt-get install libegl1-mesa-dev

Now perform the network configuration for each tile from the Network Configuration section.

Network configuration

Each Pi needs to have a different IP address, and you want these to be static addresses. (If you do not change your IP’s to static addresses, your computer will randomly change them, which will make communicating between PI’s on a network impossible.)  For this guide, we'll assume a private address range of 192.168.0.*. (Replacing the * with the number of your choice).

For my Pi’s, I used the following:


Pi 1:

Pi 2:

Pi 3:

Pi 4:

Pi 5:

Pi 6:


To configure the IP address in Raspbian all you need to do is edit the dhcpcd.config file. To do this, enter:


sudo nano /etc/dhcpcd.conf


Append the following text to the end of that file (do not delete anything in that document).


#profile static_eth0

static ip_address=

static routers=

static domain_name_servers=


up route add -net netmask eth0



The static ip_address number should be the IP address you want to assign to the device. For a 4 screen system I used,,, and for the tiles, and for the master. I don’t really know what the /24 is. 


In order for the master to communicate efficiently with the tiles, it uses multicast addressing (where each packet sent by the master is received by all the tiles).  The rules and guidelines for using multicast addresses are complex.  If you are like me, don’t mess with them.  Just use what comes next in this Guide.   We'll use the address More on that in a bit.


Each tile and the master must be connected to an Ethernet switch which is isolated (not connected to the internet).


Reboot to use the new IP address


Testing the software

First, test a tile to ensure that it is working correctly. Start by connecting a keyboard to the tile and attaching a USB flash drive that contains a movie that the standard omxplayer can display. I have tried .mp4, .mov and.avi successfully.  With the file manager, find the USB drive.  Then just copy the video file to the /home/pi/Videos folder.


Now check that the video plays.  Command is


omxplayer /home/pi/Videos/movie.avi


Next verify that pwomxplayer can play the movie by typing


pwomxplayer /home/pi/Videos/movie.avi


Finally check that pwomxplayer can show a section of the video by typing


pwomxplayer --tile-code=42 /home/pi/Videos/movie.avi


This should display just the top right corner of the original movie, but magnified to fill the whole screen.



Note: for the following testing, use a 2x2 configuration only.  The pwomxplayer defaults to that if there are no configuration files present.  If you try anything else you will get a message that says ‘Have a nice day -)”.


Now, you’re ready to test the master in conjunction with one or more tiles. To set up the tiles, enter on each the following string (the colors are just to help with identification in the next steps):


pwomxplayer --tile-code=$n –o local udp://

Replace $n.  Make $n=41 for the top left tile, 42 for the top right, 43 for the bottom left, and 44 for the bottom right. This configuration is for a 4-screen PiWall. The ‘-o local’ parameter enables sound to the .  Some posts suggested the buffer size number to be 1200000. I used 2000000. For the network’s IP address, just use the from above.


If you need bezel compensation or are using other than the 2x2 wall, the instruction are covered later in the ‘Configuration File’ section.


On the master type:

 avconv -re -i movie.avi -vcodec copy -f avi -an udp://


Note: if the tiles are not successfully connected to the Ethernet switch, you will get the ‘Have a Nice Day -)’ error message.




The Pi can output audio on both the HDMI port and an AV 3.5 mm jack.  My monitors were VGA and had no speakers, so I needed to use the AV jack.  I used a cable that is used to take the audio and video from a 3.5 mm jack.  There are at least 2 sets of pin definitions, so you need to get the right one.  To see the definition of the AV jack, Look here.  To enable the AV audio, I selected that on the desktop (upper right corner).  I’m not sure this is necessary.


Since there is a significant delay between when the master sends a screen and the tile displays it, the audio needs to be taken from one of the tiles so that it will be synched to the video. 

The ‘-o local’ command in the pwomxplayer command tells the tile to output the audio to the AV jack.  Use ‘-o HDMI’ to output on the HDMI cable (I think, didn’t test that).


For the master, there is an ‘-an’ parameter that is in some of the posts.  That option disables audio, so it must not be in the command.  I only mention it in case you copy the avconv command from some other place.



Autostart with no keyboard attached


Obviously, you want the tile Pi’s to autostart without requiring any action other than application of power.  This took me quite some time to find a solution that worked consistently.  There is much written about this in general, but nothing that I found written really worked.  So, here is my solution.  You may be able to do better, but this works dependably.


On each tile enter the following (this will create the file startup.sh):


nano startup.sh 


sleep 2

echo start pwomxplayer

pwomxplayer --tile-code=41 -o local udp://


Save and exit.


The above creates the startup file for the top left, --tile-code=41, tile.  You need to modify this for each tile with the correct tile number for that tile.


#!/bin/bash line is required by Linux.


The sleep 2 was the secret to making it work.  Apparently there are asynchronous things going on during power up, and this was necessary to make it work correctly.


The echo command will show ‘start pwomxplayer’ on the screen when the startup file runs


Now we need to make this file executable with:


chmod –x startup.sh


This has created an executable file, starup.sh, which can be run at startup to call pwomxplayer.  Now we need call it during the startup sequence.  Do this by:


sudo nano ~/.bashrc


go to the bottom of the file and add:


bash /home/pi/startup.sh


Save and exit.


One more thing, we need the system to boot to the control line, not the GUI.  So, select the Raspberry icon on the upper left, then Preferences, Configuration, Select Boot CLI.


Now, test the tile. Disconnect the keyboard and mouse.  Restart.  It should finally end with ‘start pwomxplayer’ showing on the screen.  BTW, it will need to be connected to the Ethernet switch or you will get an error message.


Should you wish to go back to the GUI, you can enter startx, which will start the Raspbian GUI desktop.


Configuration File


I spent some time getting this to all work.  I am going to list what I did.  I would suggest that you use the same naming conventions that I have.  I tried doing several others, and they did not work for reasons which are not at all clear to me.


You need to create a configuration file that contains the basic configuration for the total wall.  This file is named  .piwall (notice the .).  The exact same file goes on each tile in the /home/pi/ folder.  It does not need to be placed on the master.


There is another file, .pitile (again note the .).  This goes on each tile, but is unique to each tile.  It contains the definition for that tile.  This file is simplest to create, so let’s do it first.  It is done with:


nano .pitile




Save, exit.


This is the correct file for the first tile.  Leave the text as it is. You use [title].  Do not put some other label in the brackets.  You need to do a file like it but with the correct id for each tile.  So tile 2 looks like


nano .pitile




Save, exit




Now for the .piwall file.  I am going to list my configuration file.   This contains the appropriate dimensions for my 6 displays.   There is a very good description of how to get the correct sizes here (near the end, labeled ‘Tile Configuration’).  A more thorough explanation is here.


This exact same file is to be placed on each of the tiles in the /home/pi/ folder. 


#overall dimensions







#tile 1 definition








#tile 2 definition








#tile 3 definition








#tile 4 definition








#tile 5 definition








#tile 6 definition








# config










The command on the master is:


avconv -re -i /home/pi/SampleVideo.mp4 -vcodec copy -f avi  udp://


If you are running ffmpeg on a Linux PC, the command is exactly the same, except substitute ffmpeg for avconv.


The command on each tile is:

pwomxplayer -o local --config=6bez udp://


Once you have it working, you will need to change the startup.sh file to this new command.




1.    If you want to play consecutive movies that have different resolution settings then you will either have to

o    stop & start all the pwomxplayers between movies with different resolutions or

o    re-encode all your movies to use the same resolution settings.

2.    The system doesn’t stop and restart gracefully.  You can stop the master with a Cntrl c.  Then wait for a bit.  All the tiles will freeze with the last frame.  Now, if you restart the master, the tiles will begin displaying images.  Sometimes they are in sync and sometimes not. 

3.    There is no fast forward or start in the middle of a file.  You must start at the beginning.

Jordan Fickel

Oct 15, 2018, 8:51:19 PM10/15/18
to PiWall Users
You are a LIFESAVER. Working on a 3x3 using the composite out into CRTs and a live video feed, working on zero Ws for each tile. This guide answers so many questions I had. Thank you!

Just FYI I’m getting an error when I try to install libavcodec-extra-52, so I’m just installing libavcodec-extra and hoping that works out. I’ll post more when I finally get it up and running.


Oct 16, 2018, 4:13:41 AM10/16/18
to PiWall Users
Hi Jordan,

I have problem setting up my ethernet switch? Please, would you be able to help? I created the following topic for help. Thank you

Brian Burke

Oct 25, 2018, 1:33:57 PM10/25/18
to PiWall Users
Hello!  Is there a way to make this work with images rather than video files?  I have it working with the video files.

esteban arauz

Nov 19, 2018, 1:28:10 PM11/19/18
to PiWall Users
Buenas Tardes 
Hay alguna manera de que el video se repozca en bucle ? Seria de mucha ayuda 




Nov 15, 2019, 4:12:26 AM11/15/19
to PiWall Users

~ $ sudo apt-get install libav-tools
Reading package lists... Done
Building dependency tree
Reading state information... Done
Package libav-tools is not available, but is referred to by another package.
This may mean that the package is missing, has been obsoleted, or
is only available from another source
However the following packages replace it:

E: Package 'libav-tools' has no installation candidate

Is ffmpeg replacing libav-tools now? 



Mar 9, 2020, 5:50:19 AM3/9/20
to PiWall Users
Yes ffmpeg replaces libav-tools. 

Daniel Chase

May 12, 2020, 11:18:47 PM5/12/20
to PiWall Users
I see that you tested your configuration with a 2x2 monitor set up. I'm working with a 4(down)x5(across) setup. Could you advise on how to properly label the displays in that case? Also, I know this is a basic question, but to create this kind of a wall do you use one file that is split across the displays or as many separate video files as there are monitors? I ask because the latter option would be preferable for my project. 

Thank you so much for taking the time! 

Ludovic Chougny

May 13, 2020, 3:06:18 AM5/13/20
to PiWall Users
0.0 coordinate is the upper left corner in the ..piwall file. For naming I just advise you to start numbering knowing that !

Morgan Sidle

Jun 23, 2021, 2:42:08 PM6/23/21
to PiWall Users
is there an updated guide?
Message has been deleted

Kevin Campos

Jan 6, 2023, 4:26:27 PMJan 6
to PiWall Users
could you share with me an updated guide?

David Nunes

Sep 24, 2023, 6:04:40 PMSep 24
to PiWall Users

Will this work with Raspberry Pi zero W on a private wifi?

Miles Prower

Oct 19, 2023, 2:45:46 PMOct 19
to PiWall Users
For anyone interested I've started using FPP Falcon Christmas (available on Raspberry Pi Imager) which has a lot more options and is more reliable. This mixed with Shutter Encoder to segment a video into sections is extra work initially but pays off with how customisable FPP is with playlists, scheduling and control (using any web browser over wifi or ethernet). 

I hope this helps someone. 

SchoolOnStage Muziek&educatie

Nov 5, 2023, 6:09:27 AMNov 5
to PiWall Users

im interested in your piwall solution. Ive downloaded FPP Falcon Christmas on two pi zero 2, s. Now im not shure what to do with the Shutter encoder. Is it placed on the tile pi? Did you get this setup running and did you documented that proces


Op donderdag 19 oktober 2023 om 20:45:46 UTC+2 schreef xwv...@gmail.com:
Reply all
Reply to author
0 new messages