How robotics-now/localhost-manager works
Localhost Manager is a Chrome extension for discovering local services and optionally hosting HTML projects through a separately run local control server. The main workflow is popup-driven port scanning and display, with optional auto-scan caching, network discovery, and HTML hosting; settings configure these behaviors, while a background worker maintains the toolbar badge. Server details are sampled only partially, so the graph includes documented API capabilities and omits uncertain internal wiring.
Main entry points: popup.js Popup Logic · settings.js Settings Logic · background.js Badge Worker · server.js Control API
Components 21
Browser Extension
- Popup Interface
port_ext/templates/popup.html - Popup Logic
port_ext/scripts/popup.js - Settings Page
port_ext/templates/settings.html - Settings Logic
port_ext/scripts/settings.js - Badge Worker
port_ext/background.js - Extension Storage
- Appearance Settings
port_ext/scripts/settings.js
Port Discovery
- Local Services
- Port Scanner
port_ext/scripts/popup.js - Auto Scan Cache
port_ext/scripts/popup.js - Network Scanner
port_ext/scripts/popup.js - Network Devices
Local Hosting
- Hosted HTTP Site
port_ext/servers/server.js - HTML Project Files
- Browser Tabs
Control Server
- Control API
port_ext/servers/server.js - Python API
port_ext/servers/server.py - Hosted Server Manager
port_ext/servers/server.js - Project File Hosting
port_ext/servers/server.js - Hosted Servers
port_ext/servers/server.js
Other components
- User
Connections 33
- User → Popup Interface: opens
- Popup Interface → Popup Logic: dispatches
- Popup Logic → Port Scanner: scans
- Port Scanner → Local Services: probes
- Port Scanner → Extension Storage: reads/writes cache
- Popup Logic → Auto Scan Cache: runs optionally
- Auto Scan Cache → Extension Storage: reads/writes cache
- Popup Logic → Network Scanner: runs optionally
- Network Scanner → Network Devices: probes
- Popup Logic → Extension Storage: reads/writes preferences
- Popup Logic → Badge Worker: reports status
- Badge Worker → Extension Storage: reads preferences
- Badge Worker → Local Services: probes
- Badge Worker → Control API: checks health
- User → Settings Page: opens
- Settings Page → Settings Logic: dispatches
- Settings Logic → Extension Storage: reads/writes settings
- Settings Logic → Badge Worker: updates badge
- Settings Logic → Control API: checks status
- Settings Logic → Appearance Settings: configures
- Popup Logic → Control API: checks status
- Popup Logic → Hosted Server Manager: starts/stops hosting
- Popup Logic → Project File Hosting: uploads project
- HTML Project Files → Popup Logic: file selection
- Control API → Hosted Server Manager: dispatches
- Control API → Project File Hosting: dispatches
- Hosted Server Manager → Hosted Servers: records hosted server
- Project File Hosting → Hosted Servers: records hosted server
- Hosted Server Manager → Hosted HTTP Site: starts/stops
- Project File Hosting → Hosted HTTP Site: starts/stops
- Hosted HTTP Site → Browser Tabs: serves pages
- Python API → Hosted HTTP Site: provides equivalent hosting
- Popup Logic → Browser Tabs: opens service