About | Download | FAQ | Changelog

WRITE INSTRUCTIONS

In order to write the IMG file (extract it from the downloaded ZIP file, first) to the Raspberry SD card (4GB minimum), Windows users can use Win32DiskImager, while Linux users can make use of dd and Mac OS X users should follow this guide. A SDHC class 10 card is highly recommended.

Help with Win32DiskImager can be found on Sabayon website or on YouTube.

Help with dd (run as root or with sudo) follows:

  • plug the SD card into your PC;
  • tail -f /var/log/messages or tail -f /var/log/syslog or fdisk -l for locating the assigned device file, for example: /dev/sdx (change for your case);
  • umount /dev/sdx1; umount /dev/sdx2
  • dd if=path/to/imageFile.img of=/dev/sdx bs=1M (dd always refers to the whole disk, so do not use /dev/sdx1 for example).

Once you have successfully written the IMG file to the SD, you have to plug the card into the R-Pi and restart.

Louis DeRobertis reports that some HDMI to VGA converters do not give enough power to the screen.

During everyday usage, if you intend to power the Pi off I strongly advide you to do via SSH or to schedule a cronjob which will turn off the Pi gracefully.

 

OPERATING SYSTEM

SSH LOGIN (donors’ version)

You can perform an SSH login using the following credentails.
Putty.exe or similar software is required for Windows users while of course *nix users will make use of the ssh client.

  • user: pi
  • password: live
  • then type: sudo -i for administrative rights

Raspberry IP address is always shown during the boot. Alternatively you can make use of network discovery apps for your smartphone or netdiscover tool for *nix systems to find it out.

When maintainance screen password is modified, SSH password will be changed accordingly. So, if you set a password for the admin interface, the new SSH password will be identical. This way you can protect both system settings change via browser (admin interface) and via SSH with one step.

CHANGE CONNECTION METHOD

Raspberry Digital Signage defaults to DHCP if network cable is plugged in. If you need to override this behaviour:

  • unplug the Ethernet cable and reboot;
  • network interfaces admin screen will appear;
  • change network settings as you wish; they will persist then across reboots.

In any other case (wireless, Ethernet/static), just delete network configuration files in the /iwk folder via SSH.

Wi-Fi support (Raspberry Pi 1 and 2)

While the Raspberry Pi 3 has got an internal Wi-Fi adapter, Raspberry Pi 1 and 2 do not have, so you need to plugin a 802.11 adapter.

Supported adapters’ firmware can be added with the following command via SSH as the root user:

apt-get install -y linux-wlan-ng firmware-linux-free dahdi-firmware-nonfree firmware-atheros firmware-bnx2 firmware-bnx2x firmware-brcm80211 firmware-intelwimax firmware-ipw2x00 zd1211-firmware firmware-ivtv firmware-iwlwifi firmware-libertas firmware-linux-nonfree firmware-myricom firmware-netxen firmware-qlogic firmware-ralink firmware-realtek libertas-firmware

Do not install linux-wlan-ng on the Raspberry Pi 3, its firmwares conflict with the builtin 80211 module.

UPDATE THE UDERLYING RASPBIAN OPERATING SYSTEM

Login via SSH as root, then:

apt-get update
apt-get dist-upgrade

Since PIXEL release, it seems that Raspbian or upstream team broke something when updating xorg. Please do not upgrade your systems via apt-get until further notice. Ramón Gutiérrez suggests the temporary hack of chmodding +rw /dev/tty* in /etc/rc.local, as a fix.

WTF IS THAT COLOURED SQUARE NEAR THE TOP-RIGHT CORNER?

If you see a coloured square near the top-right corner of the screen, your Raspberry Pi is saying the power supply is not powerful enough. Just use the official one for example.

ADJUST DATE AND TIME

The quickest way to adjust date and time according to your local time is to use ntpdate pointing an NTP server near you. For example: ntpdate ntp1.ien.it for Italy. SSH access required.
You can also set the time and date directly with the use of date -s command. SSH access required.

You can set your timezone with dpkg-reconfigure tzdata command. SSH access required.

1920 x 1080p

Modify /boot/config.txt file this way (thanks to Mark van der Linden, Brunner Armin and Guilherme Simões):

disable_overscan=1
hdmi_group=1
hdmi_mode=16 or hdmi_mode=82

Use mc -e /boot/config.txt via SSH.

SCREEN ROTATION AND TOUCH DEVICES

