Frequently Asked Questions

1.Which models of Raspberry Pi are needed and what about SD card?

piSignage supports Raspberry Pi 3 model B(recommended),2 model B, B+ and B. We have tested with pi Zero also.

Minimum of 8GB class 10 SD card from reputed brand is recommended.

2.What are the power requirements or why Pi is misbehaving or why pi is not connecting?

If you are powering your device from TV USB port, the power may not be sufficient to drive ethernet interface.Use separate power adapter which powers minimum of 0.75A. If the power is not sufficient Pi may misbehave, face connectivity issues and a 4 colour square is seen on the top right hand side of the screen.

3.What is Player ID?

It's a 16 digit number displayed in your welcome screen(e.g.: 0000-0000-7c45-9824) which is same as CPU ID of Raspberry Pi. Please note down this identifier in order to register your pi at the server.

4.What are the image/video sizes required to utilise the fullscreen?

piSignage screen size can be configured to 1280x720 or 1920x1080 in landscape mode and 720x1280 or 1080x1920 in portrait mode. Upload images and videos of these sizes to take advantage of full screen and aspect ratios. In case of multi-zone layout is selected please refer to the sizes of various zones here.

5.What video format is used by piSignage?

If you are using or piSignage server you can upload the popular formats of videos and they are converted in h264/mp4 format automatically.
If you are uploading directly to the player convert your videos to mp4/h.264 format before uploading. You can use open source video converters like Handbrake for this purpose.

6.What are file formats supported by piSignage?

piSignage Player supports mp4/h.264 video, all types of image, html5 content. Flash content is not supported. Streaming content links from YouTube, IP camera(rtsp://) and web links to show html static/dynamic pages are also supported. Zip file containing HTML assets can be uploaded and index.html in root directory is displayed on the screen. Heavy JavaScript pages may be sluggish due to CPU performance limitations.

7.How to configure the Network?

By default pi is configured to acquire network address from DHCP server via ethernet port. pi can also be connected to a smartphone via USB tethering. To configure Static address mode or configure wifi, please connect a USB keyboard and press F6 or Ctrl-N.

Same settings are available at http:// {{ your pi ip}}:8000/settings also.

8.Can piSignage player be connected to other admin and content servers?

piSignage player supports configurable admin/media servers which are by default point to need to be same as of now). They can be configured to point to other servers in one of the following ways.

  • Connect a USB kepboard and press Ctrl-N or F6
  • Under settings at URL http:// {{your pi address}}:8000
  • directly editing package.json file at /home/pi/package.json(be careful not to omit quotes)

Do not miss port number(:3000) in case of pisignage open source server after the IP address.

9.Can I have my own local server to manage piSignage players?

Yes. You can build your own local server using the open-source git repository. We also provide white-labelled server similar to for an annual license fee.

10.What are the other ways to discover & manage piSignage players?

  • In the local network, use Chrome Browser and load the url http:// {{ your pi address}}:8000 (use pi & pi or the one provided in your server settings as credentials)
  • Download Chrome app from Chrome store to discover players
  • Use Android app to manage the presentation on the TV

11.Why the boot time so high?

To make sure file system is not corrupted, we run file system check on every boot to increase reliability. Also we check the various network interfaces upon boot. We feel this is worth the wait for flexibility and reliability of the player.

12.How does the piSignage player communicate with server?

piSignage is built upon node.js and express framework. It uses HTML REST API to communicate with the server. Real time communication is achieved using WebSocket interface over standard http port(please enable websocket interface if you are using firewall). For progressive and retry-after-fail downloads "wget" is used.

13.Where can I find status and error information in pi?

The /home/pi/forever_out.log,/home/pi/forever_err.log and /home/pi/forever.log files keep the detailed log and error information.

14.How do I know the local server is up and running?

piSignage server is built upon MEAN stack. Make sure

  • mongod is running without errors and listening at port 27017
  • node is running and watch for any errors in the console, it should say listening at port 3000
  • Make sure the port 3000 is open for external access in your server
  • load the url http:// {{your server address}}:3000 in Chrome Browser and the UI should be loaded

If pi is not reported at server

  • able to ping server address from the pi
  • if you have edited package.json file make sure there are no syntax errors

15.What are the different passwords and how to change them?

Default user & password are "pi" and "pi". The different passwords are

16.After changing display settings (portrait mode or HD mode) pi automatically reboots and goes back to default settings

Server settings override the local piSignage player settings. So when pi connected to server it gets server settings which are different from the local settings and configures accordingly.

Change the display settings under server group settings.

17.Why some YouTube videos are not being playing?

We use livestreamer for YouTube streaming. Although it plays most of the videos, it does not play all Youtube videos (for e.g. protected videos).

18.How Do I replace pisignage bootup brand video with my own?

Just upload your brand video(format mp4) in assets with file name as brand_intro.mp4. Make sure video matches your Display settings under group(one of 720p,1080p,720x1280,1080x1920).

19.Why "Powered by PiSignage" ticker is appearing?

If license file is not available this ticker message will appear. Please purchase license from us and register the player to get the license downloaded(You have to register the player again if you have done registering prior to purchase).

20.Why is my pi Not showing up on web interface through USB tethering?

Select ethernet in DHCP mode. Remove ethernet cable. Connect android phone and enable tethering and 3G/WIFI on your phone.Traffic from pi should route through your phone now.

