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.
-
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. -
Start UT Script
It reads the file, connects to your mount, camera, filter wheel, focuser, guider, and roof, and cools the sensor.
-
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 = 10mStarts 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/BerlinWhere 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 = 1Cools 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 = 3Forty 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 = 24NGC 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.astronomicalNightmean the night begins and ends on its own, at dusk and at dawn. - Knows your local time
- Times like
22:00:00follow 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.comHelp 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.
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.