How useinterstellar/interstellar works
Interstellar is a browser-based web proxy with an app-and-game portal. The principal workflow is a user opening the interface, launching a destination, and having browser proxy workers route its requests through the configured proxy engines. The README also documents tabs, cloaking, themes, password protection, and cloud-gaming support. Server routes, proxy-worker routing, game-asset forwarding, and analytics behavior are supported by sampled source; several UI-to-client connections are inferred from the product structure and documented features, so uncertain wiring is left out.
Main entry points: server.js HTTP server · sw.js Proxy service worker · index.html Portal pages · launcher.js Proxy launcher
Components 22
Web interface
- Portal pages
static/index.html - Proxy launcher
static/assets/js/launcher.js - Tab system
static/assets/js/tabs.js - Settings and themes
static/settings.html - Browser settings storage
static/assets/js/storage.js
Proxy runtime
- Proxy service worker
static/sw.js - Ultraviolet config
static/assets/ultraviolet/uv.config.js - Scramjet config
static/assets/scramjet/scramjet.config.js - Ultraviolet engine
static/assets/ultraviolet - Scramjet engine
static/assets/scramjet
Server services
- HTTP server
src/server.js - Optional login
config.js - Analytics proxy
src/analytics.js - Game asset proxy
src/games.js - Wisp transport
src/server.js - Version metadata
src/version.js
Portal content
- Apps and games catalogs
static/assets/json/apps.json - Games portal
static/games.html
Other components
- User
- Web destinations
- GitHub game assets
- Google Analytics
Connections 26
- User → HTTP server: requests pages
- HTTP server → Optional login: checks credentials
- HTTP server → Portal pages: serves pages
- HTTP server → Game asset proxy: mounts routes
- HTTP server → Analytics proxy: mounts analytics
- HTTP server → Wisp transport: routes upgrades
- HTTP server → Version metadata: resolves metadata
- User → Portal pages: uses portal
- Portal pages → Proxy launcher: launches proxy
- Portal pages → Apps and games catalogs: presents catalog
- User → Games portal: opens games
- Games portal → Apps and games catalogs: uses game catalog
- User → Settings and themes: changes preferences
- Settings and themes → Browser settings storage: persists preferences
- User → Tab system: uses tabs
- Proxy launcher → Proxy service worker: uses proxy worker
- Proxy service worker → Ultraviolet config: loads config
- Proxy service worker → Scramjet config: loads config
- Proxy service worker → Ultraviolet engine: dispatches UV requests
- Proxy service worker → Scramjet engine: dispatches Scramjet requests
- Ultraviolet engine → Web destinations: fetches proxied requests
- Scramjet engine → Web destinations: fetches proxied requests
- Web destinations → Wisp transport: uses transport
- Game asset proxy → GitHub game assets: fetches assets
- HTTP server → Google Analytics: proxies analytics
- Analytics proxy → Google Analytics: fetches and forwards