God's Eye View

1. God's Eye View là gì?

God's Eye View là một quả địa cầu 3D chạy ngay trên trình duyệt, hiển thị dữ liệu công khai gần như theo thời gian thực: máy bay đang bay, tàu thuyền, vệ tinh (kể cả trạm vũ trụ ISS), động đất, đám cháy, thời tiết, một số camera giao thông công cộng và nhiều lớp khác. Nhìn bề ngoài nó giống màn hình của một phòng điều khiển vệ tinh gián điệp, nhưng theo chính dự án, mọi nguồn dữ liệu đều công khai và mã nguồn mở để ai cũng kiểm tra được. Dự án tách từ loạt video nổi tiếng cùng tên của tác giả Bilawal Sidhu và đã từng đứng đầu GitHub Trending.

Bạn bấm vào một chiếc máy bay là camera bám theo nó, hiện thông tin bay, thậm chí "ngồi trong buồng lái" xuống sân bay. Đây là app để khám phá và giải trí/học hỏi, không phải công cụ làm việc nghiêm túc. Phần mềm miễn phí, giấy phép MIT. Chạy trên máy của bạn, bạn không cần tài khoản. Một số lớp dữ liệu cần khóa (key) miễn phí hoặc trả phí, nhưng không có khóa nào bắt buộc để bắt đầu.

Hợp với bạn nếu:

• Bạn thích xem máy bay, vệ tinh, tàu biển đang di chuyển thật trên một quả địa cầu 3D, hoặc muốn có thứ gì đó ấn tượng để xem và quay video.
• Bạn đã từng thấy video God's Eye View và muốn tự thử trên máy mình.
• Bạn có thể cài một app khác (Pinokio) trước, rồi cài God's Eye View bằng cách bấm nút.

Chưa hợp nếu:

• Bạn muốn dùng nó để dẫn đường bay hoặc tàu, ứng phó khẩn cấp, quyết định y tế hay đầu tư. Dự án cảnh báo dữ liệu có thể chậm, thiếu, được ước tính hoặc sai, và không được dùng cho các mục đích an toàn hoặc vận hành.
• Máy bạn quá yếu hoặc dùng trình duyệt cũ: đồ họa 3D toàn cầu khá nặng. Tài liệu không nêu yêu cầu cấu hình tối thiểu, nên nếu máy giật hãy thử trên máy mạnh hơn.
• Bạn muốn tìm hoặc theo dõi một người cụ thể. Dự án nói rõ mình không làm tính năng tìm kiếm theo tên người, nhận diện khuôn mặt hay theo dõi cá nhân.
• Bạn muốn giọng nói điều khiển mà không muốn tốn tiền: tính năng nói chuyện cần khóa OpenAI tính phí (xem mục 2).

2. Cần chuẩn bị gì?