The screen rotation setting is available in the admin page of Raspberry Digital Signage; however touch devices need further adjustment. Identify your touch device via SSH as root:

DISPLAY=:0 xinput --list

Put the case Quanta OpticalTouchScreen is the name of your device, type in the following:

DISPLAY=:0 xinput set-prop 'Quanta OpticalTouchScreen' 'Evdev Axes Swap' 1
DISPLAY=:0 xinput --set-prop 'Quanta OpticalTouchScreen' 'Evdev Axis Inversion' 1 0

If commands succeed, you can put them in /home/pi/.xinitrc, just before the # Launch window manager line.

WHICH TOUCH SCREEN HARDWARE TO CHOOSE

Have a look at this resourse. Some people also reported that EloTouch and GeneralTouch monitors work well with Debain, so they should work under Raspbian (RDS), too.
Pi Touch Display is 100% supported.

GOT A LARGE SD CARD? HOW TO EXPAND FILESYSTEM

Just install and use raspi-config:

  • login as pi user via SSH, then sudo -i;
  • apt-get update && apt-get install raspi-config
  • raspi-config
  • follow easy instructions.

REMOVE ALL/ANY RASPBERRY DIGITAL SIGNAGE CONFIGURATION(S)

Just delete configuration files in the /iwk folder via SSH.

 

DIGITAL SIGNAGE AND SOFTWARE

HOW TO KEEP MOUSE POINTER ALWAYS HIDDEN (useful for touch screens)

Edit the /home/pi/.xinitrc file modifying the matchbox line as:

exec matchbox-window-manager -use_titlebar no -use_cursor no &

Thanks to Stephen Wille Padnos and Neil Wright.

Use mc -e /etc/rc.local via SSH.

HOW TO SET VNC SERVER PASSWORD

Follow the setps below:

  • login as pi user via SSH (do not sudo);
  • run x11vnc -storepasswd ~/.vnc/passwd.

Paweł Glica pointed out that VNC is configured to close session after first time login and suggests to add -forever to the line with x11vnc in /home/pi/.xinitrc. Parameter added by default since Raspberry Digital Signage version 5.0. Thanks.

HOW TO ADD A PSEUDO-NAVIGATION PANEL

In order to properly function, digital signage resources should not open popups – in this case a full-screen popup would be displayed, with no way to close it.

For the Chromium view, however, you can install Tabtiles extension (in the admin interface) and persist Chrome settings: it will show an useful pseudo-navigation menu. Thanks to Marco Spreafico.

HOW TO SLIDE MULTIPLE WEB RESOURCES

For the Chromium view, you can try installing Revolver extension (in the admin interface) and persist Chrome settings. According to project description, “This was created for using Google Chrome full-screen to power unattended screens where rotating dynamic/live web content is needed”.

HOW TO HIDE BROWSER SCROLL BARS

In order to be properly viewed, digital signage resources should open on a single page without scroll.

For the Chromium view, however, you can install No Scroll Bars Please! extension (in the admin interface) and persist Chrome settings: it will do the trick. Thanks to Tom Häggblom.

PLAY CONTENT FROM THE INTERNAL SD CARD

Raspberry Digital Signage admin interface allows you to type in the URL of the web resource to be displayed; it can be an Internet one (http://www.binaryemotions.com), a LAN URL (http://192.168.1.100/booking; http://booking.local), or even a resource located internally, inside the Raspberry Pi.

In the latter case, just copy your website files inside the system to /var/www/mySite as it was a normal webserver, give at least 700 permissions for the www-data user (chmod -R 700 /var/www/mySite; chmod -R www-data:www-data /var/www/mySite) and set a URL like: http://127.0.0.1/mySite in the admin interface. This way you can natively serve plain HTML and PHP files.

You can copy files into the Raspberry Pi with (win)scp or simply by linking a Dropbox/Google Drive/DigitalArx resource and using wget Linux-side in order to download it.

OK SO NOW EVERYTHING IS SET UP. I WANT RDS TO BOOT DIRECTLY IN KIOSK MODE (URL).
HOW TO?

On first boot, Raspberry Digital Signage shows the network admin page and then the general settings admin page. At every following boot, if network has been configured, Raspberry Digital Signage goes directly to general settings.
Now I want RDS to boot directly into kiosk mode, i.e. show my URL right after the bootstrap.

Just add the line:

touch /tmp/iwk.strictKioskMode

in /etc/rc.local file (everywhere before the launch of xinit). Use mc -e /etc/rc.local via SSH as root user.