Skip to content

Phones, offline use and the browser extension

Waylight is a web page, but it can behave like an app: installed on your phone's home screen, readable without a connection and opened on every new browser tab. This page explains what each of these needs.

Install it as an app

On Android (Chrome), iOS (Safari, Share → Add to Home Screen) and desktop browsers with app support you can install Waylight. It then opens in its own window without the browser's address bar, and on Android it appears in the share menu for quick capture.

Browsers only allow installation from a secure context: an https:// address or localhost. On a plain http://192.168.x.x:8090 address the dashboard works normally, but the browser will not offer to install it and there is no offline mode. Put Waylight behind a reverse proxy with a certificate to get both.

Offline use

Once installed, or once the page has been opened over HTTPS, Waylight keeps the app itself and the last loaded data of most widgets on the device. When the server cannot be reached, the dashboard still opens and shows that data, and each widget's status badge tells you how old it is.

To-dos are the exception that also works the other way: you can add, tick off and edit to-dos while offline. The changes are kept in the browser and sent to the server when the connection is back. If a to-do was changed elsewhere in the meantime, Waylight does not overwrite it silently; it lists the conflicting changes under Resolve and lets you decide.

What is never stored on the device: the login, settings, exports, backups, logs and every request that changes data, apart from the to-do queue above. Signing out deletes the stored data.

Browser extension

The extension makes Waylight the page you see on every new tab, with the cursor already in the search field. It also adds Save page to Waylight to the toolbar and to the context menu, which opens the quick capture dialog with the current page, the link you right-clicked or the selected text.

The extension is available for Firefox: install it from Firefox Add-ons. Versions for Chrome, Edge and other Chromium-based browsers are planned.

On first start the extension asks how you want to use it:

  • With my Waylight server: enter the address of your dashboard, for example http://homeserver:8090.
  • Without a server: Waylight runs inside the browser, see below.

The packed extension is also attached to every release as waylight-extension-<version>.zip, for Firefox installs without access to addons.mozilla.org.

Without a server

If you do not run a server, the extension can be Waylight on its own: bookmarks, notes, to-dos, countdowns, the focus timer, habits, the clock and the weather work and are stored in the browser. Everything that needs a server running in the background, such as service tiles, Docker, notifications or parcels from e-mails, is hidden in this mode.

The data stays in this browser and is not synced to other devices. Export creates the same file as the server's data export; when you enter a server address later, the extension offers to import everything there.

Without a server

Without a server the extension runs Waylight itself, in the browser: bookmarks, notes, to-dos, countdowns, the focus timer, habits, the clock and the weather. Everything that needs a machine running in the background stays out, such as service checks, Docker, parcels and notifications. Your data is stored in this browser profile only; it is not synced to other devices and is lost when you remove the extension.

To move to a server later, open the extension's options, choose Download my data, and import the file on the server under Settings → Transfer. The import replaces the server's dashboard and appearance with what you made in the browser. Then switch the options to With my Waylight server.

The extension asks for three permissions: storage for the address and the mode, contextMenus for the menu entry and activeTab to read the URL and title of the tab you save, only at the moment you click. It has no access to other sites, injects no scripts into pages and sends nothing to anyone but your own dashboard (privacy of the extension). Its only request of its own checks whether your dashboard is reachable; if it is not, the new tab says so. Without a server, the weather widget asks Open-Meteo directly, and nothing else is contacted.