CD2H gitForager

resin-io/resin-electronjs

Name: resin-electronjs

Owner: Resin.io

Description: electronJS-based resin application template

Created: 2016-01-13 18:24:04.0

Updated: 2018-01-11 08:10:26.0

Pushed: 2017-12-14 13:19:46.0

Homepage: http://resin.io

Size: 1727

Language: JavaScript

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

resin-electronjs

a boilerplate for developing kiosks, digital signage or other human-machine interaction projects based on ElectronJS and resin.io

Warning regarding armv6

This project does not currently support the armv6 architecture (ie Raspberry Pi 0 and 1) due to electron limitations. If the issue is fixed on the electron side, we will include it in this project. More on this here

Getting started

Sign up on resin.io
go throught the getting started guide and create a new application
clone this repository to your local workspace
add the resin remote to your local workspace using the useful shortcut in the dashboard UI
git push resin master
see the magic happening, your device is getting updated Over-The-Air!

Configure via environment variables

Apply the above settings in the “Fleet Configuration” panel (if applying it for the all devices withing your application), or “Device Configuration” panel (if applying it for a single device).

WHY THIS TEMPLATE

Achieving kinda-smooth desktop application display on devices like the raspberrypi is hard. This project aims to provide a quickstart template.

URL LAUNCHER config via ENV VARS

!!! Please note that since 0.1.0 the bool-based env vars dropped true / false strings in favour of 0 / 1 ones. !!!

simply set these environment varables in your app via “Environment Variables” panel in the resin dashboard to configure the behaviour of your devices. Please note that the bool type definition in the table is meant to accept to either 0 or 1 values.

URL_LAUNCHER_URL string - the URL to be loaded. use file:////usr/src/app/data/index.html to load a local electronJS (or any website) app - defaults to file:////usr/src/app/data/index.html
URL_LAUNCHER_NODE bool (converted from string) - whether or not enable nodejs - defaults to 0
URL_LAUNCHER_KIOSK bool (converted from string) - whether or not enter KIOSK mode - defaults to 1
URL_LAUNCHER_TITLE string - the title of the window. Seen only with URL_LAUNCHER_FRAME=true - defaults to RESIN.IO
URL_LAUNCHER_FRAME bool (converted from string) - set to “true” to display the window frame. Seen only with URL_LAUNCHER_KIOSK=false - defaults to 0
URL_LAUNCHER_CONSOLE bool (converted from string) - set to “true” to display the debug console - defaults to 0
URL_LAUNCHER_WIDTH int (converted from string) - - defaults to 1920
URL_LAUNCHER_HEIGHT int (converted from string) - - defaults to 1080
URL_LAUNCHER_TOUCH bool (converted from string) - enables touch events if your device supports them - defaults to 0
URL_LAUNCHER_TOUCH_SIMULATE bool (converted from string) - simulates touch events - might be useful for touchscreen with partial driver support - be aware this could be a performance hog - defaults to 0
URL_LAUNCHER_ZOOM float (converted from string) - The default zoom factor of the page, 3.0 represents 300% - defaults to 1.0
URL_LAUNCHER_OVERLAY_SCROLLBARS bool (converted from string) - enables overlay scrollbars - defaults to 0

This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.