See what’s orbiting Earth — live on your desktop. Track satellites and debris on a 3D globe, filter by type, find what’s nearest to you, and (on Starlink Wi‑Fi) see which satellite your dish is likely using.
Built with Tauri 2, React, TypeScript, Three.js, and satellite.js.
Latest release — pick the installer for your system.
| Platform | Install |
|---|---|
| Windows | SatX-*-Windows-x64.zip — extract, then run the .msi (or -Setup.exe) inside |
| macOS | SatX-*-macOS.zip — extract, open the .dmg, drag to Applications; if macOS says “damaged”, see INSTALL-macos.md in the zip (Control-click → Open) |
| Linux | SatX-*-Linux-x64.tar.gz — extract, install the .deb or run the AppImage |
Each archive includes README.md, LICENSE, ACKNOWLEDGMENTS.md, and the docs/ folder. See the release notes table on Releases. Layout tips.
New to SatX? Start with the User guide. Developers: build from source.
| Guide | Who it is for |
|---|---|
| User guide | Everyday users — how to use the app step by step |
| Application overview | What SatX does: globe, filters, tracking, Starlink, limits |
| Running & building | Install, develop, and release builds per OS |
| All docs | Index |
| Acknowledgments | Libraries and data providers |
- Loads a public catalog of active satellite orbits and updates positions in real time on a 3D Earth view.
- Left sidebar for filters, search, and the nearest list; details for the selected satellite or ground site appear in a panel over the globe (upper-left).
- Shows a red marker at your location (when you allow it) and lists the 50 closest objects by distance.
- Filter by object type (stations, Starlink, navigation, debris, weather, and more), search by name or id, and open details by clicking the globe or list.
- Globe set: Optimized (up to 16,000 objects, default) or Full catalog (every object matching the filter; heavier).
- Starlink (desktop app, on dish Wi‑Fi): fetch dish pointing, match a servicing satellite (≥25° above your horizon), and draw an orange link from you to that satellite.
- Starlink ground map (Starlink filter): optional gateway and PoP markers on the globe from a bundled public dataset; click a site for details.
Details: Application overview · How to use it: User guide
| Supported | Not supported yet |
|---|---|
| Windows, macOS, Linux desktop | iOS / Android apps |
| Installed SatX app | Starlink fetch in browser-only dev |
Phone/tablet as primary UI (MOBILE_UI_ENABLED is off) |
Tauri 2.x only (npm run ensure:tauri2). Experimental Android/iOS scaffolding may exist in the repo but is not a supported product path.
| Guide | Platform |
|---|---|
| Windows | Windows 10/11 |
| macOS | macOS 10.15+ |
| Linux | Debian, Ubuntu, Fedora, Arch, … |
| Release builds | Installers + GitHub Actions on v* tags |
Quick start (developers): npm install, then:
| Platform | Development | Production build |
|---|---|---|
| Windows | npm run tauri:dev |
npm run tauri:build |
| macOS / Linux | npm run tauri -- dev |
npm run tauri -- build |
Prerequisites: Node.js LTS, Rust, Tauri 2 system deps.
npm run devUI at http://localhost:1420 without Tauri. Starlink dish fetch and some native features are unavailable. See Application overview.
| Script | Purpose |
|---|---|
npm run tauri:dev |
Desktop dev (Windows; uses scripts/tauri-dev.cmd) |
npm run tauri:build |
Desktop release build (Windows) |
npm run tauri -- dev / build |
macOS / Linux |
npm run dev |
Vite only (browser) |
npm run ensure:tauri2 |
Verify Tauri 2.x pins |
npm run sync:ground-stations |
Refresh bundled Starlink gateway/PoP JSON from Hugging Face |
| Path | Role |
|---|---|
src/ |
React UI, globe, hooks, workers |
src/data/ground-stations.json |
Bundled Starlink gateways & PoPs |
src/lib/globeCatalog.ts |
Filters, globe cap vs full catalog |
src-tauri/ |
Rust: TLE catalog, Starlink HTTP |
docs/ |
User guide, application overview, running guides |
.github/workflows/release.yml |
Multi-OS release builds on tag push |
Thank you to the open-source projects and public data providers that make SatX possible. Full credits: ACKNOWLEDGMENTS.md.