Web Apps Bookmark Configuration

Introduction

The “Web App” application contains a list of bookmarks that are saved to a configuration file. This configuration can be configured by editing or replace the file. The file can be pushed manually to the device as well as pushed remotely via Foresight or other file transfer solutions.

Glossary

  • Base64 is a group of binary-to-text encoding schemes that represent binary data in an ASCII string format.
  • Favicon an icon associated with a URL that is variously displayed, as in a browser’s address bar or next to the site name in a bookmark list.

Configuration

File

In order to create and modify the tagset data, it is recommended to use:

  • VisualStudioCode

This tool will help with JSON validation and tagset formatting.

File Location

Storage location for JSON File:, ‘/sdcard/realwear/com.realwear.weblauncher/config/config.json’

Format and Options

Below are the parameters that are required in order to correctly read in values for bookmarks.

  • webapps: an array of web apps, each of which should specify its name, URL and icon – required
  • name: a display name – required
  • weblink: a URL to launch – required
  • icon: an optional base64 encoded icon – optional

If there is no base64 encoded icon, the favicon will be used in its place, if a favicon cannot be obtained, a default icon will replace it.

Images can be converted to a Base64 using: https://www.base64-image.de/

Example file:

{
  "webapps": [
    {
      "name": "Realwear",
      "weblink": "http://www.realwear.com",
      "icon": "base64 encoded image"
    },
    {
      "name": "Google",
      "weblink": "http://www.google.com",
      "icon": "base64 encoded image"
    },
    {
      "name": "Bing",
      "weblink": "https://www.bing.com/",
      "icon": "base64 encoded image"
    },
    {
      "name": "Android",
      "weblink": "https://www.android.com",
      "icon": "base64 encoded image"
    },
    {
      "name": "Wikipedia",
      "weblink": "https://en.wikipedia.org/wiki/Optical_head-mounted_display",
      "icon": "base64 encoded image"
    }
  ]
}