pyobs-web-client
This is a pyobs (documentation) GUI client
for telescope fleets, written in TypeScript/Vue 3. It talks the pyobs XMPP wire protocol directly
from the browser (Strophe.js) — there is no backend of its own and nothing to install into a
fleet’s own class:-configured module list; you build it and serve the static output, then log
in from the browser.
Example configuration
There’s no module-side YAML config — this is a static single-page app a browser connects with. What you configure instead:
Server-side, the ejabberd server this client connects to needs its WebSocket listener enabled and
mapped to /ws (ejabberd docs):
listen:
-
port: 5280
ip: "::"
module: ejabberd_http
tls: false
request_handlers:
/ws: ejabberd_http_ws
/admin: ejabberd_web_admin
By default the app connects to ws(s)://<jid-domain>:5280/ws, derived from the JID a user logs
in with — no build-time server address needed. Override it only if that default doesn’t resolve
(e.g. a dev server on plain http:// against a TLS-only ejabberd listener), via a build-time
env var in .env.local:
VITE_XMPP_WS_URL=wss://localhost:5280/ws
At runtime, a user logs in with a JID + password against whichever server that resolves to; the
app remembers previous logins and per-connection VFS endpoint config locally (see
specs/design/login-memory-and-vfs-config.md, specs/design/per-domain-websocket-config.md)
— nothing further to configure ahead of time.
Views
One router view per top-level page (src/router/index.ts / src/views/*.vue). No
screenshots yet — written from source, not a running instance; add those as a follow-up.
DashboardView
The landing page: an expandable list of every currently-online module, generic capability/state
cards (ModuleStateCard/KeyValueCard) with no per-interface hardcoding.
ShellView
A pyobs-gui-style RPC console — accordion-style module/method/params picker built from each module’s own live command schema, plus a log of executed commands and their replies. The one generic escape hatch for any RPC any connected module exposes, including ones without a dedicated page below.
RoofView
Drives IRoof — status readout plus Open/Close/Stop for every currently-online module
implementing it.
ModeView
Drives IMode.
WeatherView
Drives IWeather — includes a hand-rolled TimeSeriesChart for sensor history.
AutoFocusView
Drives IAutoFocus — includes a hand-rolled FocusCurveChart scatter chart.
AutoGuidingView
Drives IAutoGuiding — includes hand-rolled OffsetMagnitudeChart/OffsetScatterChart
charts.
AcquisitionView
Drives IAcquisition — includes a hand-rolled DistanceChart, reusing
OffsetScatterChart from AutoGuiding for the offset trajectory.
CameraView
Drives ICamera — Expose button, live IExposure state, and client-side FITS decode/render
(packages/pyobs-fits, a hand-rolled decoder — see
specs/adrs/0001-hand-rolled-fits-decoder-not-npm-library.md) of the grabbed image, plus a
collapsible settings panel for IWindow/IBinning/IImageFormat/IExposureTime/
IGain/IImageType.
LoggingView
Live LogEvent stream via versioned event PubSub, with real filtering.
EventsView
Every incoming event, not just LogEvent — a generic feed for anything a module publishes.
SettingsView
Connection settings — saved accounts, VFS endpoint config, “Test connection”.