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]],<br />
- or use the script menu.
* or use the script menu.


<!--T:6-->
<!--T:6-->

Revision as of 11:40, 31 August 2020

Other languages:

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 program settings.

Getting scripts


Since release 0.9.10, scripts are provided with the installation.
Since release 0.99.4, a new command 'convert' permits to create universal scripts, wich are available for APN (RAW files) and Astro cameras (FITs files).

Here are the scripts that are in the installers:

  • 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.