Setup Linux

At Play Digital Signage, we love Linux. We’ve packaged Linux executable in AppImage format that is supported on most Linux distributions these days with just a few clicks.

Using Raspberry PI?

Check out our Raspberry PI setup guide!

1. Remove AppImageLauncher

Starting in 2018, Linux desktop environments started including an external program to manage and better integrate AppImages. This program is wonderful for regular users, however for an unattended digital signage setup it adds a layer of software that is beyond our control. We recommend uninstalling appimagelauncher before proceeding. On Debian based systems you can remove it with following command:

sudo apt-get remove --purge appimagelauncher

2. Download Linux executable

Click here to download the player software

Using device with ARM processor? Click here to download armv7l player software

3. Set executable permissions

By default Linux does not give execute permissions to files downloaded from the Internet, therefore you need to grant the permission. Most file managers enable to do it by right-clicking on the file, going to Properties and finding either a checkbox for making it executable of selecting from drop-down Execute “Anyone”. This process varies a little depending which file manager is your Linux distribution using.

Making PlaySignage AppImage executable

If you prefer the console way, you can also do that with a following command:

chmod +x PlaySignage-*-x86_64.AppImage

4. Launch it!

You can now launch the application by double clicking on it.

5. Link the screen

You can link the screen to your account on the screens page by entering the 6 character code shown on the screen.

6. Configure auto start (optional)

We don’t configure Linux to launch our player automatically as it is likely that you will first test it on your computer before installing it on a dedicated player.
However when you install it on dedicated player, don’t forget to go to Settings and turn on Launch player on startup option.


I got my screen linked, what next?

We recommend checking out our 5-minute video guide on getting started, it covers most of the basics.

Where are the files stored?

The player saves files to ~/.config/PlaySignage/assets
Please note that the .config folder is not visible in Linux by default.

Can I run several instances of the application?

By default, the application enables a maximum of one window, however in situations where you have a Linux machine with several monitors you may need to run one player application per each monitor. To do this, you need to set a different data directory for each application window using the --data-dir parameter, for example:
~/Downloads/PlaySignage.AppImage --data-dir=/home/playsignage/play-app2

The mouse cursor is visible after restart?

When running Linux, you can install a program to hide the cursor. By default unclutter will hide the cursor if it’s not moved for 5 seconds.

  • Ubuntu sudo apt-get install unclutter
  • Arch sudo pacman -Syu unclutter

After installing you can test unclutter by launching it in the terminal with unclutter command. If it works for you, be sure to add it to startup programs!

I’m getting an error about the “SUID Sandbox helper binary”?

Our application creates a namespace sandbox, however on some Linux distributions this option is disabled, there are 2 possible solutions:

  1. Enable apps to create namespace sandbox: sudo echo ‘kernel.unprivileged_userns_clone=1’ > /etc/sysctl.d/00-local-userns.conf
  2. The second option is to disable the sandboxing and run our. AppImage with --no-sandbox flag

More info here:

How do I update the player software?

There is a built-in auto-updater, however, in certain circumstances, the software is not automatically updated. You can apply the update manually without having to link the screen again:

  1. Close player application if it’s running.
  2. Download the latest version.
  3. Make the downloaded file executable (see step 3 above).
  4. Start the newly downloaded.AppImage file.

The plugins don’t work

If one or more plugin doesn’t work on your Linux, it’s possible that the PlaySignage app on your player device is out of date. Click here to learn more.

How do I access OPTIONS if I disabled the top menu bar?

In the APP options, you can hide the top menu bar if you for example are running a touch screen. To access the top menu bar, when hidden, you can use CTRL + O for options or CTRL + Q to close the APP.