God's Eye View for Omarchy

An Omarchy bar plugin that installs, launches, updates, and stops God's Eye View as a private, localhost-only user service.

This is an unofficial community integration. God's Eye View was created by Bilawal Sidhu; this wrapper does not claim authorship of the upstream application.

What it does

• Adds a globe control to the Omarchy bar.
• Installs the upstream repository into $XDG_DATA_HOME/gods-eye-view/app (normally ~/.local/share/gods-eye-view/app).
• Uses the upstream lockfile with npm ci --include=optional --ignore-scripts and runs its setup doctor. Explicit optional packages supply the Linux binaries; disabling lifecycle scripts avoids npm 11's Sharp source-build fallback on Arch and reduces installation-time code execution.
• Starts a transient systemd user service bound to 127.0.0.1.
• Opens http://localhost:4173 in your default browser.
• Preserves the upstream .env file and cache across updates.
• Requires no root access and makes no system-package changes.
• Pins the executable upstream source to a reviewed full Git commit. Adopting a newer upstream version requires a new plugin release and marketplace scan.
• Bounds clone/fetch/setup time, keeps at most 1 MiB of setup output, and runs the service with a 4 GiB memory ceiling, a 256-task ceiling, and no-new- privileges enabled.

No API key is required for the keyless basemap and supported public feeds. Optional provider keys are added through the app's POWER UP panel and are stored by the upstream app in its ignored, owner-only .env file.

Requirements

• Omarchy 4 with Quickshell plugin support
• Node.js 24.14+ or 26.x
• npm, git, curl, jq, and systemd user services

Omarchy's mise-managed Node works. The plugin passes the current PATH into the transient service so the same Node runtime is used after launch.

Install

From a local checkout:

omarchy plugin add /path/to/omarchy-gods-eye-view --enable --yes

For a published Git repository:

omarchy plugin add https://github.com/larrywcox/omarchy-gods-eye-view.git --enable

Click the bar icon, then INSTALL. The first setup downloads the application and its locked npm dependencies. Once ready, click START, then OPEN.

Keyboard shortcuts in the panel: Enter opens or performs the primary action, S starts/stops, U updates, and R refreshes status. Right-clicking the bar icon stops a running service.

Data and logs

• Application: ~/.local/share/gods-eye-view/app
• Setup log: ~/.local/state/gods-eye-view/setup.log
• Runtime log: journalctl --user -u gods-eye-view-4173.service

The port is configurable in Omarchy's plugin settings. Each port has its own transient service name.

Remove

omarchy plugin remove io.github.larrywcox.gods-eye-view

Removing the plugin intentionally leaves the separately installed application, its cache, and .env in place. This prevents accidental credential or data loss. Remove that directory manually only if you also want to delete the app.

Security notes

The service always overrides HOST to 127.0.0.1, even if the app's .env requests LAN access. Browser-exposed Google Maps and Cesium tokens should still be restricted at their providers, as described by the upstream project.

The only remotely acquired executable content is upstream commit 759652207fd1279ece97f0f19af566feb9a82146 plus packages locked by upstream's package-lock.json. Git checks out that full commit in detached mode before npm ci; npm lifecycle scripts are disabled. Setup output goes to a bounded disk log and never enters the long-running QML process.

All dynamic panel strings use Text.PlainText. The helper does not retain or render responses from the application's live data feeds; those remain inside the upstream browser application.

Like every third-party Omarchy plugin, this QML runs unsandboxed as your user. Review the source before enabling it.