21.Why is pi rebooting automatically once more after first install of pi image?

To reduce the image download size, the image is created using minimal disk size. When it boots first time it resizes the partition to expand it use max capacity of SD card. After resize it reboots again.

22.How do I connect RPI with standalone PC?

Connect PC Ethernet port to Raspberry pi Ethernet port using normal Ethernet cable. No need of cross cable. Make sure both pi and PC have unique static IP addresses which are on the same subnet.

23.Is there any alternate software to burn image in Windows, Mac?

Yes ,
For Windows use Win32DiskImager
For Mac use Apple pi Baker

24.How can i check network connection is established or NOT?

Welcome screen will display network status. If network is down check network connection then reboot
Alternatively connect usb keyboard and ctrl+alt+t to open terminal and use linux tools ifconfig, ping etc to check connectivity.

25.In multi-zone layouts I do not want to change side or bottom zone content with every change of main playlist, can it be done?

Specify side and bottom files only when you want to change, otherwise previous content will continue to be shown.

26.How do I know what is in new release?

Release notes for piSignage player release can be found at github piSignage repository.

27.Do you have the dimensions for the graphic sizes for multi-zone layouts?

Please refer to the diagram for details.

28.How to insert Twitter Widget code to one of the zones?

  1. Create an file with extension as .html (say example.html)
  2. Insert default tags and add the twitter widget code inside tag as given in the example
  3. Upload the example.html file
  4. add this file to side zone for the first main file in the playlist assets
  5. While creating your widget file adjust the height to 720px/540px to occupy the full screen

Sample HTML with piSignage user timeline

<!DOCTYPE html> 
    <title>Testing Twitter Feed</title> 

<!-- Twitter Widget Code --> 
<a class="twitter-timeline" href="" data-widget-id="621992144652255232">Tweets by @PiSignage</a> 
<script>!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0],p=/^http:/.test(d.location)?'http':'https';if(!d.getElementById(id)){js=d.createElement(s);;js.src=p+"://";fjs.parentNode.insertBefore(js,fjs);}}(document,"script","twitter-wjs");</script>
<!-- End of Twitter Widget Code --> 

29.I'm running pisignage player on my own local server and shows the ticker "this player is powered by pisignage"

Easiest way to generate license is as follows
1. Create an account at and register the player there
2. Once player shows green at change the package.json field config_server and media_server in pi player to point to your local server
3. Make sure the installation name in pisignage-server file /config/env/all.js is same as that of your username in

30.How de we deploy an Advertisement Playlist?

To schedule a playlist as Advertisement

  1. Create an playlist with the items you would like to insert in between regular playlist at regular intervals.
  2. Select the "Make it Advt" button in the playlist screen, Mark the playlist as advertisement, Interval is specified in seconds (like after 60 seconds insert an item from this playlist as advt)
  3. Add the advertisement playlist as an scheduled playlist in Group (there is a +Add button)
  4. Press Deploy button in Group

32.How to load webpages and dashboards that require login?

The following are some of the methods to allow players to access web pages which require login. The Server team of such pages typically suggests solution which is used many a times.

  1. Many web dashboards allow secret URL or Shared URL generation. This URL bypasses login process and can be added to the PI. These URLs can be revoked anytime.

  2. Doing the authentication through standard http authentication by sending username/password via headers.

  3. OAuth type mechanism which piSignage follows to access Google Calendar (needs piPlayer side development). While adding the link server takes user concurrence to accept after which access is allowed using token mechanism.

  4. put ssh certificate of pi in known hosts file of server and avoid password entry.

33.Why the link from Google slides (got from publish to web option) shows a blank screen?

The link URL has SAMEORIGIN policy which prevents the slides from loading whereas embed option works. Change the "/pub?" portion of link with "/embed?" and slides should be displayed. Make sure to choose "Start slideshow after load" and "Restart after last slide" options for continuous play. Also set the duration of the asset in the playlist to a large value.

Also adding link as "webpage" will work for the urls that need SAMEORIGIN policy.

34.Can I change the screen which is shown when there is no playlist or briefly in the beginning?

Yes, you can upload an HTML file named welcome.ejs and the same will be displayed. You can also display local settings like CPU ID, IP address etc by writing ejs script. For variables and example file please refer to

35.Why Chrome app is not playing Youtube links fullscreen?

piSignage player automatically creates the fullscreen link. In case of PC the full screen link looks as follows

You can either construct this URL using the unique string you get on the link or use Share & Embed button to get the URL. Then add ?autoplay=1 to start playing automatically.

37.How to add Chromecast to piSignage

  1. After powering on Chromecast,, in a Chrome Browser(PC should be in same network), login at
  2. In the top menu bar on the right hand side you will see a Chromecast icon (in the same level as that of piSignage logo)
  3. click the icon and select start casting
  4. piSignage software will be downloaded and a ID will appear on the TV
  5. Register the ID at

38.Why there are no transition effects between images?

pi processor does not have enough processing power to have good transitions, so we have disabled the transition feature at the moment.

39.Certain earlier 1.6.1 SD image had wifi issues

To solve the same please issue
sudo apt-get -y install ifupdown & either from ssh terminal or from the server player shell. Then configure the wifi credentials.