Creating Easy Digital Sign With Raspberry Pi 3
Raspberry Pi: I recommend a Raspberry Pi 3. On campus I use the CanaKit that comes with everything needed to use your RaspberryPi 3 for this and many other projects. The link below will take you to the kit we use on our Campus.
***NOTE*** This tutorial is for the GUI Version of RpiKiosk to create a digital sign or kiosk. I will write up a different tutorial for the CLI Version.The RpiKiosk program and this tutorial were designed for use with a raspberry pi 2 or 3 with armhf architecture.
1. The first thing you will need to do is install Raspian onto your raspberry pi. To Install Raspian Stretch to your pi please go to https://www.raspberrypi.org/downloads/raspbian/ and follow the instructions there.
2. Next, the gui version of this tool does have a dependency to work correctly. You will need to install the "dialog" package in order to use the GUI version of this tool. You can install "dialog" using the following command on your Pi in the terminal:
3. There are also a few packages that these scripts do not directly depend on but will help the user should the want to make further changes. The RpiKioskInstall script will look for these and install them if they are not found on your pi. However, if you wish to install them before running the script then run the following commands on your pi in the terminal:
The "git" package is for users that are familiar with using git and want to clone the RpiKiosk Repository rather than downloading the zip file. "Vim" is simply a terminal text editor. This package is not crucial but will be of benefit if you are an advanced linux or pi user."unclutter" is a package that will hide your pi's mouse cursor when it is not being used. This is good for locations that your kiosk or digital sign will not be within reach of public. In the case that your kiosk or digital sign is within reach of public, the RpiKioskCursorDisable script will allow you to completely disable your mouse cursor on your pi. (This can be reverted using the RpiKioskCursorEnable script)
DEB PACKAGE USE ONLY
If you wish to download the deb package version, download the file RpiKiosk_1.2-0.deb NOTE: if chromium complains about the file being unsafe and wants to discard the file, go to your chromium settings then to the "Privacy and Security" section. Once there you will need to temporarily turn off the safe browsing option. Remember to turn this back on after the download is complete. Then run the following commands:
If the install fails and complains about a dependency then install the "dialog" package using:
Now you can simply run the following command in the terminal and follow on-screen prompts and options.
From here you can select what you would like to do: Install, Uninstall, Enable Mouse, Disable Mouse.
RUN RPIKIOSK FROM CLONE OR ZIP DOWNLOAD
1. Clone the RpiKiosk Repository from https://github.com/jharttech/RpiKiosk.git:
1. Download the RpiKiosk zip file from https://github.com/jharttech/RpiKiosk/archive/master.zip to your pi, then extract the files:
2. Go into the RpiKiosk folder and move files to the correct location.
3. Run the Install Script (If you did not download the deb package version)
From the Main menu you can select what you would like to do. You can choose between: Install, Uninstall, Enable Mouse, Disable Mouse.
In the Main menu you can choose between: Install, Uninstall, Enable Mouse, Disable Mouse. Install: This will start the Installation script and will walk you through the setup of your kiosk or digital sign. Simply follow the script and answer with the desired inputs. Uninstall: Uninstall will start the Uninstall script and will revert all config files back to the pi defaults. Enable Mouse: Enable Mouse option will start the Enable Mouse script. If you disabled the mouse during initial installation this will re-enable your mouse cursor without uninstalling the kiosk. Disable Mouse: This option will start the Disable Mouse script. If you did not disable the mouse during initial installation this will allow you to do so should you feel the need.
I recommend you setting up a free Dakboard account at https://dakboard.com/site. This company will help you quickly set up a nice digital display for free. (The free version is limited on customizations)
Screen Orientation: This setting is dependant upon which way your digital sign (monitor or TV) is mounted. Your options are "Landscape" or Portrait".
Enter your URL: First the Install script will ask you for a URL to your kiosk, video, or slideshow. If you are using DAKBoard, you will find this url under your account settings. It will be called your Private URL. If you are using google slides this will be your public published URL. This URL can be a URL to any type of legal media that you wish to display on your digital sign.
Disable Mouse Cursor: Second the Install script will ask if you would like to disable your mouse cursor. If you choose to do so, you can revert this at a later date by running the EnableCursor.sh script. If you choose not to disable the mouse cursor during install, you can disable it later by running the DisableCursor.sh script.
Memory Split: Third and finally, the Install script will ask if you would like to change the memory split of your pi. If you do not know what this means please indicate that you would not like to change this value by entering "NO" when prompted. You can change this later by running the "$ raspi-config" command.
How to get to the terminal once you have installed the kiosk: You may want to run other scripts or exit out of your newely created Kiosk. To do this on your pi, press the "windows" key on your keyboard. Next arrow down to "Accessories", arrow to the right one time, then arrow down to terminal and press the "enter" key. Once the terminal is up, type the following command to stop the Kiosk:
(This will stop the kiosk and allow you to run other scripts or use your pi how ever you desire).
To uninstall the kiosk simply return to the terminal and run RpiKioskMain, then select the "Uninstall" option. This script will revert all config files back to the original states and will enable the mouse if it has been disabled.
IN NO EVENT WILL WE BE LIABLE FOR ANY DIRECT, INDIRECT, CONSEQUENTIAL, INCIDENTAL, SPECIAL OR EXEMPLARY DAMAGES FOR ANY USE OF THIS SITE, OR USE OF ANY OTHER LINKED SITE, OR SOFTWARE, EVEN IF WE ARE ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
With over 10 years of experience in the Technology field, I have solved my fair share of technical issues and problems.