Checking the Seestar’s Status

seestarpy provides several ways to inspect the current state of your Seestar — from a quick ASCII dashboard to individual low-level queries.

Status dashboard

The easiest way to see everything at a glance:

from seestarpy import status

status.status_bar()

This prints an ASCII table with the current view state, tracking, focuser position, filter wheel, plate-solve results, and more.

High-level queries

import seestarpy as ssp

ssp.exposure()             # current exposure time
ssp.filter_wheel()         # current filter position (1 or 2)
ssp.focuser()              # current focuser position
ssp.tracking()             # tracking on/off

Telescope state

from seestarpy import raw

# Overall app / firmware state
raw.iscope_get_app_state()

# View and camera state
raw.get_view_state()
raw.get_camera_state()

# Device info and settings
raw.get_device_state()
raw.get_setting()

Mount position

raw.scope_get_equ_coord()       # current RA/Dec
raw.scope_get_ra_dec()          # alias
raw.scope_get_horiz_coord()     # Alt/Az

Tracking and focuser

raw.scope_get_track_state()
raw.get_focuser_position()
raw.get_wheel_position()

Observation plan status

from seestarpy import plan

vp = plan.get_running_plan()
if vp and vp["state"] == "working":
    print(f"Running: {vp['plan']['plan_name']}")
    for t in vp["plan"]["list"]:
        print(f"  {t['target_name']}: {t.get('state', 'pending')}")

See Observation Plans for full plan documentation.