# 🌐 God's Eye View [](https://github.com/bilawalsidhu/gods-eye-view/actions/workflows/ci.yml) [](https://x.com/bilawalsidhu/status/2093798887815348521) ### A spy-satellite simulator in your browser — then you realize the sources are public and the data is real. Photorealistic 3D globe. Live aircraft, ships, satellites, earthquakes, traffic, and public cameras. Hands-free voice control powered by a realtime AI agent. _No place left behind._  ▶️ **From the project behind the viral God's Eye View series** _(formerly WorldView)_ — [5M+ on YouTube](https://youtube.com/playlist?list=PL6qSg2I-7_koPbDnSMo0QeeHX_RknA2uv&si=nBGYMoHWQw41v93Q) · [25M+ across socials](https://www.google.com/search?q=god%27s+eye+view) 🏆 **Reached #1 on GitHub Trending, daily and weekly · August 2026** **[#8 Product of the Day](https://www.producthunt.com/products/god-s-eye-view?launch=god-s-eye-view)** · Hunted by Chris Messina, creator of the hashtag _“pretty cool”_ — [Brendan Eich](https://x.com/BrendanEich/status/2094592096401490266), creator of JavaScript and co-founder of Mozilla and Brave · Featured on **[Pinokio](https://pinokio.co/posts/01m1m4p9xxm3qw7dnnpj2wr93g)** ⚡ **Start without API keys.** Install with [Pinokio](https://pinokio.co/apps/github-com-bilawalsidhu-gods-eye-view) or run locally from the terminal. Add optional keys inside the app. **[→ Quick Start](#-quick-start)**

🌍 Why This Exists

God's Eye View brings public signals into one explorable globe. Track the world live. Talk to it. Break it. Extend it.

Flight transponders, ship beacons, orbital elements, seismographs, and public cameras already tell us a lot about the world. God's Eye View puts them in the same place, so you can move between a global picture and an individual aircraft, ship, or street. It runs locally in your browser, with source code you can inspect and extend.

Half the magic is that it looks like a forbidden cockpit. The other half is that every line of code is inspectable.

Most feeds are live or regularly refreshed. Traffic is simulated along real roads using aggregate location data. CCTV camera poses and rocket launch trajectories are coarse estimates.

Start with the included data sources, then add your own. Each layer is a separate module.

🎛️ What This Thing Does

• 🛩️ Cockpit view: Ride inside a tracked flight — the camera holds the terrain under you all the way down.
• 📡 Contacts: A 250 km roster of everything near your target — step through live aircraft and drop into any cockpit.
• 🎯 Click-to-track anything: Camera locks on, draws a fading trail, surfaces full metadata — and a tracked fire or vessel hands you off to the nearest live camera in one click.
• 🖊️ Voice whiteboard: Speak annotations onto the world — real boundary polygons, marks, and routes.
• 🛫 3D hangar: Real per-class aircraft models — 787, ATR-72, Citation, Bell 206, MQ-9 — and a tracked contact swaps from glyph to 3D model as you close in.
• 🎨 Reskin reality: GLSL sensor looks over the normal globe — CRT, NVG, FLIR/thermal, Noir.
• 🟩 Detection overlay: Screen-space bounding boxes and IDs on everything in view.
• 🎖️ Military HUD: Tactical heads-up display with intelligence-style telemetry.
• 🌐 Global Context: Stage the full situational picture with one switch — and get your exact view back when you leave.
• 🎥 Scene director: Capture cinematic camera tours for clips and demos.
• 🔗 Share Links: Camera, style, layers, and even one tracked target serialize into a URL — a live target is a handoff, not a bookmark.
• 🏠 Reset Globe: One control — or one sentence — back to the full Earth.
• 🌦️ Weather: Animate GFS or ECMWF forecast wind, replay observed radar, satellite clouds and lightning on one timeline, and follow NHC/CPHC cyclone tracks. No key needed.
• 📷 Mapped ALPR cameras: License-plate-reader camera locations tagged in OpenStreetMap, one city at a time. Locations and tags only; no key needed.
• 🔭 Satellite passes: Ask by voice when any loaded satellite next rises over you: rise, peak and set times, and whether you can see it.
• 🔎 Analyst answers: Count, filter and rank satellites, datacenters and dams by voice, alongside flights, ships, fires and quakes; answers say when a feed is stale or on a fallback.
• 🧭 Tilt and North Up: Switch between straight-down and a 35° oblique, or put north at the top, while a tracked target stays centered.
• 🔍 Keyless search: Type decimal coordinates, a two-dimensional WGS84 geo: URI (for example, geo:39.7392,-104.9903), or a bundled city or landmark to fly there with no geocoder request; other names use Google when configured, then Photon and Nominatim.
• 📦 Shareable scenes: Import, preview and share Director scenes as files or bundles, with camera anchors, authored moves and data packs.
• 🌊 Nepal flood scene: Replay the Bhote Koshi flood: flood path, witness sources and before-and-after imagery (bundled data is non-commercial; see DATA_SOURCES.md).

