balena-dashboards

Please consider donating to this project!

This project is a simple solution for managing multiple digital signage displays, dashboards, and other dynamic statistical data on raspberry-pi (or x86-x64 arch) powered displays, via one central admin panel. This project is intended for use in conjunction with balena.io (see below for link and account setup instructions).

You may be asking,"What makes this dashboard project better than others?"

Managed through balena.io
Multiple URLs/webpages to load
Custom timeout values for each URL
Support for remote screen control/support/viewing
Fast load/runtime due to multi-threaded creation of browser windows

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

Prerequisites

Things you need to deploy this code to your device:

Sign up for a free account with balenaCloud here
Create an application
Add your device and download the OS. Make sure to specify the wifi information needed to connect your device
Flash your SD card (balenaEtcher is recommended) and boot the device
Ensure the device shows up in your application dashboard
Download the code for this project from GitHub, and push to your application, using the balena-cli tool

git clone https://github.com/willswire/dashboards.git
balena push *application-name*

Configuration

The following Enviroment Variables must be set within Application > Device under D(x) - Device Variables:

Name	Value
`URL_ONE`	`https://www.google.com` [fully qualified URL to load]
`TIME_ONE`	`60` [integer which represents number of seconds to show URL]
`URL_TWO`
`TIME_TWO`
`URL_[...]`	`infinte URLs to load`
`TIME_[...]`	`corresponding time values for each URL`
`ZOOM`	`adjust zoom factor (must be in double format, i.e. 2.0). default is 1.0`
`NOVNC_PASSWORD`	`defaultpassword` [obviously change this to something different]
`TZ`	`America/New_York` [obviously change this to your timezone, see Wikipedia for your TZ

In order to view the device remotely from within your browser, enable the public device URL within the device summary page. Then, you can simply click the link and login using the password set above.

Built With

ElectronJS - The web framework used
balenaCloud - IoT device management
noVNC - Used to provide remote viewing/support through public device URL (enable in device settings)

epicdistraction / balena-dashboards Goto Github PK