Line 13: Line 13:
<!--T:5-->
<!--T:5-->
There are two ways to start a script manually: <br />
There are two ways to start a script manually: <br />
* using the '''@''' keyword on the command line, followed by the script name, as explained [[Siril:Commands#Introduction|here]],<br />
* using the '''@''' keyword on the command line, followed by the script name, as explained [[Siril:Commands#Introduction|here]],
* or use the script menu.
* or use the script menu.



Revision as of 11:45, 31 August 2020

Siril scripts


Since its early days, Siril can take user inputs as textual commands, from the command line. Recently, more commands have been added, enabling for a basic automated processing of images. Commands can be stored in a file that we call script, and they are executed one after the other. Some commands can be used in scripts, some cannot, this is indicated in the help of the command line from the graphical user interface of siril.

Since release 0.9.9, Siril can execute scripts from a file. Since 0.9.10, commands can also be taken from a named pipe.

Using scripts


There are two ways to start a script manually:

  • using the @ keyword on the command line, followed by the script name, as explained here,
  • or use the script menu.

The script menu only appears if some scripts have been found in the script search directories defined either by default or by the user in the preference menu.

Getting scripts


  • Since release 0.9.10, scripts are provided with the installation.
  • Since release 0.99.4, a new command 'convert' allows the execution of universal scripts that are available for APN (RAW files) and Astro cameras (FITS files).

Hence, here’s listed the scripts automatically installed with Siril:

  • Mono_Preprocessing.ssf: script for monochrome DSLR or astro camera preprocessing, uses biases, flats and darks, registers and stacks the images.
  • OSC_Preprocessing.ssf: script for One-Shot Color (OSC) DSLR or astro camera preprocessing, uses biases, flats and darks, registers and stacks the images.
  • OSC_Extract_Ha.ssf: script for OSC DSLR or astro camera preprocessing, for use with Ha filter or dual-band filter. This script extracts the Ha layer of the color image and saves a file names Ha_result.
  • OSC_Extract_HaOIII.ssf: same preprocessing as above, but extracts Ha and OIII layers of the color image, and saves 2 files named Ha_result and OIII_result.



Other scripts:


We encourage users creating their own scripts to publish them and make a link in this page with a basic description of what they do.

We also suggest users with monochrome or CCD images and several filters to use Sirilic to generate scripts or Sirilot to provide a more suited way to manage all the files required for such a processing.