// Guide
How to use God's Eye View
God's Eye View runs on your computer and opens in your browser. It's free and MIT licensed, and it starts without an account or API keys: Esri satellite imagery and keyless terrain load out of the box, along with flights, military traffic, satellites, earthquakes, public cameras, radio and launches.
1. Install it
One click (Windows, macOS, Linux). Install or update Pinokio to 8.2 or later, open God's Eye View on Pinokio, then click Install and Start. Pinokio installs the locked dependencies, finds a free port and opens the app in your browser.
From a terminal. Use Node.js 24 (24.14.0 or later) or 26:
$ git clone https://github.com/bilawalsidhu/gods-eye-view.git
$ cd gods-eye-view
$ npm ci
$ npm run doctor
$ npm run dev
Then open http://localhost:4173.
With Docker. No Node install needed: clone the repository and run docker compose up, then open http://localhost:4173. Your keys, cached map data and logs stay in the folder you cloned.
Already installed? Update to the latest version. Older versions query public OpenStreetMap Overpass servers that now refuse them, so Traffic, Mapped Installations and ALPR stay empty until you update. More detail is on the download page.
2. Your first five minutes
- Pick a first-run mission: Live Contacts, Space Missions, Environmental or Explore Manually.
- Turn on Flights and click an aircraft: the camera locks on, a trail draws behind it and its telemetry card opens. Hit COCKPIT to ride along.
- Turn on Cameras over Austin, London, California, Finland or Delaware. Feeds project into the 3D city, and VIEWSHED draws each camera's estimated coverage.
- Turn on Satellites and click the ISS to ride along at orbital distance.
- Hit Reset Globe to come back out.
3. Keyboard shortcuts
1–6: visual styles (CRT, NVG, FLIR and more)H: HUD ·D: detection ·C: cockpit ·`: frame rate ·Esc: back out- Trackpad pinch zooms the globe.
4. Add keys for more (optional)
Click the POWER UP chip in the bottom-right corner. Provider Settings lists every supported key, what it switches on and where to get it; paste, hit SAVE KEYS, and the app restarts with the new capability. If a compact layout hides the chip, add ?setup=1 to the address.
- Cesium ion (free for eligible personal, non-commercial use): photorealistic 3D and world terrain.
- Google Maps (metered): direct photorealistic 3D, Google place search and Street View.
- OpenAI (metered) or Gemini: voice and chat.
- AISStream, NASA FIRMS, TomTom and Mapillary (free tiers): live ships, active fires, traffic flow and Street Level photos.
Most layers cost nothing and need no signup. Keys stay on your machine, in a local owner-only file excluded from Git. Provider terms and quotas apply.
5. Talk to it
Choose OpenAI or Gemini under AI Provider in Settings. Click GEV MIC, grant the microphone and talk, for example: "Take me to LAX and select the nearest airborne aircraft." CHAT, next to the mic, opens a typed chat that uses the same map actions. API-key voice sessions show a live spend readout with a $2 warning and a $5 hard cap.
6. Connect Claude or Codex (MCP)
The MCP server runs locally. With the app running at http://localhost:4173, add the server from your checkout:
$ claude mcp add gods-eye-view -- node /abs/path/gods-eye-view/server/mcp/stdio.js --api-base http://localhost:4173
$ codex mcp add gods-eye-view -- node /abs/path/gods-eye-view/server/mcp/stdio.js --api-base http://localhost:4173
Codex and ChatGPT desktop and Claude Desktop take the same server in their MCP settings. The MCP setup guide has every client.
7. Share a view
The share button makes a short /share/ link. The camera, style, layers and even one tracked target travel in the link, so it opens the same way on any copy of the app.
8. Keep it on your machine
The server binds to localhost, and Provider Settings answers only requests from your machine. Sharing on your network is an explicit opt-in. SECURITY.md has the details.