• Một máy tính Windows, macOS hoặc Linux và một trình duyệt web (Chrome, Edge…). Ứng dụng mở trang trên máy bạn ở địa chỉ http://localhost:4173 (hoặc cổng khác do Pinokio chọn).
• Pinokio (cách dễ nhất). Đây là một ứng dụng miễn phí giúp cài và chạy các dự án mã nguồn mở chỉ bằng nút bấm, không cần dòng lệnh. Tải ở trang chính thức https://desktop.pinokio.co/. Dự án yêu cầu Pinokio bản 8.2 trở lên.
• Nếu không dùng Pinokio, bạn cần Node.js (nền tảng chạy chương trình JavaScript, tải ở https://nodejs.org, dự án yêu cầu bản 24.14.0 trở lên hoặc bản 26) và Git (công cụ tải mã nguồn, tải ở https://git-scm.com/downloads).
• Kết nối Internet vì dữ liệu máy bay, vệ tinh… được lấy trực tiếp từ các nguồn công khai.
• Tiền: cài và chạy cơ bản miễn phí, không cần khóa API. Một số lớp cần khóa có gói miễn phí (tàu thuyền, đám cháy, giao thông, ảnh 3D toàn cảnh qua Cesium ion). Khóa OpenAI cho giọng nói là loại tính tiền: dự án ước tính vài cent mỗi phút dùng, một buổi tối dùng nhiều khoảng vài đô-la, và app tự có đồng hồ chi phí cùng mức dừng cứng 5 đô-la mỗi phiên. Nếu không muốn tốn tiền, đừng nhập khóa OpenAI.

3. Cài đặt từng bước

Cách 1 (dễ nhất): dùng Pinokio, không cần dòng lệnh

Bước 1: Cài hoặc cập nhật Pinokio

Vào https://desktop.pinokio.co/, tải bản cho hệ điều hành của bạn rồi cài. Nếu đã có Pinokio từ trước, hãy cập nhật lên 8.2 trở lên. Dự án ghi rằng bản này sửa lỗi cài đặt từng gặp. Mở Pinokio xong, bạn thấy màn hình danh sách ứng dụng là đúng.

Bước 2: Mở trang của God's Eye View trong Pinokio

Vào https://pinokio.co/apps/github-com-bilawalsidhu-gods-eye-view và mở trang này bằng Pinokio theo nút trên trang (hoặc tìm "God's Eye View" trong Pinokio).

Bước 3: Bấm Install, rồi Start

Bấm Install, đợi cài xong. Trình cài đặt sẽ tự cài các phần phụ thuộc, tìm một cổng trống trên máy và mở app. Sau đó bấm Start. Bạn thấy quả địa cầu 3D mở ra trên trình duyệt là thành công. Lần đầu, app hiện bảng chọn "nhiệm vụ" khởi đầu (Live Contacts, Space Missions, Environmental hoặc Explore Manually).

Cách 2: dùng dòng lệnh

Cách này dành cho người đã có Node.js và Git. Mở Terminal (macOS/Linux) hoặc PowerShell (Windows), chạy lần lượt:

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

Lệnh npm run doctor kiểm tra xem máy đã đủ Node.js và npm chưa. Sau khi npm run dev chạy, mở trình duyệt vào http://localhost:4173. Bạn thấy quả địa cầu và bảng chọn nhiệm vụ là thành công.

Lưu ý: Mặc định chỉ máy của bạn truy cập được trang này. Dự án có hướng dẫn chia sẻ trong mạng LAN, nhưng kèm cảnh báo rủi ro. Nếu bạn không rành, đừng mở chia sẻ.

4. Dùng lần đầu

Dự án gợi ý trình tự "năm phút đầu tiên". Bạn làm theo từng bước dưới đây, tên nút có thể thay đổi chút giữa các phiên bản.

1. Chọn nhiệm vụ "Live Contacts" (hoặc tự bật lớp Flights). Bạn thấy hàng nghìn máy bay đang bay hiện trên địa cầu.
2. Bấm vào một máy bay. Camera bám theo, vẽ vệt bay phía sau và hiện bảng thông tin bay trực tiếp.
3. Bấm COCKPIT trên máy bay đang theo dõi để "ngồi trong buồng lái" và bay xuống. Bạn có thể đổi kiểu hiển thị giữa chừng.
4. Đổi kiểu nhìn bằng các phím số 1 đến 7 (ví dụ kiểu nhìn đêm NVG, nhiệt FLIR). Cả quả địa cầu đổi màu theo từng kiểu.
5. Theo dõi vệ tinh: bật lớp Satellites rồi bấm vào trạm vũ trụ ISS, camera sẽ bám theo nó cùng đường quỹ đạo.
6. Thoát: bấm Reset Globe (đưa về quả địa cầu toàn cảnh) hoặc phím Esc.

Một vài phím tắt theo dự án: H bật tắt giao diện HUD, D bật tắt khung nhận diện, C buồng lái, Esc thoát. Trên bàn rê chuột (trackpad), hai ngón chụm lại sẽ phóng to thu nhỏ quả địa cầu.

Muốn thêm lớp dữ liệu, bấm chip POWER UP ở góc dưới bên phải để mở bảng Provider Settings, dán khóa vào rồi bấm SAVE KEYS, app sẽ tự khởi động lại. Nếu chip bị ẩn do cửa sổ nhỏ, thêm ?setup=1 vào cuối địa chỉ để mở lại bảng này.

5. Lỗi thường gặp và cách sửa

Dấu hiệu	Nguyên nhân	Cách sửa
Pinokio báo cài thất bại hoặc dừng giữa chừng	Bản Pinokio cũ	Cập nhật Pinokio lên 8.2 trở lên rồi cài lại. Dự án ghi bản này sửa lỗi cài đặt
Bản đã cài từ trước, các lớp Traffic, Mapped Installations và ALPR trống	Bản cũ hỏi các máy chủ OpenStreetMap Overpass công cộng, nay các máy chủ này từ chối	Cập nhật God's Eye View lên bản mới nhất, theo hướng dẫn của dự án
npm ci báo lỗi phiên bản Node	Bản Node.js không phù hợp (dự án cần 24.14.0 trở lên hoặc 26; bản 25 bị cảnh báo vì đã hết hỗ trợ)	Cài lại Node.js bản phù hợp rồi chạy lại. Chạy npm run doctor để xem máy còn thiếu gì
Mở localhost:4173 không thấy gì	Chưa chạy npm run dev, hoặc cổng khác với dự kiến	Kiểm tra cửa sổ lệnh còn đang chạy, và xem địa chỉ cổng nó in ra
Nút micro báo "voice is unavailable"	Chưa nhập khóa OpenAI (tính năng giọng nói cần khóa)	Bình thường nếu bạn không muốn tốn tiền: các phần còn lại vẫn chạy. Muốn dùng giọng nói thì thêm khóa trong POWER UP
Bản đồ nền nhìn khác với ảnh trong video, không có ảnh 3D thật của thành phố	Ảnh 3D Photorealistic cần khóa Cesium ion (có gói miễn phí cho cá nhân, phi thương mại) hoặc khóa Google Maps (tính phí)	Thêm khóa trong POWER UP nếu muốn. Không có khóa, app dùng ảnh vệ tinh Esri
Một lớp không hiện dữ liệu, chữ báo đang chờ khóa	Lớp đó cần khóa riêng (ví dụ tàu thuyền, đám cháy)	Lấy khóa miễn phí ở nhà cung cấp rồi dán vào POWER UP

6. Gỡ cài đặt / cập nhật

Với Pinokio: mở Pinokio và vào mục God's Eye View của bạn để cập nhật hoặc xóa (tài liệu của dự án không mô tả chi tiết nút bấm, hãy xem tài liệu của Pinokio nếu không thấy). Bản mới nhất lúc viết là v0.2.1 (3/10/2026), dự án cập nhật thường xuyên.

Với dòng lệnh: vào thư mục gods-eye-view và kéo bản mới bằng git pull, sau đó chạy lại npm ci. Để gỡ, đóng cửa sổ đang chạy rồi xóa thư mục gods-eye-view.

Khóa bạn nhập vào app được lưu trong file trên máy của chính bạn (với Pinokio là file pinokio/ENVIRONMENT của app, với cách dòng lệnh là file .env), và các file này không đưa lên Git. Khi gỡ app, hãy xóa luôn file đó nếu bạn từng nhập khóa.

7. Câu hỏi hay gặp

Có mất tiền không? Cài và chạy cơ bản thì không. Chỉ tính năng giọng nói qua OpenAI là tính phí theo mức dùng và app có chặn ở mức 5 đô-la mỗi phiên. Một số khóa khác có gói miễn phí, một số dịch vụ tính phí nếu dùng quá hạn mức của họ.

Dữ liệu có phải của chính phủ hay bí mật không? Theo dự án, không. Mọi nguồn đều công khai, ví dụ tín hiệu máy bay, tàu, vệ tinh, địa chấn và camera công cộng. Dự án tự giới hạn: không làm tính năng tìm kiếm theo người, nhận diện mặt hay theo dõi cá nhân.

Dữ liệu có chính xác không? Không đảm bảo. Dự án nói dữ liệu có thể chậm, thiếu, bị ước tính hoặc sai. Camera và quỹ đạo tên lửa chỉ là ước tính thô. Đừng dùng để dẫn đường hay quyết định quan trọng.

Có cần mạng không? Có, vì dữ liệu lấy trực tiếp từ các nguồn trên mạng.

Máy yếu có chạy được không? Tài liệu không nêu mức tối thiểu. Đây là ứng dụng đồ họa 3D toàn cầu nên máy yếu có thể giật. Hãy thử và tắt bớt lớp dữ liệu nếu cần.