Welcome to GeSS !

GeSS (Generate Siril Scripts) is a package built upon pySiril, a Python wrapper for Siril astronomical processing software.

Its main purpose is to batch-process astrophotography sessions, somewhat like using Siril scripts or SiriLic, with following features:

  • gess can be used to generate on-the-fly new scripts by passing keywords or ticking a few boxes to modify your usual processing workflow,

  • gess can name Siril sequences based on info contained in your images headers, so that you resulting stacks have meaningful names,

  • gess can locate automatically masters from libraries based on the values in the FITS header of frames to be calibrated,

  • gess can crawl all your folders from the night before and capture anything that needs to be calibrated, registered and stacked,

  • gess can build all your master libraries if the clouds rolled in and you decided not to loose the night,

  • gess can gather calibrated lights from multiple sessions, and then register/stack them.

Gess is based on fetching info from image headers and parsing them to recognize string patterns in your files and folders names. As such, it is primarily intended for users with a repeatable acquisition process. Most likely using an imaging software that nicely arrange frames in folders with a stable naming convention. Please also have a look at the section regarding folders conventions.

Many options/preferences on how you want to process your files can be specified through configuration files. A disclaimer here: No fancy GUI except for settings! GeSS is intended for users who have some kind of drive towards automation and command line. It you do not recognize yourself in these words, then probably GeSS will be more of a burden than a help.

Knowing Python is not necessary, though it can prove useful if you want to re-use some modules of the package to build your own scripts. After installing the package, just type gess in a shell to get some help on how to use it (or much better, keep on reading these pages just a little bit longer).

Which module should you use?

  • Single sessions

    • If you want to process a single imaging session, you should have a look at using GeSS in interactive or command-line modes. Probably a good idea to follow the steps shown in the Jump Start section if this is your first use.

    • After you have processed a few sessions on the same target, you will want to gather and process them with the multisession mode.

  • Batch processing

    • If you need to batch process multiple sessions from the same night, with multiple targets, filters or build master libraries, you need to head to loop mode section.

    • Once multiple sessions are batch-processed, you can reorganize the calibrated lights using copyback utility.