Tell your telescope what to do.

A simple, astronomy-native runtime for automating telescopes, cameras, and whole observation nights.

Sky
astronomical night
Equipment
Cool
Warm up
M31
L ×40
M42
waits for 22:00
Ha
NGC 7000
Ha ×24
OIII ×24
SII ×24
18:0020:0022:0000:0002:0004:0006:00
One possible night for the file below, observed from 49° N and read in local time. Each bar is a plan from the file; colors mark the filter. Times are illustrative.

Describe the night. UT Script runs it.

No programming needed. You write what you want to observe, and the runtime handles pointing, tracking, exposing, and saving on whatever telescope you own.

  1. Write the file

    List your site, your gear, your safety limits, and your targets in a plain-text file. Exposures, angles, and durations are written the way you say them: 120s, 45deg, 10m.

  2. Start UT Script

    It reads the file, connects to your mount, camera, filter wheel, focuser, guider, and roof, and cools the sensor.

  3. Let it run the night

    It waits for astronomical night, centers each target, exposes, dithers, and refocuses when needed. At dawn it parks the telescope and warms up the camera.

One file works on any telescope. Swap your mount or camera by changing the driver lines, and the rest stays the same. A simulation mode runs complete sessions with no telescope, no camera, and no clear sky, so you can test a night before you commit to it.

The file for one night

This is the file behind the chart above. The notes next to each block say what it does in plain language.

[setup]
start_when      = sky.astronomicalNight
stop_when       = not sky.astronomicalNight
min_altitude    = 20deg
sun_avoidance   = 30deg
moon_avoidance  = 20deg
wind_limit      = 30
rain_protection = true
on_unsafe       = pause
safe_for        = 10m

Starts when astronomical night begins and stops at dawn. It stays 20° above the horizon, keeps 30° from the Sun and 20° from the Moon, and holds a wind limit of 30. If the weather turns unsafe it parks, waits until conditions have stayed safe for 10 minutes, then carries on.

[site]
name      = Backyard
latitude  = 49.0
longitude = 8.4
elevation = 120
timezone  = Europe/Berlin

Where you observe. Times in the file, like 22:00:00, are read in this time zone.

[camera]
target_temperature = -10
cooling            = true
warmup_per_minute  = 1

Cools the sensor to -10 degrees and warms it up by 1 degree per minute at the end of the night.

[plan.1]
target          = M31
exposure        = 120s
frames          = 40
filter          = L
min_altitude    = 45deg
moon_separation = 40deg
output          = m31/
on_fail         = retry
retries         = 3

Forty 2-minute luminance frames of M31, only above 45 degrees. It skips the target if the Moon is within 40 degrees, and retries up to 3 times if something fails.

[plan.2]
target   = M42
exposure = 30s
frames   = 100
filter   = Ha
after    = 22:00:00
before   = 03:00:00
output   = m42/

A hundred 30-second Ha frames of M42. They start after 22:00 and finish before 03:00.

[plan.3]
target       = NGC 7000
min_altitude = 35deg
output       = ngc7000/

[plan.3.sequence.1]
filter   = Ha
exposure = 300s
frames   = 24

[plan.3.sequence.2]
filter   = OIII
exposure = 300s
frames   = 24

[plan.3.sequence.3]
filter   = SII
exposure = 300s
frames   = 24

NGC 7000 in three filters: 24 five-minute frames each in Ha, OIII and SII, one after the other.

Show the complete file, november_deep_sky.uts.ini
; november_deep_sky.ini

[setup]
name            = November Deep Sky
logfile         = november_deep_sky.log
log_level       = info
resume          = true                  ; remember progress, continue after a crash
state_file      = november_deep_sky.state
start_when      = sky.astronomicalNight ; wait for this before the first target
stop_when       = not sky.astronomicalNight ; stop at dawn
min_altitude    = 20deg
max_altitude    = 85deg
sun_avoidance   = 30deg
moon_avoidance  = 20deg
wind_limit      = 30
rain_protection = true
fail_on_hardware_error = true
on_unsafe       = pause                 ; park, wait until safe, unpark, retry
safe_for        = 10m                   ; weather must stay safe this long before resuming

[site]
name      = Backyard
latitude  = 49.0
longitude = 8.4
elevation = 120
timezone  = Europe/Berlin               ; times like 03:00:00 are local to this zone

[telescope]
driver        = lx200
port          = /dev/ttyUSB0
baud          = 9600
tracking      = sidereal
slew_timeout  = 120s
settle_time   = 3s
meridian_flip = true
flip_after    = 5m                      ; minutes past the meridian

[plate_solve]
solver       = astap
center       = true                     ; slew, solve, sync, re-slew at the start of each target
tolerance    = 30arcsec
max_attempts = 4

