Wayseer

User guideWayseer 0.28.3Contents

Installing on macOS

Wayseer runs on macOS 13 Ventura or later, on Apple silicon and Intel Macs alike. It comes as one zip, wayseer-<version>-macos.zip, holding Wayseer.app, which has everything it needs inside it: one program with every data source built in, SQL and Kubernetes among them, and SDL3 3.4.16, the library that opens the window and draws.

Install

  1. Open the zip; Finder unpacks Wayseer.app beside it.
  2. Drag Wayseer.app into Applications.
  3. Open it from Applications or Launchpad.

To check the download, compare it with the SHA256SUMS file served beside it, at https://wayseer.app/v1/app/<version>/SHA256SUMS, by running shasum -a 256 -c --ignore-missing SHA256SUMS in the folder that holds both.

To remove it, drag it to the Bin. Its config and state stay in ~/Library/Application Support/Wayseer/ and its request log in ~/Library/Logs/Wayseer/ (where files are kept); delete those too to remove everything.

The first time you open it

A build signed with a Developer ID and notarized by Apple opens like any other app. Without that, it is signed only ad hoc: macOS knows it has not changed since it was built, but not who built it, so it asks once before it opens.

  • macOS 15 Sequoia and later. Open the app, and choose Done when macOS says it could not verify it. Then go to System Settings → Privacy & Security; under Security it says "Wayseer" was blocked. Choose Open Anyway, then enter your password.
  • macOS 13 and 14. In Finder, Control-click the app, choose Open, then Open again.

After that it opens without asking. If you built the zip yourself, you can instead clear the download mark in Terminal:

xattr -dr com.apple.quarantine "/Applications/Wayseer.app"

Newer releases

From 0.28, >updates.install downloads the newer app and checks its signature, as on Linux. Y then shows the new Wayseer.app in Finder; quit Wayseer and drag it over the old one (on a Mac). Wayseer never replaces the app itself. Not yet tried on a Mac.

This machine

A first run shows this Mac, as on Linux: its CPUs, memory, filesystems, network interfaces and processes (This machine says what differs). It needs no permission from System Settings.

From Terminal

The program inside the bundle takes the same flags as on Linux:

"/Applications/Wayseer.app/Contents/MacOS/wayseer" --help
"/Applications/Wayseer.app/Contents/MacOS/wayseer" --config my.yaml

Modules

SQL, Kubernetes and every other module in this guide are built into wayseer. A module of your own runs once it is a signed package, installed with >modules.install into the state directory; nothing goes inside the bundle (external modules).