PiNet Screens

Warning - PiNet Screens is still an experimental application that is being actively developed.

PiNet Screens is a web based management tool for configuring PiNet to be used with multiple display screens across an organisation.

The features of the system include:


Before PiNet Screens can be installed, make sure PiNet is installed. PiNet Screens must be installed on the same operating system that PiNet itself is installed on.
PiNet Screens supports PiNet Stretch and above. PiNet Jessie/Wheezy are not formally supported.


The PiNet Screens system is split into 3 main sections. Login, Clients and Content. Once logged in, you are presented with the clients page. From the clients page you can assign content to individual Raspberry Pis. On the contents page, you can create this content that is assigned to individual clients.


The first step in using PiNet Screens is logging in. Navigate to http://localhost on the PiNet server, then enter your credentials you created on setup.


From the clients page, you can create new clients, edit clients, disable clients or edit the content displayed on them.

Usually clients are automatically added when they first start up, but if you need to manually add a client, you can do so from the 3 boxes at the top of the page. Also, if you click the edit button on any pre-existing client, these boxes will populate to allow for editing.
Once added, content can be assigned from the dropdown box of content. When new content is applied, the Raspberry Pi will generally notice within 60s and update its display.

If for any reason a client needs to have PiNet Screens disabled on it for maintenance for example, clicking on the status switch will disable PiNet Screens.


To have anything display on the Raspberry Pis, content items must be created. There are 2 types available.

  1. Browser content - This is a URL that will be displayed full screen using Chromium in “kiosk mode”.
  2. Custom scripts - This allows for custom scripts to be built and run.

Once content has been added, you can see a list of clients it is currently running on, along with removing the content if needs be.

User management

The PiNet Screens system includes a simple user management system that is separate from the main web tool. To run it, launch a terminal and run the following commands.

sudo su pinetscreens -p
cd /opt/PiNet-Screens/pinet_screens

From here, you can create a user, remove a user and change the users password.

Debugging / Issues

PiNet Screens isn’t accessible when navigating to its URL.

PiNet Screens web page throws an error on hitting the “Apply configuration” button

This usually means the permissions to the files/folders edited by the apply are incorrect. The quickest way to resolve this is rerunning the PiNet Screens install script, which will correct any permissions.
The permissions required include:

Info - PiNet Screens was commissioned by Decora Blind Systems Ltd and permission has been agreed to allow the application to be released open source under the MIT License.