[camera]
driver             = indi
device             = ZWO ASI294MC
target_temperature = -10
cooling            = true
cooling_timeout    = 15m
warmup_per_minute  = 1                  ; degrees per minute at shutdown
gain               = 120
offset             = 30
binning            = 1

[filter_wheel]
driver = indi
slots  = L, R, G, B, Ha, OIII, SII

[filter_wheel.focus_offsets]
L    = 0
Ha   = 12
OIII = 18

[focuser]
driver        = indi
autofocus     = start, filter_change, temperature
refocus_delta = 1.5                     ; degrees change that triggers a refocus

[guider]
driver         = phd2
dither_pixels  = 5
dither_every   = 1                      ; frames
settle_pixels  = 0.5
settle_timeout = 60s
lost_star      = pause                  ; pause, continue or halt

[roof]
driver          = alpaca
host            = 192.168.1.50
close_on_unsafe = true

[notify]
channel   = telegram
token_env = UT_TELEGRAM_TOKEN           ; secrets come from environment variables
chat_env  = UT_TELEGRAM_CHAT
on        = error, unsafe, finish

[defaults]                              ; every [plan.N] inherits these
exposure = 120s
filter   = L
dither   = true
guiding  = true
center   = true
on_fail  = skip

[onexit]
; executed in order
steps = camera.abort, telescope.park, camera.warmup, camera.disconnect, telescope.disconnect

[plan.1]
target          = M31
exposure        = 120s
frames          = 40
filter          = L
min_altitude    = 45deg
moon_separation = 40deg                 ; skip when the Moon is closer than this
output          = m31/
on_fail         = retry
retries         = 3

[plan.2]
target   = M42
exposure = 30s
frames   = 100
filter   = Ha
after    = 22:00:00
before   = 03:00:00                     ; local time
output   = m42/

[plan.3]                                ; several filters on one target
target       = NGC 7000
min_altitude = 35deg
output       = ngc7000/

[plan.3.sequence.1]
filter   = Ha
exposure = 300s
frames   = 24

[plan.3.sequence.2]
filter   = OIII
exposure = 300s
frames   = 24

[plan.3.sequence.3]
filter   = SII
exposure = 300s
frames   = 24

Built for real nights

The details that matter once you are out under the sky, all visible in the example above.

Setting up the night

Waits for the dark
Start and stop conditions like sky.astronomicalNight mean the night begins and ends on its own, at dusk and at dawn.
Knows your local time
Times like 22:00:00 follow the time zone of your site, so a plan written for the evening stays an evening plan.
Centers every target
Each target can be slewed, plate solved, synced, and re-slewed, with meridian flips handled for you.

Under the sky

Several filters, one target
A target can run a sequence like Ha, OIII, and SII, with filter focus offsets and autofocus when the filter or the temperature changes.
Keeps away from the Moon
Set a minimum Moon distance for the whole night, or a stricter one for a single target, and UT Script skips what is too close.
Familiar hardware names
The example uses LX200 mounts, INDI cameras and focusers, PHD2 guiding, ASTAP plate solving, and an Alpaca roof.

When things go wrong

Patient with the weather
When conditions turn unsafe, it parks, waits until the weather has stayed safe for a time you choose, then unparks and retries. A motorized roof can close on its own.
Picks up where it left off
Progress is saved to a state file, so a crash or power cut does not mean starting the whole night over.
Tells you what happened
Get a message on Telegram when something goes wrong, when the weather turns unsafe, or when the night is finished.
Protects your equipment
Horizon limits and Sun and Moon avoidance keep the telescope out of trouble. However a night ends, the shutdown steps you list run in order: abort, park, warm up, disconnect.

Your gear and your files

Gentle on your camera
At shutdown the sensor warms up gradually, a set number of degrees per minute, instead of cooling simply switching off.
Plain text, no code
Open it in any text editor, keep every night's file in version control, and compare two nights with a simple diff.
Secrets stay out of the file
Notification tokens come from environment variables, so you can share or store a night file without leaking anything.

Test the alpha

We're looking for observatories and private observers. Send us an email with who you are, what hardware you use (mount and camera), and what you'd like to automate.

alpha@utscript.com

Help build it

UT Script is built close to the hardware. If you know any of these, we'd like to hear from you.

  • C programming languageThe interpreter, the telescope and camera drivers, and everything that has to be fast and predictable.
  • Assembly languageLow-level and embedded work close to the metal, where every byte and cycle counts.
  • Network protocolsReaching remote observatories and network-connected mounts reliably and safely.
  • Data transfer protocolsTalking to hardware over serial, USB, and the network, and moving image data around.
join@utscript.com

Heads up: UT Script is an early alpha. Features will change, and bugs are expected. Always keep your mount's own limits and emergency stops enabled, and never rely on UT Script as your only safeguard for expensive equipment.