⚡ Quick Start

Start without an account or API keys. Both paths open the same app with Esri satellite imagery and keyless terrain. OSM is the fallback if Esri is unreachable. Flights, military traffic, satellites, earthquakes, public cameras, radio, and launches are available without keys.

For photorealistic 3D, add a Cesium ion token for eligible personal, non-commercial use, or a Google Maps key for the direct, metered route and Google place search. Provider terms and quotas apply. Add keys through the app's POWER UP panel; Keys & Costs explains the options.

Already installed? Update to the latest version. Older versions query public OpenStreetMap Overpass servers, which now refuse them, so Traffic, Mapped Installations and ALPR stay empty until you update.

Path 1 — One click, no terminal

1. Install or update Pinokio to 8.2 or later.
2. Open God's Eye View in Pinokio.
3. Click Install, then Start.

Available on Windows, macOS, and Linux. The Pinokio maintainer reports cross-platform testing of the fixed installer. The launcher installs the locked dependencies, finds a free local port, and opens the app in your system browser. The Server menu item keeps the launcher console available.

Tried before and installation failed? Update Pinokio and try again. Version 8.2 fixes the launcher installation issue; details from the Pinokio maintainer.

Using an older launcher or opening the embedded view manually? If the globe is very choppy, before treating that as a GPU compatibility or minimum-hardware problem, copy the local server URL shown by Pinokio and open the same URL in your normal hardware-accelerated browser. One Pinokio 8.2.0 user reported severe stutter in Pinokio's embedded view that went away when the same running server was opened in an external browser (#365). That points to the embedded browser rather than the app server or your hardware; it does not establish a minimum GPU requirement.

Path 2 — Terminal / coding agent

Use Node.js 24.x (24.14.0 or later) or 26.x. The setup doctor warns about Node 25, which is end-of-life.

git clone https://github.com/bilawalsidhu/gods-eye-view.git
cd gods-eye-view
npm ci
npm run doctor
npm run dev

Open http://localhost:4173. Choose Live Contacts, Space Missions, Environmental, or Explore Manually from the first-run panel.

macOS shortcut: ./scripts/dev-fresh.sh clears the Vite cache and pulls any configured keys straight from the Keychain. It starts keyless too.

Path 3 — Docker

No Node install needed; the container publishes the same dev server.

git clone https://github.com/bilawalsidhu/gods-eye-view.git
cd gods-eye-view
docker compose up

Open http://localhost:4173 as above. Everything the app saves stays in the folder you cloned, so docker compose down never loses anything:

• .env - your API keys, whether saved from Provider Settings or typed in by hand
• .gev-cache/ - downloaded map and satellite data, so later starts are faster
• .gev-logs/ - logs

Back up that folder and you've backed up everything; delete .env to forget your keys. Source edits still hot-reload. The port is published to 127.0.0.1 only, so the default matches the native one.

The local MCP server and ChatGPT OAuth voice are not available under Docker; use an OpenAI API key for voice.

Publishing it wider is the Sharing an instance opt-in, and it hands out Provider Settings too: the launcher trusts the container gateway as this machine, and a wider publish delivers everyone else from that same address. For an instance you mean to share, put the keys in .env by hand instead. SECURITY.md has the detail.

When you widen the publish, also set GEV_KEY_SETUP_TRUSTED_PEERS=none so the launcher trusts no gateway address.

```ba